az aks draft

Note

此參考是Azure CLI（版本 2.76.0 或更高版本）aks-preview 擴充的一部分。 擴充功能會在您第一次執行 az aks draft 命令時自動安裝。 深入了解擴充功能。

在專案目錄中建置部署檔案並部署至 AKS 叢集的命令。

命令

名稱	Description	類型	狀態
az aks draft create	產生 Dockerfile，以及項目目錄所需的最低 Kubernetes 部署檔案（helm、kustomize、manifests）。	Extension	GA
az aks draft generate-workflow	產生一個 GitHub 工作流程，方便自動建置並部署到 AKS。	Extension	GA
az aks draft setup-gh	為你的應用程式設定 GitHub OIDC。	Extension	GA
az aks draft up	然後az aks draft setup-gh執行 az aks draft generate-workflow 。	Extension	GA
az aks draft update	將您的應用程式更新為可存取因特網。	Extension	GA

az aks draft create

產生 Dockerfile，以及項目目錄所需的最低 Kubernetes 部署檔案（helm、kustomize、manifests）。

az aks draft create [--acquire-policy-token]
                    [--app]
                    [--change-reference]
                    [--create-config]
                    [--deployment-only]
                    [--destination]
                    [--dockerfile-only]
                    [--language]
                    [--path]

範例

提示在目前目錄中產生 Dockerfile 和部署檔案。

az aks draft create

只產生目前目錄中的 Dockerfile。

az aks draft create --dockerfile-only=true

只產生目前目錄中的部署檔案。

az aks draft create --deployment-only=true

在 Java 專案中產生一個 Dockerfile 和一個部署檔案，並設定一個應用程式名稱，放在特定的專案目錄中。

az aks draft create --language=java --app=some_app --destination=/projects/some_project

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--app

指定 helm 版本的名稱。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--create-config

指定組態檔的路徑。

--deployment-only

只產生 Kubernetes 部署的部署檔案（helm、kustomize、manifests）。

--destination

指定項目目錄的路徑（預設值為。）。

屬性	值
預設值:	.

--dockerfile-only

只產生 Kubernetes 部署的 Dockerfile。

--language

指定用來建立 Kubernetes 部署的語言。

--path

自動下載並使用指定位置的草稿二進位檔。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az aks draft generate-workflow

產生一個 GitHub 工作流程，方便自動建置並部署到 AKS。

執行這個指令前，請確定你已經為你的應用程式設定了 GitHub OIDC。 你還需要在 Azure 上建立資源群組、容器登錄檔和 Kubernetes 叢集，並使用 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name> 連結這三個資源。

az aks draft generate-workflow [--acquire-policy-token]
                               [--branch]
                               [--change-reference]
                               [--cluster-name]
                               [--container-name]
                               [--destination]
                               [--path]
                               [--registry-name]
                               [--resource-group]

範例

提示在目前目錄中產生 GitHub 工作流程。

az aks draft generate-workflow

提示在特定專案目錄中產生 GitHub 工作流程。

az aks draft generate-workflow --destination=/projects/some_project

在特定專案目錄中產生一個 GitHub 工作流程，包含資源群組、AKS 叢集名稱、容器登錄檔名稱。

az aks draft generate-workflow --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --destination=/projects/some_project

建立一個 GitHub 工作流程，從主分支部署，包含資源群組、AKS 叢集名稱、容器登錄檔名稱，以及特定專案目錄中的容器映像名稱。

az aks draft generate-workflow --branch=main --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --container-name=some_image --destination=/projects/some_project

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--branch

指定 GitHub 分支來自動部署。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--cluster-name

指定 AKS 叢集名稱。

--container-name

指定容器映像的名稱。

--destination

指定項目目錄的路徑（預設值為。）。

--path

自動下載並使用指定位置的草稿二進位檔。

--registry-name

指定項目目錄的路徑。

--resource-group

請指定 Azure 資源群組的名稱。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az aks draft setup-gh

為你的應用程式設定 GitHub OIDC。

