タスクの実行方法

[更新: 2024年06月27日]

高火力 DOK で、タスクを実行する方法についての説明です。

事前準備

以下のものを事前にご用意ください

  • 実行したいタスクをまとめたコンテナーイメージ
  • 上記のイメージを登録したレジストリー

警告

タスク内でワーキングディレクトリー(ホームディレクトリー)に保存したデータは、タスクが終了すると削除されます。

タスク終了後も必要なデータは、終了前に外部ストレージに格納いただくか、環境変数 SAKURA_ARTIFACT_DIR で示されるディレクトリーに保存して終了後にダウンロードしてください。 SAKURA_ARTIFACT_DIR については、 環境変数について および サービス仕様 も参照ください。

注釈

  • タスクで使うデータ(学習データや成果物など)の格納には、高速・大容量の オブジェクトストレージ をご利用いただくと便利です(別途料金がかかります)。
  • レジストリーには、認証が必要なレジストリーを簡単に作れる コンテナレジストリ(Lab) をご利用いただくと便利です。
  • 認証が必要なレジストリーを使う場合は、以降のステップに進む前に認証情報を登録する必要があります。詳細は プライベートレジストリーの使用方法 を参照ください。

タスクの作成

タスク一覧画面 右上の「新規作成」ボタンをクリックしてください。

タスク一覧画面

タスク作成画面に遷移しますので、実行したいタスクの情報(イメージ / プライベートレジストリー情報 / コマンド等)を入力し、「作成」をクリックしてください。

タスク作成画面

注釈

  • イメージは、 docker pull を実行する時と同じように入力してください(例: ubuntu:latest, quay.io/centos/centos:latest )。
  • 認証が不要なレジストリーを使う場合は、「プライベートレジストリー情報」を空欄にしてください。
  • コマンドおよびエントリーポイントは、 Dockerfile 内の COMMAND / ENTRYPOINT を上書きします。デフォルト値のまま実行する場合は空欄にしてください。
  • 環境変数を指定する場合は 環境変数について も参照ください。
  • プランについては GPUプラン を参照ください。

警告

コマンドおよびエントリーポイントを指定する場合は、コマンドラインで docker run を実行する時と同じように入力してください。 例えば &&|| などで複数のコマンドを実行する場合は、シェルの引数として指定する必要があります。

例)Bashで echo a && echo b を実行する場合

  • コマンド: -c "echo a && echo b"
  • エントリーポイント: /bin/bash

タスクが作成されると、タスク詳細画面に遷移します。 作成したタスクの情報を確認してください。

タスク詳細画面

以上でタスクの作成は完了です。

既存タスクの複製

これまでに実行したタスクの情報を複製して新しいタスクを実行することもできます。 タスクのパラメーターを一部変更するときなどに便利です。

タスク一覧画面 で、複製したいタスクのIDをクリックしてください。 タスクの詳細画面に遷移しますので、右上の「コピーして新規作成」をクリックしてください。

タスク詳細画面からコピー

タスクの情報がコピーされた状態でタスク作成画面に遷移します。 必要であれば情報を上書きして「作成」をクリックしてください。

環境変数について

コンテナー内では以下の環境変数を使用できます。 これ以外にも独自の環境変数を実行時に定義できますが、 SAKURA_ で始まる環境変数は定義しないでください。

定義済み環境変数の一覧
変数名 意味 値の例
SAKURA_TASK_ID タスクを一意に識別するIDです。 be7fdd79-b5e6-4654-a08b-d4143c5d0351
SAKURA_ARTIFACT_DIR アーティファクト保存用のディレクトリー名です。
このディレクトリー内に保存したファイルは、
タスク終了後に tar.gz 形式でダウンロードできるようになります。
/opt/artifact