az fleet

注意

此參考是 Azure CLI 的機隊擴充功能一部分(2.48.0 版或更高版本)。 擴充功能會在您第一次執行 az fleet 命令時自動安裝。 深入了解擴充功能。

管理車隊的命令。

命令

名稱 Description 類型 狀態
az fleet create

建立或更新車隊。

副檔名 GA
az fleet delete

刪除車隊。

副檔名 GA
az fleet get-credentials

針對中樞機隊,取得車隊中樞叢集的 kubeconfig。

副檔名 GA
az fleet list

列出資源群組中的所有車隊。

副檔名 GA
az fleet member

管理成員的命令。

副檔名 GA
az fleet member create

建立或更新成員。

副檔名 GA
az fleet member delete

刪除車隊成員。

副檔名 GA
az fleet member list

列出車隊的成員。

副檔名 GA
az fleet member reconcile

協調成員。

副檔名 GA
az fleet member show

取得艦隊成員。

副檔名 GA
az fleet member update

更新成員。

副檔名 GA
az fleet member wait

等候成員資源達到所需的狀態。

副檔名 GA
az fleet reconcile

協調車隊。

副檔名 GA
az fleet show

取得車隊。

副檔名 GA
az fleet update

修補車隊資源。

副檔名 GA
az fleet updaterun

管理更新執行的命令。

副檔名 GA
az fleet updaterun create

建立或更新更新執行。

副檔名 GA
az fleet updaterun delete

刪除更新執行。

副檔名 GA
az fleet updaterun list

列出車隊的更新執行。

副檔名 GA
az fleet updaterun show

顯示更新執行。

副檔名 GA
az fleet updaterun skip

設定在 UpdateRun 內要略過的目標。

副檔名 GA
az fleet updaterun start

啟動更新執行。

副檔名 GA
az fleet updaterun stop

停止更新執行。

副檔名 GA
az fleet updaterun wait

等候更新執行資源達到所需的狀態。

副檔名 GA
az fleet updatestrategy

管理更新策略的命令。

副檔名 GA
az fleet updatestrategy create

建立或更新更新策略。

副檔名 GA
az fleet updatestrategy delete

刪除更新策略。

副檔名 GA
az fleet updatestrategy list

列出車隊的更新策略。

副檔名 GA
az fleet updatestrategy show

顯示更新策略。

副檔名 GA
az fleet updatestrategy wait

等候更新策略資源達到所需的狀態。

副檔名 GA
az fleet wait

等候車隊資源達到所需的狀態。

副檔名 GA

az fleet create

建立或更新車隊。

az fleet create --name
                --resource-group
                [--agent-subnet-id]
                [--apiserver-subnet-id]
                [--assign-identity]
                [--dns-name-prefix]
                [--enable-hub]
                [--enable-managed-identity]
                [--enable-private-cluster]
                [--enable-vnet-integration]
                [--location]
                [--no-wait]
                [--tags]
                [--vm-size]

範例

建立無中樞機隊。

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --tags "TagKey=TagValue"

建立中樞機隊。

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-hub --tags "TagKey=TagValue"

建立具有系統指派受控服務識別的車隊。

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-managed-identity

建立具有使用者指派受控服務識別的車隊。

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-managed-identity --assign-identity "/subscription/00000000-0000-0000-0000-000000000000/resourcegroup/MyFleetResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity"

必要參數

--name -n

指定車隊名稱。

--resource-group -g

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

選擇性參數

--agent-subnet-id
預覽

艦隊中樞節點將在啟動時加入的子網標識符。 如果未指定此專案,則會產生及使用 vnet 和子網。

--apiserver-subnet-id
預覽

啟用apiserver vnet整合時要使用的子網。 使用 BYO vnet 建立新的艦隊時,這是必要的。

--assign-identity

使用 --enable-managed-identity,藉由指定使用者指派的身分識別的資源標識符,在 Fleet 資源上啟用使用者指派的受控識別 (MSI)。

--dns-name-prefix -p
預覽

所建立主機名的前置詞。 如果未指定,請使用受控叢集和資源組名來產生主機名。

