Instalowanie rozszerzenia Azure App Configuration AKS

Azure App Configuration zapewnia usługę do centralnego zarządzania ustawieniami aplikacji i flagami funkcji. Azure App Configuration Kubernetes Provider jest operatorem Kubernetes, który pobiera wartości klucza, odniesienia do Key Vault i flagi funkcji z Azure App Configuration, i integruje je w ConfigMaps i Sekrety Kubernetes. rozszerzenie Azure App Configuration dla Azure Kubernetes Service (AKS) umożliwia instalowanie dostawcy Azure App Configuration Kubernetes i zarządzanie nim w klastrze usługi AKS za pośrednictwem usługi Azure Resource Manager (ARM).

Wymagania wstępne

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

Konfigurowanie rozszerzenia Azure CLI dla rozszerzeń klastra

Zainstaluj rozszerzenie k8s-extension Azure CLI, 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

Microsoft.KubernetesConfiguration dostawca powinien być zgłaszanym jako Registered, jak pokazano na poniższym przykładowym wyjściu.

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ę Kubernetes dla Azure App Configuration w klastrze AKS.

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

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

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

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

Konfigurowanie aktualizacji automatycznych

Jeśli tworzysz rozszerzenie Azure App Configuration bez określania wersji, --auto-upgrade-minor-versionjest automatycznie włączone, konfigurując rozszerzenie Azure App Configuration do automatycznej aktualizacji jego wersji pomniejszej w nowych wydaniach.

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

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Określanie określonej wersji

Ten sam argument wiersza polecenia jest używany do instalowania określonej wersji dostawcy Kubernetes Azure App Configuration lub przywracania poprzedniej wersji. Ustaw --auto-upgrade-minor-version na false i --version na wersję dostawcy Azure App Configuration Kubernetes, który chcesz zainstalować. version Jeśli parametr zostanie pominięty, rozszerzenie instaluje najnowszą wersję.

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

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

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 nie można utworzyć lub zaktualizować rozszerzenia, wypróbuj sugestie i rozwiązania w przewodniku rozwiązywania problemów z rozszerzeniem Azure App Configuration.

Rozwiązywanie problemów z dostawcą Azure App Configuration Kubernetes

Rozwiąż problemy z błędami dostawcy Azure App Configuration Kubernetes korzystając z przewodnika rozwiązywania problemów.

Usuwanie rozszerzenia

Jeśli musisz usunąć rozszerzenie i usunąć dostawcę Azure App Configuration Kubernetes 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 ustawieniach i preferencjach extra, które można ustawić w rozszerzeniu Azure App Configuration.
• Po pomyślnym zainstalowaniu rozszerzenia Azure App Configuration w klastrze usługi AKS spróbuj quickstart aby dowiedzieć się, jak z niego korzystać.
• Zobacz wszystkie obsługiwane funkcje Azure App Configuration Kubernetes Provider.