Instalace rozšíření Azure App Configuration AKS

Azure App Configuration poskytuje službu pro centrální správu nastavení aplikací a příznaků funkcí. Poskytovatel Azure App Configuration pro Kubernetes je operátor Kubernetes, který získává klíčové hodnoty, odkazy na trezor klíčů a příznaky funkcí z Azure App Configuration a sestavuje je do objektů ConfigMap a tajemství Kubernetes. rozšíření Azure App Configuration pro Azure Kubernetes Service (AKS) umožňuje nainstalovat a spravovat poskytovatele kubernetes Azure App Configuration v clusteru AKS prostřednictvím Azure Resource Manager (ARM).

Prerequisites

• Předplatné Azure. Vytvořte si bezplatný účet.
• Nejnovější verze Azure CLI.
• Cluster služby Azure Kubernetes (AKS). Vytvoření clusteru AKS.
• Oprávnění s rolí Azure Kubernetes Service správce RBAC.

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

Nainstalujte rozšíření k8s-extension 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

Zaregistrujte poskytovatele prostředků KubernetesConfiguration

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

Poskytovatel Microsoft.KubernetesConfiguration by měl hlásit jako Registrován, 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í Azure App Configuration, které nainstaluje Azure App Configuration Kubernetes Provider na vašem AKS.

Nainstalujte si například nejnovější verzi poskytovatele Azure App Configuration Kubernetes prostřednictvím rozšíření Azure App Configuration do 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í příkazu az deployment group.

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

Důležité

Rozšíření Azure App Configuration AKS je ve výchozím nastavení nainstalováno do namespace azappconfig-system. Pokud máte přiřazené zásady Azure Policy, které ověřují nebo mění specifikace podů (například vestavěná zásada "Klastry Kubernetes by měly zakázat automatické připojování přihlašovacích údajů API", která vynucuje automountServiceAccountToken: false), vylučte obor názvů azappconfig-system z těchto zásad tak, že jej přidáte do seznamu vyloučení oborů názvů zásad, abyste zajistili správnou funkci rozšíření. Nevyloučení může způsobit selhání ověření podů rozšíření nebo jevit se jako nevyhovující.

Konfigurace automatických aktualizací

Pokud vytvoříte rozšíření Azure App Configuration bez zadání verze, je automaticky povoleno a rozšíření Azure App Configuration se nakonfiguruje tak, aby automaticky aktualizovalo svou podverzi při nových vydáních.

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

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 Azure App Configuration Kubernetes nebo vrácení zpět na předchozí verzi. Nastavte --auto-upgrade-minor-version na false a --version na verzi poskytovatele Azure App 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í příkazu az deployment group.

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

Verze rozšíření

Rozšíření Azure App Configuration podporuje následující verzi poskytovatele Azure App 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 Azure App Configuration.

Řešení potíží Azure App Configuration poskytovatele Kubernetes

Řešte chyby poskytovatele Kubernetes pro Azure App Configuration pomocí průvodce odstraňováním potíží.

Odstraňte rozšíření

Pokud potřebujete odstranit rozšíření a odebrat poskytovatele Kubernetes služby Azure App Configuration z vašeho 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 nastavení extra a předvolbách, které můžete nastavit v rozšíření Azure App Configuration.
• Po úspěšné instalaci rozšíření Azure App Configuration do clusteru AKS zkuste quickstart zjistit, jak ho používat.
• Podívejte se na všechny podporované funkce poskytovatele Azure App Configuration Kubernetes.