Serverless App Engine:CreateJob

ジョブテンプレートの名前。 半角英数字とハイフン (-) を使用できます。 先頭は半角英字である必要があり、長さは 36 文字以内にする必要があります。

SAE 名前空間の ID。 名前空間名は小文字とハイフン (-) のみを含めることができ、先頭は文字である必要があります。

ジョブテンプレートの説明。 1,024 文字を超えることはできません。

SAE 名前空間の VPC ID。 SAE では、名前空間は 1 つの VPC にのみバインドでき、このバインドは変更できません。 バインドは、名前空間に最初の SAE ジョブテンプレートを作成するときに確立されます。 1 つの VPC は複数の名前空間に関連付けることができます。 このパラメーターを指定しない場合、デフォルトで名前空間にバインドされている VPC の ID が使用されます。

タスクインスタンスの Elastic Network Interface (ENI) の vSwitch ID。 vSwitch は指定された VPC 内に配置する必要があります。 vSwitch は SAE 名前空間にもバインドされます。 このパラメーターを指定しない場合、デフォルトで名前空間にバインドされている vSwitch の ID が使用されます。

デプロイメントパッケージのタイプ。 有効な値：

• Java アプリケーションの場合、有効な値は FatJar、War、Image です。

• PHP アプリケーションの場合、有効な値は次のとおりです：

  • PhpZip

  • IMAGE_PHP_5_4

  • IMAGE_PHP_5_4_ALPINE

  • IMAGE_PHP_5_5

  • IMAGE_PHP_5_5_ALPINE

  • IMAGE_PHP_5_6

  • IMAGE_PHP_5_6_ALPINE

  • IMAGE_PHP_7_0

  • IMAGE_PHP_7_0_ALPINE

  • IMAGE_PHP_7_1

  • IMAGE_PHP_7_1_ALPINE

  • IMAGE_PHP_7_2

  • IMAGE_PHP_7_2_ALPINE

  • IMAGE_PHP_7_3

  • IMAGE_PHP_7_3_ALPINE

• Python アプリケーションの場合、有効な値は PythonZip と Image です。

デプロイメントパッケージのバージョン。 このパラメーターは、PackageType が FatJar、War、または PythonZip に設定されている場合に必要です。

デプロイメントパッケージの URL。 このパラメーターは、PackageType が FatJar、War、または PythonZip に設定されている場合に必要です。

イメージの URL。 このパラメーターは、PackageType が Image に設定されている場合に必要です。

デプロイメントパッケージに必要な JDK のバージョン。 次のバージョンがサポートされています：

• Open JDK 8

• Open JDK 7

• Dragonwell 11

• Dragonwell 8

• openjdk-8u191-jdk-alpine3.9

• openjdk-7u201-jdk-alpine3.9

このパラメーターは、PackageType が Image に設定されている場合はサポートされません。

デプロイメントパッケージに必要な Tomcat のバージョン。 次のバージョンがサポートされています：

• apache-tomcat-7.0.91

• apache-tomcat-8.5.42

このパラメーターは、PackageType が Image に設定されている場合はサポートされません。

各インスタンスに必要な CPU (ミリコア単位)。 この値を 0 にすることはできません。 現在、次の固定仕様のみがサポートされています：

• 500

• 1000

• 2000

• 4000

• 8000

• 16000

• 32000

各インスタンスに必要なメモリ (MB 単位)。 この値を 0 にすることはできません。 CPU とメモリの仕様は連動しています。 現在、次の仕様がサポートされています：

• 1024：CPU 500 または 1,000 ミリコアに対応します。

• 2048：CPU 500、1,000、または 2,000 ミリコアに対応します。

• 4096：CPU 1,000、2,000、または 4,000 ミリコアに対応します。

• 8192：CPU 2,000、4,000、または 8,000 ミリコアに対応します。

• 12288：CPU 12,000 ミリコアに対応します。

• 16384：CPU 4,000、8,000、または 16,000 ミリコアに対応します。

• 24576：CPU 12,000 ミリコアに対応します。

• 32768：CPU 16,000 ミリコアに対応します。

• 65536：CPU 8,000、16,000、または 32,000 ミリコアに対応します。

• 131072：CPU 32,000 ミリコアに対応します。

同時タスクインスタンスの数。

コンテナのエントリポイントコマンド。 コマンドはコンテナ内の実行可能ファイルである必要があります。 例：

command:
      - echo
      - abc
      - >
      - file0

上記の例では、Command="echo", CommandArgs=["abc", ">", "file0"] となります。

エントリポイントコマンド (Command) の引数。 形式は次のとおりです：

["a","b"]

