Share via

az aks addon

  • リファレンス

Note

このリファレンスは、Azure CLI (バージョン 2.56.0 以降) の aks-preview 拡張機能の一部です。 拡張機能は、az aks addon コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

単一のアドオン条件を管理および表示するコマンド。

コマンド

名前 説明 型 Status
az aks addon disable

クラスターで有効な Kubernetes アドオンを無効にします。

 拡張機能 GA
az aks addon enable

Kubernetes アドオンを有効にします。

 拡張機能 GA
az aks addon list

特定のクラスター内のすべての Kubernetes アドオンの状態を一覧表示します。

 拡張機能 GA
az aks addon list-available

使用可能な Kubernetes アドオンを一覧表示します。

 拡張機能 GA
az aks addon show

特定のクラスターで有効になっている Kubernetes アドオンの状態と構成を表示します。

 拡張機能 GA
az aks addon update

既に有効になっている Kubernetes アドオンを更新します。

 拡張機能 GA

az aks addon disable

クラスターで有効な Kubernetes アドオンを無効にします。

az aks addon disable --addon
                     --name
                     --resource-group
                     [--no-wait]

例

"監視" アドオンを無効にします。

az aks addon disable -g myResourceGroup -n myAKSCluster -a monitoring

必須のパラメーター

--addon -a

無効にする Kubernetes アドオンを指定します。

--name -n

マネージド クラスターの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks addon enable

Kubernetes アドオンを有効にします。

これらのアドオンを使用できます。http_application_routing - 自動パブリック DNS 名の作成を使用してイングレスを構成します。 監視 - Log Analytics の監視を有効にします。 Log Analytics の既定のワークスペースが存在する場合は使用し、それ以外の場合は作成します。 既存のワークスペースを使用するには、"--workspace-resource-id" を指定します。 監視アドオンが有効になっている場合、--no-wait 引数は有効な仮想ノードを持たない - AKS 仮想ノードを有効にします。 使用する仮想ノードの既存のサブネットの名前を指定するには、--subnet-name が必要です。 azure-policy - Azure policy を有効にします。 AKS 用 Azure Policy アドオンを使用すると、クラスターに対する大規模な適用と保護を一元化された一貫性のある方法で実現できます。 詳細については、aka.ms/aks/policy を参照してください。 ingress-appgw - Application Gateway イングレス コントローラー アドオン (プレビュー) を有効にします。 open-service-mesh - Open Service Mesh アドオン (プレビュー) を有効にします。 gitops - GitOps (プレビュー) を有効にします。 azure-keyvault-secrets-provider - Azure Keyvault Secrets Provider アドオンを有効にします。 web_application_routing - Web アプリケーション ルーティング アドオン (プレビュー) を有効にします。 DNS を構成するには、"--dns-zone-resource-id" を指定します。

az aks addon enable --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

例

Kubernetes アドオンを有効にします。 (自動生成)

az aks addon enable --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

サブネット プレフィックスを使用して ingress-appgw アドオンを有効にします。

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

open-service-mesh アドオンを有効にします。

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup -a open-service-mesh

必須のパラメーター

--addon -a

有効にする Kubernetes アドオンを指定します。

--name -n

マネージド クラスターの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--appgw-id

AGIC で使用する既存の Application Gateway のリソース ID。 ingress-azure アドオンと共に使用します。

--appgw-name

ノード リソース グループで作成/使用するアプリケーション ゲートウェイの名前。 ingress-azure アドオンと共に使用します。

--appgw-subnet-cidr

Application Gateway をデプロイするために作成された新しいサブネットに使用するサブネット CIDR。 ingress-azure アドオンと共に使用します。

--appgw-subnet-id

Application Gateway のデプロイに使用される既存のサブネットのリソース ID。 ingress-azure アドオンと共に使用します。

--appgw-watch-namespace

AGIC で監視する名前空間を指定します。 これには、単一の文字列値、または名前空間のコンマ区切り一覧を指定できます。 ingress-azure アドオンと共に使用します。

--data-collection-settings
プレビュー

監視アドオンのデータ収集設定を含む JSON ファイルへのパス。

--dns-zone-resource-ids
プレビュー

web_application_routing アドオンで使用する DNS ゾーン リソースのリソース ID のコンマ区切りの一覧。

--enable-msi-auth-for-monitoring
プレビュー

