az aks draft

參考

注意

此參考是 Azure CLI 的 aks-preview 延伸模組的一部分（2.61.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	然後`az aks draft generate-workflow`執行 `az aks draft setup-gh` 。	副檔名	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

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

此命令會 az aks draft setup-gh 結合和 az aks draft generate-workflow 來設定 GitHub OIDC，並產生 GitHub 工作流程，以自動建置並部署至 AKS。執行此命令之前，請先在 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 來取得完整偵錯記錄。

共用方式為

az aks draft

命令

az aks draft create

範例

選擇性參數

az aks draft generate-workflow

範例

選擇性參數

az aks draft setup-gh

範例

選擇性參數

az aks draft up

範例

選擇性參數

az aks draft update

範例

選擇性參數

其他資源