--enable-hub
預覽

如果設定,則會使用中樞叢集來建立 Fleet。

預設值: False
--enable-managed-identity

在 Fleet 資源上啟用系統指派的受控識別 (MSI)。

預設值: False
--enable-private-cluster
預覽

是否要將 Fleet 中樞建立為私人叢集。

預設值: False
--enable-vnet-integration
預覽

是否要啟用 Fleet 中樞的 apiserver vnet 整合。

預設值: False
--location -l

位置。​​ 來自的值: az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--no-wait

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

預設值: False
--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--vm-size
預覽

艦隊中樞的虛擬機大小。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet delete

刪除車隊。

az fleet delete --name
                --resource-group
                [--no-wait]
                [--yes]

範例

刪除特定機隊。

az fleet delete -g MyFleetResourceGroup -n MyFleetName

必要參數

--name -n

指定車隊名稱。

--resource-group -g

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

選擇性參數

--no-wait

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

預設值: False
--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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet get-credentials

針對中樞機隊,取得車隊中樞叢集的 kubeconfig。

az fleet get-credentials --name
                         --resource-group
                         [--context]
                         [--file]
                         [--overwrite-existing]

範例

取得車隊的中樞叢集 kubeconfig。

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName

取得艦隊的中樞叢集 kubeconfig,並將它儲存至特定檔案。

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName -f ~/mykubeconfigfile.txt

必要參數

--name -n

指定車隊名稱。

--resource-group -g

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

選擇性參數

--context

如果指定,請覆寫預設內容名稱。

--file -f

要更新的 Kubernetes 組態檔。 請改用 「-」 列印 YAML 至 stdout。

預設值: ~\.kube\config
--overwrite-existing

以相同名稱覆寫任何現有的叢集專案。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet list

列出資源群組中的所有車隊。

az fleet list [--resource-group]

範例

列出具有特定訂用帳戶的所有車隊。

az fleet list

列出存在於特定訂用帳戶和資源群組內的所有車隊。

az fleet list -g MyResourceGroup

選擇性參數

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet reconcile

協調車隊。

az fleet reconcile --name
                   --resource-group
                   [--no-wait]

範例

協調車隊。

az fleet reconcile -g MyFleetResourceGroup -n MyFleetName

必要參數

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet show

取得車隊。

az fleet show --name
              --resource-group

範例

顯示車隊的詳細數據。

az fleet show -g MyFleetResourceGroup -n MyFleetName

必要參數

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet update

修補車隊資源。

az fleet update --name
                --resource-group
                [--assign-identity]
                [--enable-managed-identity {false, true}]
                [--no-wait]
                [--tags]

範例

更新車隊的標籤。

az fleet update -g MyFleetResourceGroup -n MyFleetName --tags Key=Value

更新車隊以使用系統指派的受控服務識別。

az fleet update -g MyFleetResourceGroup -n MyFleetName --enable-managed-identity --tags Key=Value

更新車隊以使用使用者指派的受控服務識別。

az fleet update -g MyFleetResourceGroup -n MyFleetName --enable-managed-identity --assign-identity "/subscription/00000000-0000-0000-0000-000000000000/resourcegroup/MyFleetResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity" --tags Key=Value

必要參數

--name -n

指定車隊名稱。

--resource-group -g

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

選擇性參數

--assign-identity

使用 --enable-managed-identity,在 Fleet 資源上啟用使用者指派的受控識別 (MSI)。 指定現有的使用者指派身分識別資源。

--enable-managed-identity

在 Fleet 資源上啟用系統指派的受控識別 (MSI)。

接受的值: false, true
--no-wait

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

預設值: 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az fleet wait

等候車隊資源達到所需的狀態。

如果車隊上的作業中斷或以 啟動 --no-wait,請使用此命令等候它完成。

az fleet wait --fleet-name
              --resource-group
              [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--interval]
              [--timeout]
              [--updated]

必要參數

--fleet-name

Fleet 資源的名稱。 必要。

--resource-group -g

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--interval

輪詢間隔以秒為單位。

預設值: 30
--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。