rozszerzenie konfiguracji aplikacja systemu Azure dla usługi Azure Kubernetes Service

aplikacja systemu Azure Configuration udostępnia usługę do centralnego zarządzania ustawieniami aplikacji i flagami funkcji. aplikacja systemu Azure Configuration Kubernetes Provider to operator Kubernetes, który pobiera pary klucz-wartości, odwołania do usługi Key Vault i flagi funkcji z aplikacja systemu Azure Configuration i kompiluje je w ConfigMaps i secrets platformy Kubernetes. rozszerzenie konfiguracji aplikacja systemu Azure dla usługi Azure Kubernetes Service (AKS) umożliwia instalowanie dostawcy kubernetes konfiguracji aplikacja systemu Azure usługi AKS i zarządzanie nim za pośrednictwem usługi Azure Resource Manager (ARM) i zarządzanie nim.

Wymagania wstępne

• Subskrypcja platformy Azure. Nie masz go? Utwórz bezpłatne konto.
• Zainstaluj najnowszą wersję interfejsu wiersza polecenia platformy Azure.
• Jeśli jeszcze go nie masz, musisz utworzyć klaster usługi AKS.
• Upewnij się, że masz rolę administratora RBAC usługi Azure Kubernetes Service

Konfigurowanie rozszerzenia interfejsu wiersza polecenia platformy Azure dla rozszerzeń klastra

Zainstaluj rozszerzenie interfejsu wiersza polecenia platformy k8s-extension Azure, uruchamiają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 konfiguracji aplikacja systemu Azure, które instaluje aplikacja systemu Azure Configuration Kubernetes Provider w usłudze AKS.

Na przykład zainstaluj najnowszą wersję dostawcy kubernetes konfiguracji aplikacja systemu Azure za pośrednictwem rozszerzenia aplikacja systemu Azure Configuration w klastrze usługi AKS:

Interfejs wiersza polecenia platformy Azure

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

Bicep

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 az deployment group polecenia .

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

Konfigurowanie aktualizacji automatycznych

Jeśli tworzysz rozszerzenie aplikacja systemu Azure Configuration bez określania wersji, --auto-upgrade-minor-version zostanie automatycznie włączone, skonfigurowanie rozszerzenia aplikacja systemu Azure Configuration w celu automatycznej aktualizacji jej wersji pomocniczej w nowych wersjach.

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

Interfejs wiersza polecenia platformy Azure

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Określanie określonej wersji

Ten sam argument wiersza polecenia służy do instalowania konkretnej wersji programu aplikacja systemu Azure Configuration Kubernetes Provider lub wycofywania z poprzedniej wersji. Ustaw --auto-upgrade-minor-version wartość false i --version na wersję dostawcy kubernetes konfiguracji aplikacja systemu Azure, który chcesz zainstalować. version Jeśli parametr zostanie pominięty, rozszerzenie instaluje najnowszą wersję.

Interfejs wiersza polecenia platformy Azure

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

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 az deployment group polecenia .

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

Wersje rozszerzeń

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

• 2.1.0
• 2.0.0

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

Jeśli nie można utworzyć lub zaktualizować rozszerzenia, wypróbuj sugestie i rozwiązania w przewodniku rozwiązywania problemów z rozszerzeniem aplikacja systemu Azure Configuration.

Rozwiązywanie problemów z dostawcą aplikacja systemu Azure Configuration Kubernetes

Rozwiąż problemy z błędami dostawcy kubernetes konfiguracji aplikacja systemu Azure, korzystając z przewodnika rozwiązywania problemów.

Usuwanie rozszerzenia

Jeśli musisz usunąć rozszerzenie i usunąć dostawcę kubernetes konfiguracji aplikacja systemu Azure z klastra usługi 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 aplikacja systemu Azure Configuration.
• Po pomyślnym zainstalowaniu rozszerzenia aplikacja systemu Azure Configuration w klastrze usługi AKS wypróbuj przewodnik Szybki start, aby dowiedzieć się, jak z niego korzystać.
• Zobacz wszystkie obsługiwane funkcje dostawcy kubernetes konfiguracji aplikacja systemu Azure.