az spring app deployment

  • リファレンス

Note

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

Azure Spring Apps でのアプリのデプロイのライフ サイクルを管理するコマンド。 デプロイに対するその他の操作は、パラメーター --deployment を使用してアプリ レベルで実行できます。 例: az spring app deploy --deployment .

コマンド

名前 説明 型 Status
az spring app deployment create

アプリのステージング環境のデプロイを作成します。 既存のデプロイにコードまたは更新設定を展開するには、次を使用 az spring app deploy/update --deployment <staging deployment>します。

 拡張子 GA
az spring app deployment delete

アプリのデプロイを削除します。

 拡張子 GA
az spring app deployment generate-heap-dump

指定されたファイル パスへのターゲット アプリ インスタンスのヒープ ダンプを生成します。

 拡張子 GA
az spring app deployment generate-thread-dump

指定されたファイル パスへのターゲット アプリ インスタンスのスレッド ダンプを生成します。

 拡張子 GA
az spring app deployment list

アプリのすべてのデプロイを一覧表示します。

 拡張子 GA
az spring app deployment show

デプロイの詳細を表示します。

 拡張子 GA
az spring app deployment start-jfr

指定されたファイル パスに対して、ターゲット アプリ インスタンスで JFR を開始します。

 拡張子 GA

az spring app deployment create

アプリのステージング環境のデプロイを作成します。 既存のデプロイにコードまたは更新設定を展開するには、次を使用 az spring app deploy/update --deployment <staging deployment>します。

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--disable-app-log]
                                [--disable-probe {false, true}]
                                [--disable-validation {false, true}]
                                [--enable-liveness-probe {false, true}]
                                [--enable-readiness-probe {false, true}]
                                [--enable-startup-probe {false, true}]
                                [--env]
                                [--grace-period]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                                [--scale-rule-auth]
                                [--scale-rule-http-concurrency]
                                [--scale-rule-metadata]
                                [--scale-rule-name]
                                [--scale-rule-type]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

例

アプリの新しいデプロイにソース コードをデプロイします。 これにより、現在のディレクトリがパックされ、Pivotal Build Service でバイナリがビルドされ、デプロイされます。

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --source-path

jvm オプションと環境変数を使用して、事前構築済みの jar をアプリにデプロイします。

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Docker Hub 上のコンテナー イメージをアプリにデプロイします。

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

プライベート レジストリ上のコンテナー イメージをアプリにデプロイします。

az spring app deployment create -n green-deployment --app MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

必須のパラメーター

--app

アプリの名前。

--name -n

デプロイの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

省略可能のパラメーター

--apms

(エンタープライズ層のみ)スペース区切りの APM 名。

--artifact-path

指定された事前構築済み成果物 (jar、war、または netcore zip、war はパブリック プレビュー段階) をデプロイします。

--build-certificates

(エンタープライズ層のみ)スペースで区切られた証明書名。証明書はビルド時に使用されます。

--build-env

スペースで区切られた "key[=value]" 形式の環境変数。

--builder

(エンタープライズ層のみ)実行可能ファイルのビルドに使用するサービス ビルダーをビルドします。

既定値: default
--config-file-patterns

(エンタープライズ層のみ)使用する Application Configuration Service のパターンを決定するために、"," で区切られたファイル パターンを構成します。 既存の構成をクリアするには、'""' を使用します。

--container-args

コンテナー イメージの引数。

--container-command

コンテナー イメージのコマンド。

--container-image

コンテナー イメージ タグ。

--container-registry

コンテナー イメージのレジストリ。

既定値: docker.io
--cpu

CPU リソース量。 250m、500m、750m、1250m、または CPU コア数である必要があります。

--custom-actuator-path

(エンタープライズ層のみ)アプリのカスタム アクチュエータ パス。 既定値は "/actuator" です。

--custom-actuator-port

(エンタープライズ層のみ)アプリのカスタム アクチュエータ ポート。 既定値は 8080 です。

--disable-app-log

アプリケーションのデプロイ時にアプリケーション ログを出力しないでください。

既定値: False
--disable-probe

true の場合は、liveness と readiness プローブを無効にします。

承認された値: false, true
--disable-validation

true の場合は、jar 検証を無効にします。

承認された値: false, true
--enable-liveness-probe
プレビュー

false の場合、アプリ インスタンスのライブネス プローブが無効になります。

承認された値: false, true
--enable-readiness-probe
プレビュー

false の場合、アプリ インスタンスの準備プローブが無効になります。

承認された値: false, true
--enable-startup-probe
プレビュー

false の場合、アプリ インスタンスのスタートアップ プローブが無効になります。

承認された値: false, true
--env

スペースで区切られた "key[=value]" 形式の環境変数。

--grace-period --termination-grace-period-seconds
プレビュー

アプリ インスタンスが正常に終了する必要がある時間 (秒単位)。

--instance-count

インスタンスの数。

--jvm-options

