2.2. 独自のイメージからカスタムイメージを作成する

dnf update コマンドは使用しないようにしてください。

以下のように、ファイルとフォルダーの所有権を 1001:0 (ユーザー "default"、グループ "0") に設定します。

COPY --chown=1001:0 os-packages.txt ./

OpenShift では、(セキュリティーを変更しない限り) すべてのコンテナーは標準の namespace にあります。コンテナーは、ランダムなユーザー ID (uid) とグループ ID (gid) が 0 のユーザーで実行されます。したがって、イメージ内の書き込み先のすべてのフォルダーと (一時的に) 変更するすべてのファイルは、ランダムユーザー ID (uid) を持つユーザーがアクセスできる必要があります。または、次の例に示すように、任意のユーザーにアクセスを設定することもできます。

COPY --chmod=775 os-packages.txt ./

永続化するデータのデフォルトの場所として /opt/app-root/src を使用してイメージをビルドします。次に例を示します。

WORKDIR /opt/app-root/src

ユーザーが OpenShift AI Applications Enabled ページからワークベンチを起動すると、ユーザーの "個人" のボリュームが /opt/app-root/src にマウントされます。この場所は設定できないため、カスタムイメージをビルドするときに、永続化データのこのデフォルトの場所を指定する必要があります。

OpenShift 環境で PIP (Python パッケージのパッケージマネージャー) をサポートするための権限を修正します。次のコマンドをカスタムイメージに追加します (必要に応じて、python3.9 を使用している Python バージョンに変更します)。

chmod -R g+w /opt/app-root/lib/python3.9/site-packages && \
   fix-permissions /opt/app-root -P

ワークベンチイメージ内のサービスは ${NB_PREFIX}/api で応答する必要があります。そうでない場合、OpenShift の liveness/readiness プローブは失敗し、ワークベンチイメージの Pod が削除されます。

NB_PREFIX 環境変数は、コンテナーがリッスンすると予想される URL パスを指定します。

以下は、Nginx 設定の例です。

location = ${NB_PREFIX}/api {
	return 302  /healthz;
	access_log  off;
}

アイドルカリングが機能するには、次の例に示すように、${NB_PREFIX}/api/kernels URL が特定の形式の JSON ペイロードを返す必要があります。

以下は、Nginx 設定の例です。

location = ${NB_PREFIX}/api/kernels {
	return 302 $custom_scheme://$http_host/api/kernels/;
	access_log  off;
}

location ${NB_PREFIX}/api/kernels/ {
	return 302 $custom_scheme://$http_host/api/kernels/;
	access_log  off;
}

location /api/kernels/ {
  index access.cgi;
  fastcgi_index access.cgi;
  gzip  off;
  access_log	off;
 }

返される JSON ペイロードは次のようになります。

{"id":"rstudio","name":"rstudio","last_activity":(time in ISO8601 format),"execution_state":"busy","connections": 1}

Data Science pipeline V2 のサポートを受けるには、以下のように、odh-elyra パッケージ (elyra パッケージではありません) を含めます。

 USER 1001

 RUN pip install odh-elyra