az aks draft

  • 參考

注意

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

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

命令

名稱 Description 類型 狀態
az aks draft create

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

 副檔名 GA
az aks draft generate-workflow

產生 GitHub 工作流程，以自動建置並部署至 AKS。

 副檔名 GA
az aks draft setup-gh

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

 副檔名 GA
az aks draft up

設定 GitHub OIDC 併產生 GitHub 工作流程，以自動建置並部署至 AKS。

 副檔名 GA
az aks draft update

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

 副檔名 GA

az aks draft create

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

az aks draft create [--app]
                    [--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

選擇性參數

--app

指定 helm 版本的名稱。

--create-config

指定組態檔的路徑。

--deployment-only

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

--destination

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

預設值: .
--dockerfile-only

只產生 Kubernetes 部署的 Dockerfile。

--language

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

--path

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

全域參數
--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 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 [--branch]
                               [--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

產生具有資源群組、AKS 叢集名稱、特定專案目錄中容器登錄名稱的 GitHub 工作流程。

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

選擇性參數

--branch

指定要從中自動部署的 GitHub 分支。

--cluster-name

指定 AKS 叢集名稱。

--container-name

指定容器映像的名稱。

--destination

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

--path

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

--registry-name

指定項目目錄的路徑。

--resource-group

指定 Azure 資源群組的名稱。

全域參數
--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 aks draft setup-gh

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

az aks draft setup-gh [--app]
                      [--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。

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

以 Azure 上的應用程式名稱設定 GitHub OIDC，其中包含特定存放庫的訂用帳戶標識碼和資源群組。

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

選擇性參數

--app

指定 Azure Active Directory 應用程式名稱。

--gh-repo

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

--path

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

--provider

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

預設值: azure
--resource-group

指定 Azure 資源群組的名稱。

--subscription-id

指定 Azure 訂用帳戶標識碼。

全域參數
--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 aks draft up

設定 GitHub OIDC 併產生 GitHub 工作流程，以自動建置並部署至 AKS。

這個指令結合 az aks draft setup-gh 與 az aks draft generate-workflow。 執行此命令之前，請先在 Azure 上建立資源群組、容器登錄和 Kubernetes 叢集，並使用 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>連結三個資源。

az aks draft up [--app]
                [--branch]
                [--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

選擇性參數

--app

指定應用程式的名稱。

--branch

指定要從中自動部署的 GitHub 分支。

--cluster-name

指定 AKS 叢集名稱。

--container-name

指定容器映像的名稱。

--destination

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

--gh-repo

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

--path

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

--provider

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

預設值: azure
--registry-name

指定項目目錄的路徑。

--resource-group

指定 Azure 資源群組的名稱。

--subscription-id

指定 Azure 訂用帳戶標識碼。

全域參數
--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 aks draft update

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

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

az aks draft update [--certificate]
                    [--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

選擇性參數

--certificate

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

--destination

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

--host

指定輸入資源的主機。

--path

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

全域參數
--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 來取得完整偵錯記錄。