Platform For AI:DSW で Docker を使用

グラフィカルユーザーインターフェースでセカンダリコンテナを起動するには、「Manage Sub-containers with DockerBoard」をご参照ください。

制限事項

• セカンダリコンテナ機能は、Lingjun リソースグループ、またはバージョン 1.0 の汎用リソースグループから作成した DSW インスタンスでのみ利用できます。

• DSW インスタンスのセカンダリコンテナでは、Docker デーモン設定 (/etc/docker/daemon.json) を現在変更できません。これは、data-root や registry-mirrors などの設定オプションをカスタマイズできないことを意味します。

• インスタンスを再起動すると、クラウドディスク機能が有効であっても、ビルド済みイメージを含むセカンダリコンテナ内のすべての実行時データが削除されます。データ損失を防ぐため、重要な環境とデータは定期的に保存することを推奨します。

• セカンダリコンテナの起動時に、昇格された特権を付与する、またはセキュリティリスクとなるパラメータは使用できません。次の表に、一般的な制限対象パラメータの一部を示します：

  パラメータ	説明
  --privileged	コンテナにホストマシンのほぼすべての権限を付与します。
  --ipc=host	ホストの IPC 名前空間をコンテナと共有します。
  --security-opt	コンテナのセキュリティポリシーを回避または変更できるようにします。
  --cap-add	Linux カーネルケーパビリティをコンテナに追加し、権限の範囲を拡張します。

  説明

  docker run または docker create を使用してセカンダリコンテナを作成する際に、次のエラーメッセージ Error response from daemon: authorization denied by plugin authZ: Permission denied が表示された場合、制限されたパラメーターが使用されたことを示します。

DSW インスタンスの作成と設定

DSW インスタンスを作成する際は、次の主要パラメータを設定します。

• [Resource Type]: Resource Quota を選択します。

• [Resource Quota]: 作成した Lingjun リソースクォータを選択します。 詳細については、「新しいリソースグループを作成し、Lingjun コンピューティングリソースを購入する」をご参照ください。

• [Enable Multi-Container Isolation (DinD)]：このスイッチをオンにします。

OK をクリックしてインスタンスを作成します。 次のステップについては、「セカンダリコンテナの使用」をご参照ください。

セカンダリコンテナの操作

docker run -it dsw-registry.cn-hangzhou.cr.aliyuncs.com/pai/pytorch:1.8PAI-gpu-py36-cu101-ubuntu18.04 /bin/bash

# この例では、<path_in_dsw> は /mnt/data0、/mnt/data1、またはそれらのサブパスにすることができます。
# それ以外のパスは、現時点ではセカンダリコンテナにマウントできません。

# -v パラメータを使用
docker run -v <path_in_dsw>:<path_in_secondary_container>[:options] {image}

# --mount パラメータを使用
docker run  --mount type=bind,source=<path_in_dsw>,target=<path_in_secondary_container>[,readonly] {image}

docker exec -it your-container /bin/bash

docker attach {container_id}

イメージのビルド

DSW インスタンスでは、Dockerfile を使用してイメージをビルドできます。次のコマンドを実行します：

docker build -t test-build .

ビルドが完了したら、次のコマンドを実行して新しく作成したイメージを確認します：

root@dsw-330808-8445dd65f4-mhnrt:/mnt/workspace/test# docker image ls
REPOSITORY          TAG         IMAGE ID       CREATED              SIZE
test-build          latest      fad7fdb5e81a   About a minute ago   15.4GB

イメージのプル

たとえば、ACR からパブリックイメージをプルするには、次のコマンドを実行します：

docker pull dsw-registry.cn-hangzhou.cr.aliyuncs.com/pai/pytorch:1.8PAI-gpu-py36-cu101-ubuntu18.04

プライベートリポジトリからイメージをプルするには、最初に docker login コマンドでログインします：

docker login --username={username} registry.cn-hangzhou.aliyuncs.com

よくある質問

root@dsw-381955:/mnt/workspace# docker run --network=host -it ubuntu /bin/bash
Unable to find image 'ubuntu:latest' locally
docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded.
See 'docker run --help'.

export DOCKER_HOST=unix:///var/docker/proxy/docker-proxy.sock