rozšíření konfigurace Aplikace Azure pro Azure Kubernetes Service

Aplikace Azure Configuration poskytuje službu pro centrální správu nastavení aplikace a příznaků funkcí. Aplikace Azure poskytovatel kubernetes konfigurace je operátor Kubernetes, který získává hodnoty klíčů, reference ke službě Key Vault a příznaky funkcí z konfigurace Aplikace Azure a sestavuje je do objektů ConfigMap a tajných kódů Kubernetes. rozšíření konfigurace Aplikace Azure pro Službu Azure Kubernetes Service (AKS) umožňuje nainstalovat a spravovat poskytovatele Aplikace Azure Configuration Kubernetes ve vašem clusteru AKS prostřednictvím Azure Resource Manageru (ARM).

Požadavky

• Předplatné Azure. Nemáte ho? Vytvořte si bezplatný účet.
• Nainstalujte nejnovější verzi Azure CLI.
• Pokud ho ještě nemáte, musíte vytvořit cluster AKS.
• Ujistěte se, že máte roli správce RBAC služby Azure Kubernetes Service.

Nastavení rozšíření Azure CLI pro rozšíření clusteru

k8s-extension Nainstalujte rozšíření Azure CLI spuštěním následujících příkazů:

az extension add --name k8s-extension

k8s-extension Pokud už je rozšíření nainstalované, můžete ho aktualizovat na nejnovější verzi pomocí následujícího příkazu:

az extension update --name k8s-extension

KubernetesConfiguration Registrace poskytovatele prostředků

Pokud jste dříve nepoužívali rozšíření clusteru, možná budete muset zaregistrovat poskytovatele prostředků ve vašem předplatném. Stav registrace zprostředkovatele můžete zkontrolovat pomocí příkazu az provider list , jak je znázorněno v následujícím příkladu:

az provider list --query "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

Zprostředkovatel Microsoft.KubernetesConfiguration by měl hlásit jako zaregistrovaný, jak je znázorněno v následujícím příkladu výstupu:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Pokud se poskytovatel zobrazí jako NotRegistered, zaregistrujte poskytovatele pomocí příkazu az provider register , jak je znázorněno v následujícím příkladu:

az provider register --namespace Microsoft.KubernetesConfiguration

Instalace rozšíření do clusteru AKS

Vytvořte rozšíření konfigurace Aplikace Azure, které nainstaluje Aplikace Azure zprostředkovatele Kubernetes konfigurace ve vaší službě AKS.

Nainstalujte si například nejnovější verzi poskytovatele kubernetes konfigurace Aplikace Azure prostřednictvím rozšíření konfigurace Aplikace Azure ve vašem clusteru AKS:

Azure CLI

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration

Bicep

Pomocí následujícího příkladu vytvořte šablonu Bicep.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: true
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
  }
}

Nasaďte šablonu Bicep pomocí az deployment group příkazu.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Konfigurace automatických aktualizací

Pokud vytvoříte rozšíření konfigurace Aplikace Azure bez zadání verze, automaticky se povolí konfigurace rozšíření konfigurace Aplikace Azure tak, --auto-upgrade-minor-version aby automaticky aktualizovalo jeho podverzi v nových verzích.

Automatickou aktualizaci můžete zakázat zadáním parametru --auto-upgrade-minor-version a nastavením hodnoty na falsehodnotu .

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Cílení na konkrétní verzi

Stejný argument příkazového řádku se používá k instalaci konkrétní verze poskytovatele Aplikace Azure Configuration Kubernetes nebo vrácení zpět na předchozí verzi. Nastavte --auto-upgrade-minor-version na false verzi --version poskytovatele Aplikace Azure Configuration Kubernetes, kterého chcete nainstalovat. version Pokud parametr vynecháte, rozšíření nainstaluje nejnovější verzi.

Azure CLI

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version false
    --version 2.1.0

Bicep

Pomocí následujícího příkladu vytvořte šablonu Bicep.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: false
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
    version: '2.1.0'
  }
}

Nasaďte šablonu Bicep pomocí az deployment group příkazu.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Verze rozšíření

Rozšíření konfigurace Aplikace Azure podporuje následující verzi poskytovatele Aplikace Azure Configuration Kubernetes:

• 2.1.0
• 2.0.0

Řešení chyb instalace rozšíření

Pokud se rozšíření nepodaří vytvořit nebo aktualizovat, vyzkoušejte návrhy a řešení v průvodci odstraňováním potíží s rozšířením konfigurace Aplikace Azure.

Řešení potíží s poskytovatelem Kubernetes konfigurace Aplikace Azure

V průvodci odstraňováním potíží můžete řešit potíže s chybami poskytovatele kubernetes konfigurace Aplikace Azure.

Odstranění rozšíření

Pokud potřebujete rozšíření odstranit a odebrat Aplikace Azure zprostředkovatele Konfigurace Kubernetes z clusteru AKS, můžete použít následující příkaz:

az k8s-extension delete --resource-group myResourceGroup --cluster-name myAKSCluster --cluster-type managedClusters --name appconfigurationkubernetesprovider

Další kroky

• Přečtěte si další informace o dalších nastaveních a předvolbách, které můžete nastavit v rozšíření Aplikace Azure Konfigurace.
• Po úspěšné instalaci rozšíření konfigurace Aplikace Azure v clusteru AKS zkuste rychlý start zjistit, jak ho používat.
• Podívejte se na všechny podporované funkce poskytovatele kubernetes konfigurace Aplikace Azure.