az k8s-extension

注意

此參考是 Azure CLI (2.24.0 版或更新版本的 k8s 擴充功能) 的一部分。 當您第一次執行 az k8s-extension 命令時,擴充功能會自動安裝。 深入了解延伸模組。

用來管理 Kubernetes 延伸模組的命令。

命令

az k8s-extension create

建立 Kubernetes 擴充功能。

az k8s-extension delete

刪除 Kubernetes 擴充功能。

az k8s-extension extension-types

探索 Kubernetes 擴充功能的命令。

az k8s-extension extension-types list

列出 Kubernetes 擴充功能類型。

az k8s-extension extension-types list-by-location

列出指定區域中可用的 Kubernetes 擴充功能類型。

az k8s-extension extension-types list-versions

列出 Kubernetes 擴充功能類型的可用版本。

az k8s-extension extension-types show

顯示 Kubernetes 擴充功能類型的屬性。

az k8s-extension list

列出 Kubernetes 擴充功能。

az k8s-extension show

顯示 Kubernetes 擴充功能。

az k8s-extension update

更新 Kubernetes 擴充功能的可變動屬性。

az k8s-extension create

建立 Kubernetes 擴充功能。

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--no-wait]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

範例

建立 Kubernetes 擴充功能

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

必要參數

--cluster-name -c

Kubernetes 叢集的名稱。

--cluster-type -t

指定 Arc 叢集或 AKS 受控叢集或 Arc 設備或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

延伸模組類型的名稱。

--name -n

擴充實例的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--auto-upgrade --auto-upgrade-minor-version

自動升級延伸模組實例的次要版本。

接受的值: false, true
--cluster-resource-provider --cluster-rp

此 clusterType 的叢集資源提供者名稱 (provisionedClusters) 的必要專案。

--config --config-settings --configuration-settings

組態設定為 key=value pair。 針對每個設定重複參數。

--config-file --config-settings-file --configuration-settings-file

組態設定的 JSON 檔案路徑。

--config-protected --config-protected-settings --configuration-protected-settings

設定受保護的設定作為 key=value 組。 針對每個設定重複參數。

--config-protected-file --config-protected-settings-file --configuration-protected-settings-file

組態受保護設定的 JSON 檔案路徑。

--no-wait

不等候長時間執行的作業完成。

--release-namespace

指定要安裝擴充功能的命名空間。

--release-train

指定延伸模組類型的發行定型。

--scope

指定延伸模組範圍。

接受的值: cluster, namespace
--target-namespace

指定要針對延伸模組實例安裝的目標命名空間。 如果擴充範圍設定為 'namespace',則需要此參數。

--version

如果未啟用 --auto-upgrade-minor-version,請指定要為擴充實例安裝的版本。

az k8s-extension delete

刪除 Kubernetes 擴充功能。

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

範例

刪除現有的 Kubernetes 擴充功能

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

必要參數

--cluster-name -c

Kubernetes 叢集的名稱。

--cluster-type -t

指定 Arc 叢集或 AKS 受控叢集或 Arc 設備或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

擴充實例的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--cluster-resource-provider --cluster-rp

此 clusterType 的叢集資源提供者名稱 (provisionedClusters) 的必要專案。

--force

指定是否要強制從叢集刪除延伸模組。

--no-wait

不等候長時間執行的作業完成。

--yes -y

忽略確認提示。

az k8s-extension list

列出 Kubernetes 擴充功能。

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

範例

列出叢集上的所有 Kubernetes 擴充功能

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

必要參數

--cluster-name -c

Kubernetes 叢集的名稱。

--cluster-type -t

指定 Arc 叢集或 AKS 受控叢集或 Arc 設備或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--cluster-resource-provider --cluster-rp

此 clusterType 的叢集資源提供者名稱 (provisionedClusters) 的必要專案。

az k8s-extension show

顯示 Kubernetes 擴充功能。

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

範例

顯示 Kubernetes 擴充功能的詳細資料

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

必要參數

--cluster-name -c

Kubernetes 叢集的名稱。

--cluster-type -t

指定 Arc 叢集或 AKS 受控叢集或 Arc 設備或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

擴充實例的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--cluster-resource-provider --cluster-rp

此 clusterType 的叢集資源提供者名稱 (provisionedClusters) 的必要專案。

az k8s-extension update

更新 Kubernetes 擴充功能的可變動屬性。

如需 ConfigSettings 和 ConfigProtectedSettings 的更新,請參閱叢集延伸模組服務的檔,以在更新這些屬性之前檢查這些屬性的更新。

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

範例

更新 Kubernetes 擴充功能

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --configuration-protected-settings protected-settings-key=protected-value --configuration-settings-file=config-settings-file --configuration-protected-settings-file=protected-settings-file

必要參數

--cluster-name -c

Kubernetes 叢集的名稱。

--cluster-type -t

指定 Arc 叢集或 AKS 受控叢集或 Arc 設備或 provisionedClusters。

接受的值: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

擴充實例的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--auto-upgrade --auto-upgrade-minor-version

自動升級延伸模組實例的次要版本。

接受的值: false, true
--cluster-resource-provider --cluster-rp

此 clusterType 的叢集資源提供者名稱 (provisionedClusters) 的必要專案。

--config --config-settings --configuration-settings

組態設定為 key=value pair。 針對每個設定重複參數。

--config-file --config-settings-file --configuration-settings-file

組態設定的 JSON 檔案路徑。

--config-protected --config-protected-settings --configuration-protected-settings

設定受保護的設定作為 key=value 組。 針對每個設定重複參數。

--config-protected-file --config-protected-settings-file --configuration-protected-settings-file

組態受保護設定的 JSON 檔案路徑。

--no-wait

不等候長時間執行的作業完成。

--release-train

指定延伸模組類型的發行定型。

--version

如果未啟用 --auto-upgrade-minor-version,請指定要為擴充實例安裝的版本。

--yes -y

忽略確認提示。