az aks draft setup-gh [--acquire-policy-token]
                      [--app]
                      [--change-reference]
                      [--gh-repo]
                      [--path]
                      [--provider]
                      [--resource-group]
                      [--subscription-id]

範例

提示設定 GitHub OIDC 以建立倉庫。

az aks draft setup-gh

在 Azure 上為特定倉庫設置 GitHub OIDC。

az aks draft setup-gh --provider=azure --gh-repo=some_organization/some_repo

在 Azure 上設置 GitHub OIDC，並設定訂閱 ID 和資源群組。

az aks draft setup-gh --provider=azure --subscription-id=some_subscription --resource-group=some_rg

在 Azure 上設定 GitHub OIDC，並設定一個應用程式名稱，並設定訂閱 ID 和特定儲存庫的資源群組。

az aks draft setup-gh --app=some_app --provider=azure --subscription-id=some_subscription --resource-group=some_rg --gh-repo=some_organization/some_repo

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--app

Specify the Azure Active Directory applicaton name.

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--gh-repo

指定GitHub儲存庫（組織/repo_name）。

--path

自動下載並使用指定位置的草稿二進位檔。

--provider

指定雲端提供者（預設值為 azure）。

屬性	值
預設值:	azure

--resource-group

請指定 Azure 資源群組的名稱。

--subscription-id

請指定 Azure 訂閱 ID。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az aks draft up

然後az aks draft setup-gh執行 az aks draft generate-workflow 。

此指令結合 az aks draft setup-gh 與 az aks draft generate-workflow，用以設定 GitHub OIDC，並產生自動建置與部署至 AKS 的GitHub工作流程。 執行此指令前，先建立資源群組、容器登錄檔及 Kubernetes 叢集Azure，並使用 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name> 連結這三個資源。

az aks draft up [--acquire-policy-token]
                [--app]
                [--branch]
                [--change-reference]
                [--cluster-name]
                [--container-name]
                [--destination]
                [--gh-repo]
                [--path]
                [--provider]
                [--registry-name]
                [--resource-group]
                [--subscription-id]

範例

提示設定 GitHub OIDC，然後在目前目錄中產生 GitHub 工作流程。

az aks draft up

提示設定 GitHub OIDC，然後在特定專案目錄中產生 GitHub 工作流程。

az aks draft up --destination=/projects/some_project

提示為特定倉庫設定 GitHub OIDC，然後在特定專案目錄中產生 GitHub 工作流程。

az aks draft up --gh-repo=some_organization/some_repo --destination=/projects/some_project

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--app

指定應用程式的名稱。

--branch

指定 GitHub 分支來自動部署。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--cluster-name

指定 AKS 叢集名稱。

--container-name

指定容器映像的名稱。

--destination

指定項目目錄的路徑（預設值為。）。

--gh-repo

指定GitHub儲存庫（組織/repo_name）。

--path

自動下載並使用指定位置的草稿二進位檔。

--provider

指定雲端提供者（預設值為 azure）。

屬性	值
預設值:	azure

--registry-name

指定項目目錄的路徑。

--resource-group

請指定 Azure 資源群組的名稱。

--subscription-id

請指定 Azure 訂閱 ID。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az aks draft update

將您的應用程式更新為可存取因特網。

此命令會視需要自動更新您的 yaml 檔案，讓您的應用程式能夠接收外部要求。

az aks draft update [--acquire-policy-token]
                    [--certificate]
                    [--change-reference]
                    [--destination]
                    [--host]
                    [--path]

範例

提示將應用程式更新為可存取因特網。

az aks draft update

提示將應用程式更新為可在特定項目目錄中存取因特網。

az aks draft update --destination=/projects/some_project

使用特定項目目錄中的輸入資源主機和 Keyvault 憑證，將應用程式更新為可存取因特網。

az aks draft update --host=some_host --certificate=some_certificate --destination=/projects/some_project

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--certificate

指定要呈現之 Keyvault 憑證的 URI。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--destination

指定項目目錄的路徑（預設值為。）。

--host

指定輸入資源的主機。

--path

自動下載並使用指定位置的草稿二進位檔。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False