Instaluj rozszerzenie AKS konfiguracji aplikacji Azure

aplikacja systemu Azure Configuration udostępnia usługę do centralnego zarządzania ustawieniami aplikacji i flagami funkcji. Azure App Configuration Kubernetes Provider to operator Kubernetes, który pobiera pary klucz-wartość, odniesienia do Key Vault i flagi funkcji z usługi Azure App Configuration i przekształca je w ConfigMaps i Secrets platformy Kubernetes. Rozszerzenie Azure App Configuration dla usługi Azure Kubernetes Service (AKS) umożliwia instalowanie i zarządzanie dostawcą Azure App Configuration Kubernetes na klastrze AKS za pośrednictwem usługi Azure Resource Manager (ARM).

Wymagania wstępne

• Subskrypcja platformy Azure. Utwórz bezpłatne konto.
• Najnowsza wersja Azure CLI.
• Klaster usługi Azure Kubernetes Service (AKS). Utwórz klaster usługi AKS.
• Uprawnienia z rolą Azure Kubernetes Service RBAC Admin.

Konfigurowanie rozszerzenia interfejsu wiersza polecenia platformy Azure dla rozszerzeń klastra

Zainstaluj rozszerzenie Azure CLI, wykonując następujące polecenia:

az extension add --name k8s-extension

k8s-extension Jeśli rozszerzenie jest już zainstalowane, możesz zaktualizować je do najnowszej wersji przy użyciu następującego polecenia:

az extension update --name k8s-extension

Rejestrowanie dostawcy KubernetesConfiguration zasobów

Jeśli rozszerzenia klastra nie były wcześniej używane, może być konieczne zarejestrowanie dostawcy zasobów w ramach subskrypcji. Stan rejestracji dostawcy można sprawdzić przy użyciu polecenia az provider list , jak pokazano w poniższym przykładzie:

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

Dostawca Microsoft.KubernetesConfiguration powinien zgłosić wartość Zarejestrowano, jak pokazano w następujących przykładowych danych wyjściowych:

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

Jeśli dostawca jest wyświetlany jako NotRegistered, zarejestruj dostawcę przy użyciu polecenia az provider register , jak pokazano w poniższym przykładzie:

az provider register --namespace Microsoft.KubernetesConfiguration

Instalowanie rozszerzenia w klastrze usługi AKS

Utwórz rozszerzenie Azure App Configuration, które instaluje dostawcę Azure App Configuration dla Kubernetes na Twoim AKS.

Na przykład zainstaluj najnowszą wersję dostawcy Kubernetes usługi Azure App Configuration za pośrednictwem rozszerzenia Azure App Configuration w klastrze AKS:

"Azure CLI"

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

Biceps

Utwórz szablon Bicep, korzystając z poniższego przykładu.

@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'
  }
}

Wdróż szablon Bicep przy użyciu polecenia az deployment group.

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

Ważne

Rozszerzenie usługi Azure App Configuration AKS jest instalowane domyślnie w przestrzeni nazw azappconfig-system. Jeśli masz przypisania usługi Azure Policy, które weryfikują lub modyfikują specyfikacje zasobników (na przykład wbudowane zasady "Klastry Kubernetes powinny wyłączyć automatyczne podłączanie poświadczeń interfejsu API", które wymuszają automountServiceAccountToken: false), wyklucz azappconfig-system przestrzeń nazw z tych zasad, dodając ją do listy wykluczeń przestrzeni nazw w zasadach, aby rozszerzenie działało poprawnie. Niewykluczenie tego może spowodować, że zasobniki rozszerzeń nie przejdą walidacji lub będą wydawać się niezgodne.

Konfigurowanie aktualizacji automatycznych

Jeśli tworzysz rozszerzenie Azure App Configuration bez określania wersji, --auto-upgrade-minor-versionzostanie automatycznie włączony, co skonfiguruje rozszerzenie Azure App Configuration do automatycznej aktualizacji swojej wersji pomocniczej przy nowych wydaniach.

Możesz wyłączyć automatyczną --auto-upgrade-minor-version aktualizację, określając parametr i ustawiając wartość na false.

"Azure CLI"

--auto-upgrade-minor-version false

Biceps

properties {
  autoUpgradeMinorVersion: false
}

Określanie określonej wersji

Ten sam argument wiersza polecenia służy do instalowania konkretnej wersji Azure App Configuration Kubernetes Provider lub przywracania poprzedniej wersji. Ustaw --auto-upgrade-minor-version na false i --version na wersję dostawcy Kubernetes Konfiguracji Aplikacji Azure, którą chcesz zainstalować. version Jeśli parametr zostanie pominięty, rozszerzenie instaluje najnowszą wersję.

"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

Biceps

Utwórz szablon Bicep, korzystając z poniższego przykładu.

@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'
  }
}

Wdróż szablon Bicep przy użyciu polecenia az deployment group.

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

Wersje rozszerzeń

Rozszerzenie Azure App Configuration obsługuje następującą wersję dostawcy Azure App Configuration Kubernetes:

• 2.1.0
• 2.0.0

Rozwiązywanie problemów z błędami instalacji rozszerzenia

Jeśli rozszerzenie nie może zostać utworzone lub zaktualizowane, spróbuj sugestii i rozwiązań w przewodniku rozwiązywania problemów z rozszerzeniem Azure App Configuration.

Rozwiązywanie problemów z dostawcą konfiguracji aplikacji Azure Kubernetes

Rozwiąż problemy z błędami dostawcy Kubernetes Konfiguracji Aplikacji Azure poprzez przewodnik rozwiązywania problemów.

Usuwanie rozszerzenia

Jeśli musisz usunąć rozszerzenie i usunąć dostawcę Kubernetes dla aplikacji Azure App Configuration z klastra AKS, możesz użyć następującego polecenia:

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

Następne kroki

• Dowiedz się więcej o dodatkowych ustawieniach i preferencjach, które można ustawić w rozszerzeniu Azure App Configuration.
• Po pomyślnym zainstalowaniu rozszerzenia Azure App Configuration w klastrze AKS wypróbuj szybki start, aby dowiedzieć się, jak z niego korzystać.
• Zobacz wszystkie obsługiwane funkcje dostawcy Konfiguracji Aplikacji Azure Kubernetes.