第2章 カスタムワークベンチイメージの作成

手順

1. カスタムイメージのベースとして使用するデフォルトのイメージの場所を取得します。

   1. OpenShift コンソールで、Builds ImageStreams を選択します。
   2. redhat-ods-applications プロジェクトを選択します。
   3. インストールされているイメージストリームのリストから、カスタムイメージのベースとして使用するイメージの名前をクリックします。たとえば、pytorch をクリックします。
   4. ImageStream details ページで、YAML をクリックします。

   5. spec:tags セクションで、使用するイメージのバージョンのタグを見つけます。

      元のイメージの場所は、以下のように、タグの from:name セクションに表示されます。

      name: 'quay.io/modh/odh-pytorch-notebook@sha256:b68e0192abf7d…'

   6. カスタムイメージで使用するためにこの場所をコピーします。
2. 標準の Containerfile または Dockerfile を作成します。

3. FROM 命令では、以下のように、ステップ 1 でコピーしたベースイメージの場所を指定します。

   FROM quay.io/modh/odh-pytorch-notebook@sha256:b68e0…

4. 必要に応じて、OS イメージをインストールします。

   1. USER 0 に切り替えます (OS パッケージをインストールするには USER 0 が必要です)。
   2. パッケージをインストールします。

   3. USER 1001 に切り替えます。

      次の例では、デフォルトの PyTorch イメージに Java を追加するカスタムワークベンチイメージを作成します。

       FROM quay.io/modh/odh-pytorch-notebook@sha256:b68e0…
      
       USER 0
      
       RUN INSTALL_PKGS="java-11-openjdk java-11-openjdk-devel" && \
          dnf install -y --setopt=tsflags=nodocs $INSTALL_PKGS && \
          dnf -y clean all --enablerepo=*
      
       USER 1001

5. 必要に応じて Python パッケージを追加します。

   1. USER 1001 を指定します。
   2. requirements.txt ファイルをコピーします。

   3. パッケージをインストールします。

      次の例では、デフォルトの PyTorch イメージの requirements.txt ファイルからパッケージをインストールします。

       FROM quay.io/modh/odh-pytorch-notebook@sha256:b68e0…
      
       USER 1001
      
       COPY requirements.txt ./requirements.txt
      
       RUN pip install -r requirements.txt

6. イメージファイルをビルドします。たとえば、イメージファイルが配置されているローカルで podman build を使用し、OpenShift AI がアクセスできるレジストリーにイメージをプッシュできます。

   $ podman build -t my-registry/my-custom-image:0.0.1 .
   $ podman push my-registry/my-custom-image:0.0.1

   または、BuildConfig を使用して OpenShift のイメージビルド機能を活用することもできます。