toolkit-maven-plugin を使用してアプリケーションをデプロイおよびスペックアップする場合は、さまざまなシナリオでさまざまなパラメーターを構成する必要があります。このトピックでは、toolkit-maven-plugin を使用してアプリケーションをデプロイするときに関係するパラメーターを構成する方法について説明します。
これらのパラメーターは、次の 3 つのカテゴリに分類されます。
- 基本環境 (env)
- アプリケーション構成 (app)
- ストレージ構成 (oss)
| 構成項目 | パラメーター | 必須/例 | 説明 |
| env | region_id | 必須 | アプリケーションをデプロイするリージョンの ID です。 |
| jar_path | target/demo.jar | アプリケーションのデプロイに使用するパッケージのパスです。絶対パスまたは相対パスを指定できます。パスを指定する場合、Maven でアプリケーションファイルをパッケージ化する必要はありません。 | |
| endpoint | いいえ | Apsara Stack にデプロイされたアプリケーションのゲートウェイに接続されているゲートウェイの接続拠点 (POP) です。 | |
| app | app_id | 必須 | アプリケーションの ID です。 |
| release_type | 1 | アプリケーションのリリース タイプです。有効な値:
| |
| package_version | いいえ | デプロイメントパッケージのバージョン。デフォルト値は、pom.xml ファイルのバージョンと現在のインスタンスが作成された時刻で構成される文字列です (例:1.0 (2018-09-27 19:00:00))。 | |
| desc | いいえ | デプロイメントの説明です。 | |
| group_id | いいえ | アプリケーションインスタンスグループの ID です。デフォルトでは、アプリケーションインスタンスはすべてのグループに属します。 | |
| batch | いいえ | リリースのバッチ数です。デフォルト値は 1、最大値は 5 です。 | |
| batch_wait_time | いいえ | リリースの連続する 2 つのバッチの間隔です。単位:分。デフォルト値は 0 です。 | |
| stage_timeout | いいえ | 変更プロセスの各ステージのタイムアウト期間です。単位:分。デフォルトでは、タイムアウト期間は 5 分です。 batch_wait_time 値を指定すると、指定された batch_wait_time 値が stage_timeout パラメーターの値に自動的に追加されます。アプリケーションの実行中に、ステージがこのしきい値よりも長い時間待機すると、プラグインは自動的に終了します。 | |
| oss | region_id | いいえ | バケットがデプロイされているリージョンの ID です。デフォルト値は、アプリケーションがデプロイされるリージョンの ID です。 |
| bucket | いいえ | データをアップロードするバケットの名前です。デフォルトでは、Enterprise Distributed Application Service (EDAS) によって提供される無料の Object Storage Service (OSS) バケットが使用されます。OSS をストレージに使用する場合は、bucket パラメーターを指定する必要があります。指定しない場合は、EDAS によって自動的に割り当てられる無料の OSS バケットが使用されます。 | |
| key | いいえ | アプリケーションパッケージを OSS にアップロードするために使用されるカスタムパスです。デフォルトでは、EDAS によって提供される無料の OSS バケットが使用されます。指定された OSS バケットを使用する場合は、このパラメーターを使用してアプリケーションパッケージのストレージパスを指定できます。また、{region_id}、{app_id}、{version} などの変数を使用して、パスをパラメーター化された方法で指定することもできます。たとえば、パスを pkgs/petstore/{version}/store.war に設定できます。デフォルトでは、値は {region_id}/{app_id}/{version} 形式に従います。 | |
| access_key_id | いいえ | アプリケーションパッケージを OSS にアップロードするために使用される AccessKey ID です。 | |
| access_key_secret | いいえ | アプリケーションパッケージを OSS にアップロードするために使用される AccessKey シークレットです。 | |
| use_vpc_endpoint | true | デフォルトでは、プラグインは指定された OSS バケットのパブリックエンドポイントを使用してパッケージをアップロードします。指定された OSS バケットの内部エンドポイントを使用してパッケージをアップロードするには、値を true に設定します。 |