次の方法で共有

az connectedk8s

  • リファレンス

Note

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

接続された kubernetes クラスターを管理するコマンド。

コマンド

名前 説明 型 状態
az connectedk8s connect

接続された kubernetes クラスターを Azure にオンボードします。

 拡張子 GA
az connectedk8s delete

接続された Kubernetes クラスターと接続されたクラスター エージェントを削除します。

 拡張子 GA
az connectedk8s disable-features

接続されているクラスターの選択的機能を無効にします。

 拡張子 プレビュー
az connectedk8s enable-features

接続されたクラスターで選択的な機能を有効にします。

 拡張子 プレビュー
az connectedk8s list

接続されている kubernetes クラスターを一覧表示します。

 拡張子 GA
az connectedk8s proxy

接続されている kubernetes クラスターにアクセスします。

 拡張子 GA
az connectedk8s show

接続されている kubernetes クラスターの詳細を表示します。

 拡張子 GA
az connectedk8s troubleshoot

Arc 対応 Kubernetes クラスターで診断チェックを実行します。

 拡張子 プレビュー
az connectedk8s update

Arc オンボード Kubernetes クラスターのプロパティを更新します。

 拡張子 GA
az connectedk8s upgrade

オンボードされたエージェントを特定のバージョンにアトミックにアップグレードするか、既定で最新バージョンにアップグレードします。

 拡張子 GA

az connectedk8s connect

接続された kubernetes クラスターを Azure にオンボードします。

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {false, true}]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

例

既定の kube 構成と kube コンテキストを使用して、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName

既定の kube 構成と kube コンテキストを使用して接続された kubernetes クラスターをオンボードし、Arc エージェントの自動アップグレードを無効にします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

kubeconfig と kubecontext を指定して、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

https プロキシ、http プロキシ、プロキシ設定を指定せず、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

https プロキシ、http プロキシ、証明書設定を持つプロキシなしを指定して、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

プライベート リンク パラメーターを指定して、プライベート リンク機能を有効にして、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

カスタム オンボード タイムアウトを使用して、接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

oidc 発行者とワークロード ID Webhook が有効になっている接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

パブリック クラウド クラスターのセルフホステッド発行者 URL を使用して、oidc 発行者が有効になっている接続された kubernetes クラスターをオンボードします。

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

必須のパラメーター

--name -n

接続されているクラスターの名前。

--resource-group -g

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

省略可能のパラメーター

--azure-hybrid-benefit

Azure ハイブリッド特典機能を有効または無効にするフラグ。

指定可能な値: False, NotApplicable, True
--container-log-path

既定のコンテナー ログ パスをオーバーライドして、fluent-bit ログを有効にします。

--correlation-id

クラスターオンボードのソースを内部的に追跡するために使用される guid。 お勧めしない限り、変更しないでください。

--custom-ca-cert --proxy-cert

プロキシまたはカスタム証明機関の証明書ファイルへのパス。

--custom-locations-oid

"custom-locations" アプリの OID。

--disable-auto-upgrade

Arc エージェントの自動アップグレードを無効にするフラグ。

規定値: False
--distribution

この接続されたクラスターで実行される Kubernetes ディストリビューション。

指定可能な値: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg
規定値: generic
--distribution-version

接続されたクラスターの Kubernetes ディストリビューション バージョン。

--enable-oidc-issuer
プレビュー

ワークロード ID に使用される OIDC 発行者 URL の作成を有効にします。

指定可能な値: false, true
規定値: False
--enable-private-link
プレビュー

接続されたクラスター リソースでプライベート リンクのサポートを有効または無効にするフラグ。 使用できる値: false、true。

指定可能な値: false, true
--enable-wi --enable-workload-identity
プレビュー

ワークロード ID Webhook を有効にします。

指定可能な値: false, true
規定値: False
--infrastructure

この接続されたクラスターによって表される Kubernetes クラスターが実行されるインフラストラクチャ。

指定可能な値: LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server
規定値: generic
--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--location -l

Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。

--no-wait

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

規定値: False
--onboarding-timeout

kubernetes クラスターに arc-agent ポッドをインストールするために必要な時間 (秒単位)。 クラスターのハードウェア/ネットワークの制約で arc-agent ポッドのインストールに時間が必要な場合は、この値をオーバーライドします。

