Azure-alkalmazás Konfigurációs bővítmény az Azure Kubernetes Service-hez (előzetes verzió)

Azure-alkalmazás Konfiguráció szolgáltatással központilag kezelheti az alkalmazásbeállításokat és a funkciójelzőket. Azure-alkalmazás Configuration Kubernetes Provider egy Kubernetes-operátor, amely lekéri a kulcsértékeket, a Key Vault-hivatkozásokat és a funkciójelzőket Azure-alkalmazás Konfigurációból, és kubernetes ConfigMaps-ba és titkos kulcsokba építi őket. Azure-alkalmazás Azure Kubernetes Service (AKS) konfigurációs bővítménye lehetővé teszi Azure-alkalmazás Konfigurációs Kubernetes-szolgáltató telepítését és kezelését az AKS-fürtön az Azure Resource Manager (ARM) használatával.

Előfeltételek

• Azure-előfizetés. Nincs? Hozzon létre egy ingyenes fiókot.
• Telepítse az Azure CLI legújabb verzióját.
• Ha még nincs ilyenje, létre kell hoznia egy AKS-fürtöt.
• Győződjön meg arról, hogy rendelkezik Azure Kubernetes Service RBAC-rendszergazdai szerepkörsel

Az Azure CLI-bővítmény beállítása fürtbővítményekhez

Telepítse az k8s-extension Azure CLI-bővítményt az alábbi parancsok futtatásával:

az extension add --name k8s-extension

Ha a k8s-extension bővítmény már telepítve van, az alábbi paranccsal frissítheti a legújabb verzióra:

az extension update --name k8s-extension

Az erőforrás-szolgáltató regisztrálása KubernetesConfiguration

Ha korábban még nem használt fürtbővítményeket, előfordulhat, hogy regisztrálnia kell az erőforrás-szolgáltatót az előfizetésében. A szolgáltatóregisztráció állapotát az az szolgáltatólista paranccsal ellenőrizheti, ahogy az alábbi példában is látható:

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

A Microsoft.KubernetesConfiguration szolgáltatónak regisztráltként kell jelentenie, ahogyan az alábbi példakimenetben látható:

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

Ha a szolgáltató nem regisztráltként jelenik meg, regisztrálja a szolgáltatót az az szolgáltatóregisztrálás használatával az alábbi példában látható módon:

az provider register --namespace Microsoft.KubernetesConfiguration

A bővítmény telepítése az AKS-fürtre

Hozza létre a Azure-alkalmazás Configuration bővítményt, amely telepíti Azure-alkalmazás Configuration Kubernetes Providert az AKS-en.

Telepítse például a Azure-alkalmazás Configuration Kubernetes Provider legújabb verzióját az AKS-fürt Azure-alkalmazás Configuration bővítményén keresztül:

Azure CLI

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

Bicep

Hozzon létre egy Bicep-sablont az alábbi példával.

@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'
    releaseTrain: 'preview'
  }
}

Telepítse a Bicep-sablont a az deployment group paranccsal.

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

Automatikus frissítések konfigurálása

Ha verzió megadása nélkül hoz létre Azure-alkalmazás konfigurációs bővítményt, --auto-upgrade-minor-version automatikusan engedélyezve van, és a Azure-alkalmazás Configuration bővítményt úgy konfigurálja, hogy automatikusan frissítse az alverzióját az új kiadásokon.

Az automatikus frissítést letilthatja a --auto-upgrade-minor-version paraméter megadásával és az érték falsebeállításával.

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Egy adott verzió megcélzása

Ugyanezt a parancssori argumentumot használja a Azure-alkalmazás Configuration Kubernetes Provider egy adott verziójának telepítéséhez vagy egy korábbi verzióra való visszaállításhoz. false --version Állítsa be --auto-upgrade-minor-version a telepíteni kívánt kubernetes-szolgáltató Azure-alkalmazás verziójára és verziójára. Ha a version paraméter nincs megadva, a bővítmény telepíti a legújabb verziót.

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 \
    --release-train preview \
    --version 2.0.0-preview

Bicep

Hozzon létre egy Bicep-sablont az alábbi példával.

@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'
    releaseTrain: 'preview'
    version: '2.0.0-preview'
  }
}

Telepítse a Bicep-sablont a az deployment group paranccsal.

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

Bővítményverziók

A Azure-alkalmazás Configuration bővítmény a Azure-alkalmazás Configuration Kubernetes Provider alábbi verzióját támogatja:

• 2.0.0-preview

Régiók

A Azure-alkalmazás Configuration bővítmény a következő régiókban érhető el:

USA 2. keleti régiója EUAP, Közép-Kanada, USA nyugati középső régiója, Közép-India, USA keleti régiója, USA 2. keleti régiója, Észak-Európa, Egyesült Királyság déli régiója, Kelet-Ausztrália, USA középső régiója, Nyugat-Európa, USA nyugati régiója, USA 2. nyugati régiója, USA 3. nyugati régiója

Bővítménytelepítési hibák elhárítása

Ha a bővítmény létrehozása vagy frissítése sikertelen, próbálkozzon a Azure-alkalmazás Konfigurációbővítmény hibaelhárítási útmutatójában található javaslatokkal és megoldásokkal.

Azure-alkalmazás konfigurációs Kubernetes-szolgáltató hibaelhárítása

Hibaelhárítás Azure-alkalmazás Konfigurációs Kubernetes-szolgáltató hibáinak elhárítása a hibaelhárítási útmutatón keresztül.

A bővítmény törlése

Ha törölnie kell a bővítményt, és el kell távolítania Azure-alkalmazás Konfigurációs Kubernetes-szolgáltatót az AKS-fürtből, a következő parancsot használhatja:

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

Következő lépések

• További információ a Azure-alkalmazás Konfiguráció bővítményen beállítható további beállításokról és beállításokról.
• Miután sikeresen telepítette Azure-alkalmazás Konfigurációs bővítményt az AKS-fürtben, próbálja meg rövid útmutatóval megismerni a használatát.
• Tekintse meg Azure-alkalmazás Konfigurációs Kubernetes-szolgáltató összes támogatott funkcióját.