Azure Kubernetes Service 用 Azure App Configuration 拡張機能 (プレビュー)

Azure App Configuration は、アプリケーションの設定と機能フラグを一元管理するためのサービスを提供します。 Azure App Configuration Kubernetes Provider は、Azure App Configuration からキーと値、Key Vault 参照、機能フラグを取得し、それらを Kubernetes ConfigMaps と Kubernetes Secrets にビルドする Kubernetes オペレーターです。 Azure Kubernetes Service (AKS) 用 Azure App Configuration 拡張機能を使用すると、Azure Resource Manager (ARM) を使用して、Azure App Configuration Kubernetes Provider を AKS クラスターにインストールし、管理することができます。

前提条件

• Azure サブスクリプション。 お持ちでない場合は、 無料アカウントを作成します。
• 最新バージョンの Azure CLI をインストールします。
• まだない場合は、AKS クラスターを作成する必要があります。
• Azure Kubernetes Service RBAC 管理者ロールがあることを確認します

クラスター拡張機能用の Azure CLI 拡張機能を設定する

次のコマンドを実行して、k8s-extension Azure CLI 拡張機能をインストールします。

az extension add --name k8s-extension

k8s-extension 拡張機能が既にインストールされている場合は、次のコマンドを使用して最新バージョンに更新できます。

az extension update --name k8s-extension

KubernetesConfiguration リソース プロバイダーを登録する

クラスター拡張機能を以前に使用していない場合は、リソース プロバイダーをサブスクリプションに登録することが必要になる場合があります。 プロバイダー登録の状態は、次の例で示すように az provider list コマンドを使用して確認できます。

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

"Microsoft.KubernetesConfiguration" プロバイダーが、次の出力例に示すように "Registered" と報告されます。

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

プロバイダーが NotRegistered として示される場合は、次の例で示すように az provider register を使用してプロバイダーを登録します。

az provider register --namespace Microsoft.KubernetesConfiguration

AKS クラスターに拡張機能をインストールする

Azure App Configuration Kubernetes Provider を AKS にインストールする Azure App Configuration 拡張機能を作成します。

たとえば、AKS クラスター上の Azure App Configuration 拡張機能を介して、最新バージョンの Azure App Configuration Kubernetes Provider をインストールします。

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

次の例を使用して 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'
    releaseTrain: 'preview'
  }
}

az deployment group コマンドを使用して Bicep テンプレートをデプロイします。

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

自動更新を構成する

バージョンを指定せずに Azure App Configuration 拡張機能を作成すると、--auto-upgrade-minor-version は "自動的に有効になり"、新しいリリース時にマイナー バージョンを自動的に更新するように Azure App Configuration 拡張機能が構成されます。

--auto-upgrade-minor-version パラメーターを指定し、値を false に設定すると、自動更新を無効にできます。

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

特定のバージョンを対象とする

特定のバージョンの Azure App Configuration Kubernetes Provider をインストールする場合、または以前のバージョンにロールバックする場合も、同じコマンド ライン引数を使用します。 --auto-upgrade-minor-version を false に設定し、--version を、インストールする Azure App Configuration Kubernetes Provider のバージョンに設定します。 version パラメーターを省略すると、拡張機能によって最新バージョンがインストールされます。

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

次の例を使用して 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'
    releaseTrain: 'preview'
    version: '2.0.0-preview'
  }
}

az deployment group コマンドを使用して Bicep テンプレートをデプロイします。

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

拡張機能のバージョン

Azure App Configuration 拡張機能では、次のバージョンの Azure App Configuration Kubernetes Provider がサポートされます。

• 2.0.0-preview

地域

Azure App Configuration 拡張機能は、次のリージョンで使用できます。

米国東部 2 EUAP、カナダ中部、米国中西部、インド中部、米国東部、米国東部 2、北ヨーロッパ、英国南部、オーストラリア東部、米国中部、西ヨーロッパ、米国西部、米国西部 2、米国西部 3

拡張機能のインストール エラーのトラブルシューティング

拡張機能の作成または更新に失敗した場合は、Azure App Configuration 拡張機能のトラブルシューティング ガイドの提案と解決策を試してみてください。

Azure App Configuration Kubernetes Provider のトラブルシューティング

トラブルシューティング ガイドに従って Azure App Configuration Kubernetes Provider のエラーのトラブルシューティングを行います。

拡張機能を削除する

拡張機能を削除し、AKS クラスターから Azure App Configuration Kubernetes Provider を削除する必要がある場合は、次のコマンドを使用できます。

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

次のステップ

• Azure App Configuration 拡張機能で設定できるその他の設定と基本設定の詳細を確認します。
• Azure App Configuration 拡張機能を AKS クラスターに正常にインストールしたら、クイックスタートを試してその使用方法を学習してください。
• Azure App Configuration Kubernetes Provider でサポートされているすべての機能を参照してください。