コンソールでのジョブの実行

ジョブを作成するときには、そのジョブを即時に実行できます。 ただし、ジョブの実行依頼や再実行依頼はいつでも行うことができます。 また、以前に作成したジョブの実行依頼や再実行依頼を行うこともできます。

1. 「ジョブ」ページに移動します。

   1. 「 Code Engine プロジェクトページ 」から、自分のプロジェクト名をクリックします。
   2. [ジョブ] をクリックし、[ ジョブ ] タブをクリックします。
   3. 実行したいジョブの名前をクリックしてください。

2. **「ジョブの実行依頼」**をクリックして、「ジョブの実行依頼」ダイアログを開きます。 インスタンス、CPU、メモリー、ジョブ再試行回数、ジョブ・タイムアウトなどのデフォルト構成値を確認し、必要に応じて変更します。 これらのオプションについて詳しくは、ジョブを作成および実行する際のオプションを参照してください。

3. **「ジョブの実行依頼」**をクリックしてジョブを実行します。 「ジョブの詳細 (job details)」ページに、ジョブのインスタンスの状況が表示されます。

4. ジョブのいずれかのインスタンスの実行に失敗した場合は、エラーをトラブルシューティングし、「失敗したインデックスの再実行 」をクリックして、失敗したインデックスに対してジョブを再度実行します。 「ジョブの送信」ペインで、設定値を確認し、必要に応じて変更してください。 「 配列インデックス 」セクションには、実行に失敗したジョブの実行インスタンスのインデックスが自動的に一覧表示されます。 構成値を確認し、オプションで変更した後、ジョブの実行依頼をクリックしてジョブを実行します。

一般的なジョブ実行インデックスのエラーのトラブルシューティングについては、「 ジョブ実行インデックスが失敗する原因の理解 」を参照してください。

また、既存のジョブ実行を再実行することもできます。 特定のジョブ実行を再実行するには、 「ジョブ実行」 タブをクリックしてから、処理するジョブ実行の名前をクリックします。 このジョブ実行を再実行するには、 「再実行」 をクリックします。

ロギング機能を追加すると、ジョブ・ログを表示できるようになります。 詳しくは、ログの表示を参照してください。

ジョブを実行するたびに、ジョブの各インスタンスに JOB_INDEX 環境変数が自動的に注入されます。 Code Engineによって設定される環境変数について詳しくは、「作成していない構成マップが表示されています」を参照してください。 削除できますか?。

CLI でのジョブの実行

開始前に

• Code Engine 環境をセットアップします。
• ジョブを作成します。

CLI でジョブを実行するには、jobrun submit コマンドを実行します。 オプションの完全なリストについては、ibmcloud ce jobrun submit コマンドを参照してください。

CLI を使用して、ジョブ構成に基づいてジョブを実行したり、最初にジョブ構成を作成せずにジョブを実行したりできます。

ibmcloud ce jobrun submit --name testjobrun --job myjob --array-indices "1 - 5"

ibmcloud ce jobrun submit --name myhellojob-jobruna --image us.icr.io/mynamespace/myhello_bld --registry-secret myregistry   --array-indices "1 - 5"

[...]
Name:          myhellojob-jobruna
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           3m6s
Created:       2021-06-04T11:56:22-04:00
Image:                us.icr.io/mynamespace/myhello_bld
Resource Allocation:
    CPU:                1
    Ephemeral Storage:  400M
    Memory:             4G
Registry Secrets:
    myregistry
Runtime:
    Mode:                  task
    Array Indices:         1 - 5
    Array Size:            5
    JOP_ARRAY_SIZE Value:  5
    Max Execution Time:    7200
    Retry Limit:           3
Status:
    Completed:          9s
    Instance Statuses:
        Succeeded:  5
    Conditions:
        Type      Status  Last Probe  Last Transition
    Pending   True    16s         16s
    Running   True    13s         13s
    Complete  True    9s          9s
Events:
    Type    Reason     Age                Source                Messages
    Normal  Updated    11s (x8 over 18s)  batch-job-controller  Updated JobRun "myhellojob-jobruna"
    Normal  Completed  11s                batch-job-controller  JobRun completed successfully
Instances:
    Name                    Running  Status     Restarts  Age
    myhellojob-jobruna-1-0  0/1      Succeeded  0         18s
    myhellojob-jobruna-2-0  0/1      Succeeded  0         18s
    myhellojob-jobruna-3-0  0/1      Succeeded  0         18s
    myhellojob-jobruna-4-0  0/1      Succeeded  0         18s
    myhellojob-jobruna-5-0  0/1      Succeeded  0         18s

CLI でのジョブの再実行

前のジョブ実行の構成に基づいてジョブ実行を再実行する場合は、jobrun resubmit コマンドを使用します。 このコマンドには、前のジョブ実行の名前が必要です。また、オプションの他の引数を指定することもできます。 オプションの完全なリストについては、ibmcloud ce jobrun resubmit コマンドを参照してください。

例えば、次の jobrun resubmit コマンドでは、testjobrun ジョブ実行を再実行します。

ibmcloud ce jobrun resubmit --jobrun testjobrun

出力例

Getting job run 'testjobrun'...
Getting job 'myjob'...
Rerunning job run 'myjob-jobrun-fji48'...
Run 'ibmcloud ce jobrun get -n myjob-jobrun-fji48' to check the job run status.