規定値: 1200
--pls-arm-id --private-link-scope-resource-id
プレビュー

この接続されたクラスターが関連付けられているプライベート リンク スコープ リソースの ARM リソース ID。

--proxy-http

使用する HTTP プロキシ URL。

--proxy-https

使用する Https プロキシ URL。

--proxy-skip-range

プロキシを使用しない URL/CIDR の一覧。

--self-hosted-issuer
プレビュー

パブリック クラウド クラスターのセルフホステッド発行者 URL (AKS、GKE、EKS)。

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--yes -y

確認のダイアログを表示しません。

規定値: 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 connectedk8s delete

接続された Kubernetes クラスターと接続されたクラスター エージェントを削除します。

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

例

既定の kubeconfig と kubecontext を使用して、接続された kubernetes クラスターと接続されたクラスター エージェントを削除します。

az connectedk8s delete -g resourceGroupName -n connectedClusterName

接続されたクラスター エージェントの削除に kubeconfig と kubecontext を指定して、接続されている kubernetes クラスターを削除します。

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

省略可能のパラメーター

--force

クラスターからすべての azure-arc リソースを削除するには、強制的に削除します。

規定値: False
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--name -n

接続されているクラスターの名前。

--no-wait

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

規定値: False
--resource-group -g

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

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--subscription

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

--yes -y

確認のダイアログを表示しません。

規定値: 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 connectedk8s disable-features

プレビュー

このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

接続されているクラスターの選択的機能を無効にします。

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

例

azure-rbac 機能を無効にします。

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

複数の機能を無効にします。

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

必須のパラメーター

--features

無効にする機能のスペース区切りの一覧。

指定可能な値: azure-rbac, cluster-connect, custom-locations

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--name -n

接続されているクラスターの名前。

--resource-group -g

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

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--subscription

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

--yes -y

確認のダイアログを表示しません。

規定値: 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 connectedk8s enable-features

プレビュー

このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

接続されたクラスターで選択的な機能を有効にします。

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

例

クラスター接続機能を有効にします。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Azure RBAC 機能を有効にします。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

複数の機能を有効にします。

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

必須のパラメーター

--features

有効にする機能のスペース区切りの一覧。

指定可能な値: azure-rbac, cluster-connect, custom-locations

省略可能のパラメーター

--custom-locations-oid

"custom-locations" アプリの OID。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--name -n

接続されているクラスターの名前。

--resource-group -g

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

--skip-azure-rbac-list

ユーザー名/email/oid の名前のコンマ区切りリスト。 これらのユーザーについては、Azure RBAC はスキップされます。 azure-rbac を有効にする場合に指定します。

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_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 connectedk8s list

接続されている kubernetes クラスターを一覧表示します。

az connectedk8s list [--resource-group]

例

リソース グループ内の接続されているすべての kubernetes クラスターを一覧表示します。

az connectedk8s list -g resourceGroupName --subscription subscriptionName

サブスクリプション内の接続されているすべての kubernetes クラスターを一覧表示します。

az connectedk8s list --subscription subscriptionName

省略可能のパラメーター

--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 connectedk8s proxy

接続されている kubernetes クラスターにアクセスします。

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

例

接続されている kubernetes クラスターにアクセスします。

az connectedk8s proxy -n clusterName -g resourceGroupName

カスタム ポートを使用して接続された kubernetes クラスターにアクセスする

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

サービス アカウント トークンを使用して接続された kubernetes クラスターにアクセスする

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

カスタム kubeconfig の場所を指定して、接続されている kubernetes クラスターにアクセスする

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

カスタム コンテキストを指定して、接続されている kubernetes クラスターにアクセスする

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

省略可能のパラメーター

--file -f

更新する Kubernetes 構成ファイル。 指定しない場合は、ファイル '~/.kube/config' を更新します。 代わりに 、'-' を使用して YAML を stdout に出力します。

規定値: ~\.kube\config
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-context

指定した場合は、既定のコンテキスト名を上書きします。

--name -n

接続されているクラスターの名前。

--port

接続されたクラスターへのアクセスに使用されるポート。

規定値: 47011
--resource-group -g

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

--subscription

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

--token

Kubernetes クラスターに対する認証に使用するサービス アカウント トークン。

