Azure Kubernetes Service 用に Azure App Configuration 拡張機能 (プレビュー) を構成する

[アーティクル]
08/02/2024

Azure App Configuration 拡張機能を作成したら、次のようなさまざまな構成オプションを使用して、自分とプロジェクトに最適な拡張機能を構成できます。

レプリカ数の構成。
ログの詳細度の構成。
インストール名前空間の構成。

この拡張機能を使用すると、Azure CLI の --configuration-settings パラメーターを使用して Azure App Configuration 拡張機能の設定を構成できます。

ヒント

使用可能なオプションの一覧については、Azure App Configuration Kubernetes プロバイダーの Helm 値に関するページを参照してください。

レプリカ数を構成する

既定のレプリカ数は 1 です。カスタマイズされたレプリカ数を使用して Azure App Configuration 拡張機能を作成します。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

Note

構成設定が機密情報であり、保護する必要がある場合 (証明書関連情報など) は、--configuration-protected-settings パラメーターを渡すと、値が読み取られることを防げます。

ログの詳細度を構成する

既定のログの詳細度は 1 です。カスタマイズしたログの詳細度を使って Azure App Configuration 拡張機能を作成します。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "logVerbosity=3"

ログの詳細レベルは、klog 規則に従います。

0: 警告とエラーのみ。
1: 情報提供。このレベルが既定です。
2: 詳細な定常状態情報。
3: 変更に関する拡張情報。
4: デバッグレベルの詳細度。
5: トレースレベルの詳細度。

Azure App Configuration 拡張機能の名前空間を構成する

Azure App Configuration 拡張機能は、既定で azappconfig-system 名前空間にインストールされます。オーバーライドするには、--release-namespace を使用します。クラスター --scope を含めて、名前空間を再定義します。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --scope cluster \
    --release-namespace custom-namespace

現在の構成設定を表示する

az k8s-extension show コマンドを使用して、現在の Azure App Configuration 拡張機能の設定を表示します。

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

構成設定の更新

Azure App Configuration 拡張機能の設定を更新するには、望ましい状態で拡張機能を再作成します。たとえば、次の構成を使用して拡張機能をインストールしたとします。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \  
    --configuration-settings "replicaCount=2"

replicaCount を 2 から 3 に更新するには、次のコマンドを使用します。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

次のステップ

Azure App Configuration 拡張機能を AKS クラスターに正常にインストールしたら、クイックスタートでその使用方法を学習してください。

次の方法で共有