クラスターの割り当てられた ID (Log Analytics ワークスペースの共有キーではなく) を使用して、監視データを Log Analytics に送信します。

承認された値: false, true
既定値: True
--enable-secret-rotation

シークレットローテーションを有効にします。 azure-keyvault-secrets-provider アドオンと共に使用します。

既定値: False
--enable-sgxquotehelper

confcom アドオンの SGX クォート ヘルパーを有効にします。

既定値: False
--enable-syslog
プレビュー

監視アドオンの syslog データ収集を有効にします。

承認された値: false, true
既定値: False
--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--rotation-poll-interval

回転ポーリングの間隔を設定します。 azure-keyvault-secrets-provider アドオンと共に使用します。

--subnet-name -s

使用する仮想ノードのサブネット名。

--workspace-resource-id

モニタリング データを保存するために使用する既存の Log Analytics Workspace のリソース ID。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks addon list

特定のクラスター内のすべての Kubernetes アドオンの状態を一覧表示します。

az aks addon list --name
                  --resource-group

必須のパラメーター

--name -n

マネージド クラスターの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks addon list-available

使用可能な Kubernetes アドオンを一覧表示します。

az aks addon list-available
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks addon show

特定のクラスターで有効になっている Kubernetes アドオンの状態と構成を表示します。

az aks addon show --addon
                  --name
                  --resource-group

例

"監視" アドオンの構成を表示します。

az aks addon show -g myResourceGroup -n myAKSCluster -a monitoring

必須のパラメーター

--addon -a

Kubernetes アドオンを指定します。

--name -n

マネージド クラスターの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks addon update

既に有効になっている Kubernetes アドオンを更新します。

az aks addon update --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

例

Kubernetes アドオンを更新します。 (自動生成)

az aks addon update --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

ingress-appgw アドオンをサブネット プレフィックスで更新します。

az aks addon update --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

ワークスペース リソース ID を使用して監視アドオンを更新します。

az aks addon update -g $rg -n $cn -a monitoring --workspace-resource-id=/subscriptions/0000000-00000000-00000-000-000/resourcegroups/myresourcegroup/providers/microsoft.operationalinsights/workspaces/defaultlaworkspace

必須のパラメーター

--addon -a

更新する Kubernetes アドオンを指定します。

--name -n

マネージド クラスターの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--appgw-id

AGIC で使用する既存の Application Gateway のリソース ID。 ingress-azure アドオンと共に使用します。

--appgw-name

ノード リソース グループで作成/使用するアプリケーション ゲートウェイの名前。 ingress-azure アドオンと共に使用します。

--appgw-subnet-cidr

Application Gateway をデプロイするために作成された新しいサブネットに使用するサブネット CIDR。 ingress-azure アドオンと共に使用します。

--appgw-subnet-id

Application Gateway のデプロイに使用される既存のサブネットのリソース ID。 ingress-azure アドオンと共に使用します。

--appgw-watch-namespace

AGIC で監視する名前空間を指定します。 これには、単一の文字列値、または名前空間のコンマ区切り一覧を指定できます。 ingress-azure アドオンと共に使用します。

--data-collection-settings
プレビュー

監視アドオンのデータ収集設定を含む JSON ファイルへのパス。

--dns-zone-resource-ids
プレビュー

web_application_routing アドオンで使用する DNS ゾーン リソースのリソース ID のコンマ区切りの一覧。

--enable-msi-auth-for-monitoring
プレビュー

クラスターの割り当てられた ID (Log Analytics ワークスペースの共有キーではなく) を使用して、監視データを Log Analytics に送信します。

承認された値: false, true
--enable-secret-rotation

シークレットローテーションを有効にします。 azure-keyvault-secrets-provider アドオンと共に使用します。

既定値: False
--enable-sgxquotehelper

confcom アドオンの SGX クォート ヘルパーを有効にします。

既定値: False
--enable-syslog
プレビュー

監視アドオンの syslog データ収集を有効にします。

承認された値: false, true
既定値: False
--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--rotation-poll-interval

回転ポーリングの間隔を設定します。 azure-keyvault-secrets-provider アドオンと共に使用します。

--subnet-name -s

使用する仮想ノードのサブネット名。

--workspace-resource-id

モニタリング データを保存するために使用する既存の Log Analytics Workspace のリソース ID。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。