グローバル パラメーター
--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 connectedk8s show

接続されている kubernetes クラスターの詳細を表示します。

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

例

接続されている kubernetes クラスターの詳細を表示する

az connectedk8s show -g resourceGroupName -n connectedClusterName

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

接続されているクラスターの名前。

--resource-group -g

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

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_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 connectedk8s troubleshoot

プレビュー

このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

Arc 対応 Kubernetes クラスターで診断チェックを実行します。

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

例

Arc 対応 Kubernetes クラスターで診断チェックを実行します。

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

必須のパラメーター

--name -n

接続されているクラスターの名前。

--resource-group -g

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

省略可能のパラメーター

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubeconfig コンテキスト。

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

グローバル パラメーター
--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 connectedk8s update

Arc オンボード Kubernetes クラスターのプロパティを更新します。

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-proxy]
                       [--disable-wi {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi {false, true}]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

例

エージェントのプロキシ値を更新する

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

エージェントのプロキシ設定を無効にする

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

エージェントの自動アップグレードを無効にする

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

oidc 発行者とワークロード ID Webhook が有効になっている接続済み kubernetes クラスターを更新します。

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

パブリック クラウド クラスターのセルフホステッド発行者 URL を使用して、oidc 発行者が有効になっている接続済み kubernetes クラスターを更新します。

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

接続された kubernetes クラスターでワークロード ID Webhook を無効にします。

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

省略可能のパラメーター

--auto-upgrade

Arc エージェントの自動アップグレードを有効または無効にするフラグ。 既定では、エージェントの自動アップグレードが有効になっています。

指定可能な値: false, true
--azure-hybrid-benefit

Azure ハイブリッド特典機能を有効または無効にするフラグ。

指定可能な値: False, NotApplicable, True
--container-log-path

既定のコンテナー ログ パスをオーバーライドして、fluent-bit ログを有効にします。

--custom-ca-cert --proxy-cert

プロキシまたはカスタム証明機関の証明書ファイルへのパス。

--disable-proxy

エージェントのプロキシ設定を無効にします。

規定値: False
--disable-wi --disable-workload-identity
プレビュー

ワークロード ID Webhook を無効にします。

指定可能な値: false, true
--distribution

この接続されたクラスターで実行される Kubernetes ディストリビューション。

指定可能な値: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg
--distribution-version

接続されたクラスターの Kubernetes ディストリビューション バージョン。

--enable-oidc-issuer
プレビュー

ワークロード ID に使用される OIDC 発行者 URL の作成を有効にします。

指定可能な値: false, true
--enable-wi --enable-workload-identity
プレビュー

ワークロード ID Webhook を有効にします。

指定可能な値: false, true
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--name -n

接続されているクラスターの名前。

--proxy-http

使用する HTTP プロキシ URL。

--proxy-https

使用する Https プロキシ URL。

--proxy-skip-range

プロキシを使用しない URL/CIDR の一覧。

--resource-group -g

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

--self-hosted-issuer
プレビュー

パブリック クラウド クラスターのセルフホステッド発行者 URL (AKS、GKE、EKS)。

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--subscription

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

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--yes -y

確認のダイアログを表示しません。

規定値: 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 connectedk8s upgrade

オンボードされたエージェントを特定のバージョンにアトミックにアップグレードするか、既定で最新バージョンにアップグレードします。

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

例

エージェントを最新バージョンにアップグレードする

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

エージェントを特定のバージョンにアップグレードする

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

カスタム アップグレード タイムアウトを使用してエージェントをアップグレードします。

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

省略可能のパラメーター

--agent-version

Helm チャートを更新するエージェントのバージョン。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--kube-config

kube 構成ファイルへのパス。

--kube-context

現在のコンピューターからの Kubconfig コンテキスト。

--name -n

接続されているクラスターの名前。

--resource-group -g

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

--skip-ssl-verification

クラスター接続の SSL 検証をスキップします。

規定値: False
--subscription

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

--upgrade-timeout

kubernetes クラスターで arc-agent ポッドをアップグレードするために必要な時間 (秒単位)。 クラスター上のハードウェア/ネットワークの制約で arc-agent ポッドのアップグレードにより多くの時間が必要な場合は、この値をオーバーライドします。

規定値: 600
グローバル パラメーター
--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 を使います。