Lindorm:カスタムイメージで Ray ジョブを実行

前提条件

作業を開始する前に、以下の前提条件を満たしていることを確認してください。

• Lindorm Compute Engine を有効化済みであること。手順については、「Activate Service」をご参照ください。

• Lindorm インスタンスと同じリージョンに Container Registry (ACR) インスタンスがあること。作成方法については、「Create an Enterprise Edition instance」をご参照ください。

注意事項

カスタムイメージを使用する際は、システムの安定性と互換性を確保するために、以下のルールに従ってください。

• Dockerfile 内で、以下のディレクトリまたはそのサブディレクトリ内のファイルを変更しないでください。

  • /tmp/ray/

  • /opt/

  • Ray のインストールディレクトリ。たとえば、Python 3.11 の場合、パスは /home/ray/anaconda3/lib/python3.11/site-packages/ray/ です。

• カスタムイメージは、Lindorm インスタンスと同じリージョンにある ACR リポジトリにプッシュする必要があります。そうでない場合、Lindorm はイメージをプルできません。

コアワークフロー

カスタムイメージの使用には、以下の 4 つの主要ステップがあります。

1. 準備とビルド：公式 Lindorm Ray パブリックイメージをベースとして Dockerfile を記述し、カスタムイメージをビルドします。

2. イメージのプッシュ：ビルドしたイメージを Alibaba Cloud ACR リポジトリにプッシュします。

3. アクセス権限の付与：Lindorm コンソールで、サービスがご利用の ACR リポジトリにアクセスできるように権限を付与します。この操作は一度だけ実施すれば十分です。

4. 構成と使用：Ray リソースグループを作成する際に、[詳細設定] セクションでカスタムイメージを指定します。

ステップ 1：カスタムイメージの準備とビルド

FROM lindorm-compute-public-registry.cn-hangzhou.cr.aliyuncs.com/lindorm-ray/ray:2.50.1-1.1.1-py311-cpu

RUN pip install --no-cache-dir numpy pandas

docker build -t your-image-name:tag .

ステップ 2：イメージを ACR にプッシュ

ビルドが完了したら、ローカルイメージを ACR リポジトリにプッシュします。

docker login --username=<your-username> <your-registry>

docker tag your-image-name:tag <your-registry>/<namespace>/<repo>:tag
docker push <your-registry>/<namespace>/<repo>:tag

ステップ 3：Lindorm に ACR アクセス権を付与

Ray リソースグループ作成ページで、Lindorm サービスがご利用の ACR イメージリポジトリにアクセスできるように権限を付与します。

1. 「ACR カスタムイメージへのパスワード不要アクセス」をクリックします。

2. 権限付与ダイアログボックスで、権限付与を確定します。

ステップ 4：カスタムイメージの使用

権限付与後、Ray リソースグループを作成する際に、[詳細設定] セクションに以下の JSON 構成を入力してカスタムイメージを指定します。

{ 
"clusterConfig.image.custom.acr.instanceId":"your-acr-instanceId",
"clusterConfig.image":"your-full-image-addr"
}

構成パラメーター：

構成が完了したら、カスタムイメージを使用する Ray リソースグループを作成できます。