Share via

az aks draft

  • リファレンス

Note

このリファレンスは、Azure CLI (バージョン 2.56.0 以降) の aks-preview 拡張機能の一部です。 拡張機能は、az aks draft コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

プロジェクト ディレクトリに配置ファイルをビルドし、AKS クラスターにデプロイするためのコマンド。

コマンド

名前 説明 型 Status
az aks draft create

Dockerfile と、プロジェクト ディレクトリに必要な最小限の Kubernetes デプロイ ファイル (helm、kustomize、マニフェスト) を生成します。

 拡張機能 GA
az aks draft generate-workflow

自動ビルド用の GitHub ワークフローを生成し、AKS にデプロイします。

 拡張機能 GA
az aks draft setup-gh

アプリケーションの GitHub OIDC を設定します。

 拡張機能 GA
az aks draft up

GitHub OIDC を設定し、自動ビルドと AKS へのデプロイのための GitHub ワークフローを生成します。

 拡張機能 GA
az aks draft update

インターネットにアクセスできるようにアプリケーションを更新します。

 拡張機能 GA

az aks draft create

Dockerfile と、プロジェクト ディレクトリに必要な最小限の Kubernetes デプロイ ファイル (helm、kustomize、マニフェスト) を生成します。

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、マニフェスト) のみを生成します。

--destination

プロジェクト ディレクトリへのパスを指定します (既定値は .)。

既定値: .
--dockerfile-only

Kubernetes デプロイに対してのみ Dockerfile を生成します。

--language

Kubernetes デプロイの作成に使用する言語を指定します。

--path

指定した場所にある Draft バイナリを自動的にダウンロードして使用します。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 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>3 つのリソースをリンクする必要があります。

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

リソース グループ、AKS クラスター名、コンテナー レジストリ名、および特定のプロジェクト ディレクトリ内のコンテナー イメージ名を使用して、メイン ブランチからデプロイする GitHub ワークフローを生成します。

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

指定した場所にある Draft バイナリを自動的にダウンロードして使用します。

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

サブスクリプションの名前または ID。 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

サブスクリプション ID とリソース グループを使用して、Azure に GitHub OIDC をセットアップします。

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

特定のリポジトリのサブスクリプション ID とリソース グループを使用して、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

指定した場所にある Draft バイナリを自動的にダウンロードして使用します。

--provider

クラウド プロバイダーを指定します (既定値は azure)。

既定値: azure
--resource-group

Azure リソース グループの名前を指定します。

--subscription-id

Azure サブスクリプション ID を指定します。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az aks draft up

GitHub OIDC を設定し、自動ビルドと AKS へのデプロイのための GitHub ワークフローを生成します。

このコマンドでは、次のコマンドを組み合わせて使用しますaz aks draft setup-ghaz aks draft generate-workflow。 このコマンドを実行する前に、Azure 上にリソース グループ、コンテナー レジストリ、Kubernetes クラスターを作成し、次を使用して az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>3 つのリソースをリンクします。

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

指定した場所にある Draft バイナリを自動的にダウンロードして使用します。

--provider

クラウド プロバイダーを指定します (既定値は azure)。

既定値: azure
--registry-name

プロジェクト ディレクトリへのパスを指定します。

--resource-group

Azure リソース グループの名前を指定します。

--subscription-id

Azure サブスクリプション ID を指定します。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 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

指定した場所にある Draft バイナリを自動的にダウンロードして使用します。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。