2.3. カスタムトレーニングイメージの管理

手順

1. ターミナルウィンドウで、作業用のディレクトリーを作成し、そのディレクトリーに移動します。

2. IMG 環境変数をカスタムイメージの名前に設定します。このセクションのコマンド例では、my_training_image がカスタムイメージの名前です。

   export IMG=my_training_image

   Copy to Clipboard Toggle word wrap

3. 次の内容を含むファイルを、Dockerfile という名前で作成します。

   1. FROM 命令を使用して、適切なベーストレーニングイメージの場所を指定します。

      以下のコマンドで、_<base-training-image>_ を選択した基本トレーニングイメージの名前に置き換えます。

      FROM quay.io/modh/<base-training-image>

      Copy to Clipboard Toggle word wrap

      例:

      FROM quay.io/modh/ray:2.35.0-py311-cu121

      Copy to Clipboard Toggle word wrap

      FROM quay.io/modh/training:py311-rocm62-torch241

      Copy to Clipboard Toggle word wrap

   2. 追加パッケージをインストールするには、RUN 命令を使用します。各コメント行の先頭に番号記号 (#) を付けることで、Dockerfile にコメントを追加することもできます。

      次の例は、Python PyTorch パッケージの特定バージョンをインストールする方法を示しています。

      # Install PyTorch
      RUN python3 -m pip install torch==2.4.0

      Copy to Clipboard Toggle word wrap

4. イメージファイルをビルドします。イメージの参照と管理を容易にするために、podman build コマンドで -t オプションを使用して、カスタムイメージ名とバージョンを指定するイメージタグを作成します。

   podman build -t <custom-image-name>:_<version>_ -f Dockerfile

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

   podman build -t ${IMG}:0.0.1 -f Dockerfile

   Copy to Clipboard Toggle word wrap

   ビルド出力は、ビルドプロセスが完了したことを示します。

5. イメージのリストを表示します。

   podman images

   Copy to Clipboard Toggle word wrap

   新しいイメージが正常に作成された場合、そのイメージはイメージのリストに含まれます。

6. イメージをコンテナーレジストリーにプッシュします。

   podman push ${IMG}:0.0.1

   Copy to Clipboard Toggle word wrap
7. オプション: 統合 OpenShift イメージレジストリーにイメージをプッシュする の説明に従って、新しいイメージを他のユーザーが利用できるようにします。

手順

1. ターミナルウィンドウで、次の例に示すように OpenShift CLI にログインします。

   $ oc login <openshift_cluster_url> -u <admin_username> -p <password>

   Copy to Clipboard Toggle word wrap

2. IMG 環境変数をイメージの名前に設定します。このセクションのコマンド例では、my_training_image はイメージの名前です。

   export IMG=my_training_image

   Copy to Clipboard Toggle word wrap

3. 統合イメージレジストリーにログインします。

   podman login -u $(oc whoami) -p $(oc whoami -t) $(oc registry info)

   Copy to Clipboard Toggle word wrap

4. 統合イメージレジストリーのイメージにタグを付けます。

   podman tag ${IMG} $(oc registry info)/$(oc project -q)/${IMG}

   Copy to Clipboard Toggle word wrap

5. イメージを統合イメージレジストリーにプッシュします。

   podman push $(oc registry info)/$(oc project -q)/${IMG}

   Copy to Clipboard Toggle word wrap

6. 必要なタグのイメージリポジトリーの場所を取得します。

   oc get is ${IMG} -o jsonpath='{.status.tags[?(@.tag=="<TAG>")].items[0].dockerImageReference}'

   Copy to Clipboard Toggle word wrap

   ユーザーは、取得したイメージの場所の値を Ray クラスターまたはトレーニングジョブの image パラメーターに指定することでイメージを使用できます。