jvm オプションを含む文字列。bash 解析エラーを回避するには、この引数に ' ' の代わりに '=' を使用します。例: --jvm-options='-Xms1024m -Xmx2048m'。

--language-framework

アップロードされたコンテナー イメージの言語フレームワーク。 サポートされる値: "springboot"、"。

--liveness-probe-config
プレビュー

json ファイル パスは、ライブネス プローブの構成を示します。

--main-entry -m

zip ルートを基準とした .NET 実行可能ファイルへのパスを含む文字列。

--max-replicas

レプリカの最大数。

既定値: 10
--memory

メモリ リソースの量。 512Mi、1536Mi、2560Mi、3584Mi、または #Gi にする必要があります (例: 1Gi、3Gi)。

--min-replicas

レプリカの最小数。

既定値: 1
--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--readiness-probe-config
プレビュー

json ファイル パスは、準備プローブの構成を示します。

--registry-password

コンテナー レジストリのパスワード。

--registry-username

コンテナー レジストリのユーザー名です。

--runtime-version

使用されている言語のランタイム バージョン。

承認された値: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

ルール認証パラメーターをスケーリングします。 "=" の書式をスペースで区切ります。

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

スケールアウト前の同時要求の最大数。http および tcp スケール ルールでのみサポートされます。

--scale-rule-metadata --srm

スケール ルールのメタデータ。 "key[=value]" の書式をスペースで区切ります。

--scale-rule-name --srn

スケール ルールの名前。

--scale-rule-type --srt

スケール ルールの種類。 既定値: http。

--server-version

(Standard レベルと Basic レベルのみ)Tomcat サーバーのバージョン。 を実行 az spring list-support-server-versions -o tableして、サポートされているすべてのサーバー バージョンを一覧表示します。 この機能はパブリック プレビュー段階にあります。

--skip-clone-settings

ステージングデプロイを作成すると、運用環境のデプロイから設定が自動的にコピーされます。

既定値: False
--source-path

指定したソース フォルダーを展開します。 フォルダーは tar にパックされ、アップロードされ、kpack を使用してビルドされます。 値が指定されていない場合は、既定で現在のフォルダーに設定されます。

--startup-probe-config
プレビュー

json ファイル パスは、スタートアップ プローブの構成を示します。

--target-module

デプロイする子モジュール。ソース コードからビルドされた複数の jar パッケージに必要です。

--version

デプロイ バージョン。設定されていない場合は変更しないでください。

グローバル パラメーター
--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 spring app deployment delete

アプリのデプロイを削除します。

az spring app deployment delete --app
                                --name
                                --resource-group
                                --service
                                [--no-wait]

必須のパラメーター

--app

アプリの名前。

--name -n

デプロイの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

省略可能のパラメーター

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

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

--verbose

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

az spring app deployment generate-heap-dump

指定されたファイル パスへのターゲット アプリ インスタンスのヒープ ダンプを生成します。

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

必須のパラメーター

--app

アプリの名前。

--app-instance

ダンプするターゲット アプリ インスタンス。

--file-path

ダンプ ファイルのマウント ファイル パス。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

省略可能のパラメーター

--deployment -d

アプリの既存のデプロイの名前。 指定されていない場合は、既定で運用環境のデプロイになります。

グローバル パラメーター
--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 spring app deployment generate-thread-dump

指定されたファイル パスへのターゲット アプリ インスタンスのスレッド ダンプを生成します。

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

必須のパラメーター

--app

アプリの名前。

--app-instance

ダンプするターゲット アプリ インスタンス。

--file-path

ダンプ ファイルのマウント ファイル パス。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

省略可能のパラメーター

--deployment -d

アプリの既存のデプロイの名前。 指定されていない場合は、既定で運用環境のデプロイになります。

グローバル パラメーター
--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 spring app deployment list

アプリのすべてのデプロイを一覧表示します。

az spring app deployment list --app
                              --resource-group
                              --service

必須のパラメーター

--app

アプリの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

グローバル パラメーター
--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 spring app deployment show

デプロイの詳細を表示します。

az spring app deployment show --app
                              --name
                              --resource-group
                              --service

必須のパラメーター

--app

アプリの名前。

--name -n

デプロイの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

グローバル パラメーター
--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 spring app deployment start-jfr

指定されたファイル パスに対して、ターゲット アプリ インスタンスで JFR を開始します。

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

必須のパラメーター

--app

アプリの名前。

--app-instance

ダンプするターゲット アプリ インスタンス。

--file-path

ダンプ ファイルのマウント ファイル パス。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service -s

Azure Spring Apps インスタンスの名前。az configure --defaults spring= を使用して既定のサービスを構成できます。

省略可能のパラメーター

--deployment -d

アプリの既存のデプロイの名前。 指定されていない場合は、既定で運用環境のデプロイになります。

--duration

JFR の期間。

既定値: 60s
グローバル パラメーター
--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 を使います。