例えば、次の jobrun resubmit コマンドでは、最初にジョブ構成を作成せずに実行された myhellojob-jobruna ジョブ実行を再実行します。 参照されるジョブ実行に関連するジョブ構成がないため、--nameオプションを指定してこのジョブ実行の名前を指定する必要があります。

ibmcloud ce jobrun resubmit --jobrun myhellojob-jobruna --name myhellojob-jobrunb

ジョブ実行状況を確認するには、jobrun get -n myhellojob-jobrunb コマンドを実行します。

出力例

Getting jobrun 'myhellojob-jobrunb'...
[...]
Name:          myhellojob-jobrunb
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           3m6s
Created:       2021-06-04T11:56:22-04:00
Image:                us.icr.io/mynamespace/myhello_bld
Resource Allocation:
    CPU:                1
Ephemeral Storage:  400M
Memory:             4G
Registry Secrets:
    myregistry
Runtime:
    Mode:                  task
    Array Indices:         1 - 5
    Array Size:            5
    JOP_ARRAY_SIZE Value:  5
    Max Execution Time:    7200
    Retry Limit:           3
Status:
    Completed:          91s
Instance Statuses:
    Succeeded:  5
Conditions:
    Type      Status  Last Probe  Last Transition
    Pending   True    96s         96s
    Running   True    92s         92s
    Complete  True    91s         91s
Events:
    Type    Reason     Age                Source                Messages
Normal  Updated    93s (x7 over 97s)  batch-job-controller  Updated JobRun "myhellojob-jobrunb"
Normal  Completed  93s                batch-job-controller  JobRun completed successfully
Instances:
    Name                    Running  Status     Restarts  Age
myhellojob-jobrunb-1-0  0/1      Succeeded  0         97s
myhellojob-jobrunb-2-0  0/1      Succeeded  0         97s
myhellojob-jobrunb-3-0  0/1      Succeeded  0         97s
myhellojob-jobrunb-4-0  0/1      Succeeded  0         97s
myhellojob-jobrunb-5-0  0/1      Succeeded  0         97s

CLI を使用して実行依頼 (または再実行依頼) された、定義されたジョブ構成を参照しないジョブ実行は、コンソールには表示されません。

次のステップ

• ジョブの実行後に、ジョブおよびジョブ実行の詳細を表示するには、アクセス・ジョブの詳細を参照してください。

• ジョブが作成されたので、ジョブをイベント・ドリブンにすることを検討してください。 イベント・サブスクリプションを使用すると、定期的なスケジュールによってジョブをトリガーしたり、ファイルのアップロードなどのイベントに反応するようにジョブを設定したりすることができます。

• ジョブの作成方法や以前の更新方法に関係なく、以下の任意の方法でジョブの更新および参照されるコードの更新を行うことができます。

  • Open Container Initiative（OCI）規格に準拠したコンテナイメージをお持ちの場合は、ジョブの作成（または更新）時に、コンテナレジストリの場所を指すイメージへの参照のみを指定すれば十分です。 パブリックレジストリ または プライベートレジストリ 内のイメージを使用してジョブを作成（または更新）し、ジョブの実行中にその参照されたイメージにアクセスすることができます。

    job create コマンドを使用してジョブを作成し、 --build-source オプションを指定してローカル・ソースまたはリポジトリー・ソースからコンテナー・イメージをビルドし、別のコンテナー・イメージを指すようにジョブを変更する場合は、まず、ジョブからビルドの関連付けを削除する必要があります。 例えば、 ibmcloud ce job update -n JOB_NAME --build-clear を実行します。 ジョブからビルドの関連付けを削除した後、別のイメージを参照するようにジョブを更新できます。

  • Git リポジトリーにあるソース・コードから開始する場合は、ソースからイメージをビルドし、単一操作を使用してジョブを作成 (または更新) する処理を Code Engine に任せることができます。 このシナリオでは、Code Engine はイメージを IBM Cloud® Container Registry にアップロードします。 詳しくは、リポジトリー・ソース・コードからのジョブの作成を参照してください。 イメージのビルドをさらに制御したい場合は、ジョブを作成 (または更新) してジョブを実行する前に、Code Engine を使用してイメージのビルドを選択することができます。

  • ローカル・ワークステーションにあるソース・コードから開始する場合は、単一 CLI コマンドを使用して、ソースからのイメージのビルドとジョブの作成を Code Engine に処理させることができます。 このシナリオでは、Code Engine はイメージを IBM Cloud® Container Registry にアップロードします。 詳しくは、CLI を使用したローカル・ソース・コードからのジョブの作成を参照してください。 イメージのビルドをさらに制御したい場合は、ジョブを作成 (または更新) してジョブを実行する前に、Code Engine を使用してイメージのビルドを選択することができます。

  例えば、ジョブのソースの開発を進化させながら、ローカル・ソースのビルドを Code Engine に処理させることができます。 その後、イメージが成熟すると、目的の特定のイメージを参照するようにジョブを更新できます。 必要に応じて、このプロセスを繰り返すことができます。

  更新されたジョブを実行すると、イメージにタグが指定されていない限り、参照されたコンテナー・イメージの最新バージョンがジョブ実行に使用されます。 イメージにタグが指定されている場合、タグ付けされたイメージがジョブ実行に使用されます。

コード・サンプルがさらに必要ですか? 「 IBM Cloud Code Engine 」のサンプルについては、 GitHub リポジトリをご覧ください。