ランタイム・イメージのダウンロード
ランタイム定義ファイルでランタイム・イメージの名前を見つけてから、ダウンロードします。
ランタイム・イメージをダウンロードするには、以下の手順を実行します。
- 構成ファイルで
"image"を検索して、イメージの名前を取得します。jupyter-222n-py-server.json構成ファイルの例:
この場合、[...] "replicas": 1, "image": "cp.icr.io/cp/cpd/wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc", "command": \["/usr/sbin/tini", "--", "/opt/ibm/ws/bin/setup_container.sh"], [...]wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbcはダウンロードする必要があるイメージです。rstudio-r42-server.json構成ファイルの例:
この場合、[...] "replicas": 1, "image": "cp.icr.io/cp/cpd/wslocal-runtime-rstudio-r42@sha256:de79fcbbd21b62d6d5edb4b392b554777c445d9a5d9aee9a4eb26153f788e0a2", "privileged": false, "command": ["/scripts/icp4d/startup.sh"], [...]wslocal-runtime-rstudio-r42@sha256:de79fcbbd21b62d6d5edb4b392b554777c445d9a5d9aee9a4eb26153f788e0a2はダウンロードする必要があるイメージです。
- イメージが配置されている Docker レジストリーの URL を取得します。 IBM® Software
Hub のインストール時に使用したレジストリー URL を使用して、イメージ (例えば、
wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbcイメージ) をプルします。- プライベート・レジストリーを使用している場合は、プライベート・コンテナー・レジストリーの場所を取得します。これは、
PRIVATE_REGISTRY_LOCATION変数に保管されています。 クラスターがインターネットに接続されている場合は、IBM_ENTITLEMENT_KEY変数を使用して、cp.icr.io/cp/cpd登録済みレジストリーから直接イメージをプルできます。IBM 詳しくは、『インストール環境変数のセットアップ』『 』を参照してください。 これらの変数の値は、外部イメージ・レジストリーへの URL です。 - その値を使用して、URLの
<image-registry-url>/<namespace>部分をイメージに変更します。<image-registry-url>/<namespace>/wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc重要: プル、更新 (Dockerfile を使用)、アップロード (新しいカスタム・イメージ名を使用)、および名前変更したランタイム定義ファイルへの追加を行うイメージの名前は、以下の形式でなければなりません。registry/<namespace>/actual_image_name.
- プライベート・レジストリーを使用している場合は、プライベート・コンテナー・レジストリーの場所を取得します。これは、
- イメージをダウンロードします。 ダウンロードするには、Docker、Podman、Skopeo などのコマンド・ライン・ユーティリティーを使用できます。これらのユーティリティーがご使用のサーバーまたはワークステーションにインストールされている必要があります。 イメージをダウンロードするためにレジストリーにログインするには、有効な IBM Software
Hub ユーザー名とパスワード、および管理者権限が必要です。 以下のコマンドの
<image-registry-url>には、前のステップで見つけた URLを使用します。Docker または Podman の場合:- ユーティリティーにログインします。 次のコード・スニペットは Docker を使用する場合を示しています。 Podman のログイン構文は、コマンド名以外は同じです。
docker login -u cp -p ${IBM_ENTITLEMENT_KEY} cp.icr.io - イメージ (例えば、環境テンプレート JSON ファイル
jupyter-222n-py-server.jsonからのwslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbcイメージ) をダウンロードします。 コード・スニペットは Docker を使用する場合を示しています。 Podman のコマンド構文は同じです。docker pull <image-registry-url>/<namespace>/wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc
Skopeo の場合:
Skopeo では別個のログイン・コマンドは必要ありません。 Skopeoを使用する場合は、レジストリーから直接イメージをダウンロードできます。 ただし、イメージのダウンロード先は、カスタム・パッケージの作成に Buildah とともに Docker と Podman のどちらを使用するかによって異なります。
イメージをダウンロードして Docker ビルドを有効にします。skopeo copy –src-creds <username>:<password> docker://<image-registry-url>/<namespace>/wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc docker-daemon:wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbcまたは、Podman/Buildahビルド:skopeo copy –src-creds <username>:<password> docker://<image-registry-url>/<namespace>/wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc containers-storage:wslocal-runtime-py310main@sha256:491c86cb5604a1fe0816a5a7a59a52acf14bdf8eae11d136d4a018dc030d8bbc - ユーティリティーにログインします。 次のコード・スニペットは Docker を使用する場合を示しています。 Podman のログイン構文は、コマンド名以外は同じです。