Command パラメーターの例では、CommandArgs の値は ["abc", ">", "file0"] です。 この値は、JSON 配列を含む文字列である必要があります。 コマンドが引数を取らない場合は、このパラメーターを省略できます。

コンテナに設定する環境変数。 変数を参照するには、ConfigMap がすでに存在している必要があります。 詳細については、「CreateConfigMap」をご参照ください。 値は、次のいずれかの方法で設定できます：

• カスタム変数の指定

  • name：環境変数の名前。

  • value：環境変数の値。

• ConfigMap の参照

  • name：環境変数の名前。 単一のキーまたはすべてのキーを参照できます。 すべてのキーを参照するには、sae-sys-configmap-all-<ConfigMap name> 形式で値を入力します。 例：sae-sys-configmap-all-test1。

  • valueFrom：環境変数のソース。 値を configMapRef に設定します。

  • configMapId：ConfigMap の ID。

  • key：参照するキー。 すべてのキーと値のペアを参照する場合は、このパラメーターを指定しないでください。

コンテナ内でホスト名を IP アドレスにマッピングするホストエイリアス。 パラメーターは次のとおりです：

• hostName：ドメイン名またはホスト名。

• ip：IP アドレス。

JAR パッケージの起動オプション。 デフォルトの起動コマンドは次のとおりです：$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

JAR パッケージの起動引数。 デフォルトの起動コマンドは次のとおりです：$JAVA_HOME/bin/java $JarStartOptions -jar $CATALINA_OPTS "$package_path" $JarStartArgs

タスクの HSF 実行環境のバージョン (Ali-Tomcat コンテナなど)。

タイムゾーン。 デフォルト値：Asia/Shanghai。

Simple Log Service (SLS) にログを収集するための設定。

• SAE によって自動的に作成された SLS リソースを使用する場合：[{"logDir":"","logType":"stdout"},{"logDir":"/tmp/a.log"}]。

• 独自の SLS リソースを使用する場合：[{"projectName":"test-sls","logType":"stdout","logDir":"","logstoreName":"sae","logtailName":""},{"projectName":"test","logDir":"/tmp/a.log","logstoreName":"sae","logtailName":""}]。

パラメーターは次のとおりです：

• projectName：SLS プロジェクトの名前。

• logDir：ログファイルのパス。

• logType：ログタイプ。 stdout はコンテナの標準出力を示します。 標準出力は 1 つしか指定できません。 このパラメーターを設定しない場合、ファイルログが収集されます。

• logstoreName：SLS の Logstore の名前。

• logtailName：SLS の Logtail の名前。 このパラメーターを指定しない場合、新しい Logtail が作成されます。

後続のデプロイメントでログ収集設定が変更されない場合は、このパラメーターを設定する必要はありません (リクエストに SlsConfigs フィールドを含める必要はありません)。 ログ収集機能を使用する必要がなくなった場合は、リクエストでこのパラメーターの値を空の文字列 ("") に設定します。

NAS ファイルシステムの ID。 この設定が後続のデプロイメントで変更されない場合は、このパラメーターを省略できます。 NAS 設定をクリアするには、このパラメーターを空の文字列 ("") に設定します。

ジョブテンプレートの VPC 内の NAS マウントポイント。 この設定が後続のデプロイメントで変更されない場合は、このパラメーターを省略できます。 NAS 設定をクリアするには、このパラメーターを空の文字列 ("") に設定します。

NAS マウントの説明。 この設定が後続のデプロイメントで変更されない場合は、このパラメーターを省略できます。 NAS 設定をクリアするには、このパラメーターを空の文字列 ("") に設定します。

PreStop フック。 このスクリプトは、コンテナが停止する直前に実行されます。 値は JSON 文字列である必要があります。例：{"exec":{"command":["sh","-c","echo hello"]}}

PostStart フック。 このスクリプトは、コンテナが作成された直後に実行されます。 値は JSON 文字列である必要があります。例：{"exec":{"command":["sh","-c","echo hello"]}}

WAR パッケージデプロイメントの起動コマンド。 設定手順は、イメージベースのデプロイメントと同じです。 詳細については、「起動コマンドの設定」をご参照ください。

ConfigMap マウントの説明。 名前空間で作成された ConfigMap を使用して、コンテナに設定を挿入します。 パラメーターは次のとおりです：

• configMapId：ConfigMap の ID。 ListNamespacedConfigMaps 操作を呼び出してこの ID を取得できます。

• key：キー。

• mountPath：コンテナ内のマウントパス。

セキュリティグループ ID。

ネットワーク環境を自動的に設定するかどうかを指定します。 有効な値：

• true：ジョブテンプレートを作成するときに、SAE がネットワーク環境を自動的に設定します。 NamespaceId、VpcId、vSwitchId、SecurityGroupId の値は無視されます。

• false：ネットワーク環境を手動で設定する必要があります。

グレースフルシャットダウンのタイムアウト (秒単位)。 値は 1 から 300 までの整数である必要があります。 デフォルト：30。

PHP タスクの起動設定ファイルのマウントパス。 PHP サーバーが起動時にこの設定ファイルを使用することを確認する必要があります。

PHP 設定ファイルの内容。

Tomcat の設定。 設定を削除するには、このパラメーターを "" または {} に設定します。 パラメーターは次のとおりです：

• port：ポート番号。 有効な範囲は 1024 から 65535 です。 1024 未満のポートには root 権限が必要です。 コンテナは管理者権限で設定されているため、1024 より大きいポート番号を指定してください。 このパラメーターが設定されていない場合、デフォルトのポート 8080 が使用されます。

• contextPath：コンテキストパス。 デフォルト値：/。

• maxThreads：接続プール内の最大スレッド数。 デフォルト値：400。

• uriEncoding：Tomcat の URI エンコーディングスキーム。 有効な値：UTF-8、ISO-8859-1、GBK、GB2312。 このパラメーターが設定されていない場合、デフォルト値の ISO-8859-1 が使用されます。

• useBodyEncodingForUri：request.getCharacterEncoding() で指定されたエンコーディングを使用してリクエスト URI をデコードするかどうかを指定します。 デフォルト値：true。

Object Storage Service (OSS) マウントの説明。 パラメーターは次のとおりです：

• bucketName：バケットの名前。

• bucketPath：OSS のディレクトリまたはオブジェクト。 指定されたディレクトリまたはオブジェクトが存在しない場合、例外がスローされます。

• mountPath：SAE コンテナ内のパス。 パスが存在する場合は上書きされます。 パスが存在しない場合は作成されます。

• readOnly：コンテナがマウントディレクトリ内のリソースへの読み取り専用アクセス権を持つかどうかを指定します。 有効な値：

  • true：読み取り専用権限。

  • false：読み取り/書き込み権限。

OSS への読み取りおよび書き込み用の AccessKey ID。

OSS への読み取りおよび書き込み用の AccessKey Secret。

Container Registry (ACR) Enterprise Edition インスタンスの ID。 このパラメーターは、ImageUrl が ACR Enterprise Edition インスタンス内のイメージを指している場合に必要です。

アカウント間でイメージをプルするために必要な RAM ロールの Alibaba Cloud Resource Name (ARN)。 詳細については、「RAM ロールを使用して Alibaba Cloud アカウント間でイメージをプルする権限を付与する」をご参照ください。

イメージをプルするために使用されるシークレットの ID。

イメージアクセラレーションを有効にするかどうかを指定します。 有効な値：

• true：イメージアクセラレーションを有効にします。

• false：イメージアクセラレーションを無効にします。

ワークロード。 値を job に設定します。

タスクのトリガー設定。タスクの種類によって異なります。

• スケジュールタスク：type フィールドを time に、config フィールドを cron 式に、timezone フィールドを特定のタイムゾーンに設定します。 例：{"type":"time","config":"0 1 */1 * ?","timezone":"GMT+8:00"}

• ワンオフタスク：type フィールドを http に設定し、config フィールドで HTTP トリガールールを指定します。 詳細については、「SourceHttpEventParameters」をご参照ください。 例：{"type":"http","config":{"type":"HTTPS","method":["GET"],"ip":[],"referer":[],"securityConfig":"none"}}

タスクの同時実行ポリシー。 有効な値：

• Forbid：同時実行を禁止します。 前のタスクが完了していない場合、新しいタスクは作成されません。

• Allow：同時実行を許可します。

• Replace：次のタスクがスケジュールされたときに前のタスクがまだ実行中の場合、新しいタスクが古いタスクを置き換えます。

タスクのタイムアウト (秒単位)。

タスクが失敗とマークされるまでの最大再試行回数。

タスクシャーディングを有効にするかどうかを指定します。

タスクシャーディングのパラメーター。

参照されるジョブの ID。

プログラミング言語。 有効な値：java、php、python、shell。

Python 環境。 PYTHON 3.9.15 がサポートされています。

pip を使用してインストールする Python の依存関係。 このパラメーターを設定しない場合、SAE はプロジェクトのルートディレクトリにある 'requirements.txt' ファイルから依存関係をインストールします。

NAS ファイルシステムをマウントするための設定。

BestEffort ポリシー。