翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムイメージの仕様
<a name="studio-updated-byoi-specs"></a>

イメージを正常に作成するには、Dockerfile で指定するイメージが以下のセクションの仕様と一致している必要があります。

**Topics**
+ [イメージを実行する](#studio-updated-byoi-specs-run)
+ [ユーザーとファイルシステムの仕様](#studio-updated-byoi-specs-user-and-filesystem)
+ [アプリケーションのヘルスチェックと URL](#studio-updated-byoi-specs-app-healthcheck)
+ [Dockerfile サンプル](#studio-updated-byoi-specs-dockerfile-templates)

## イメージを実行する
<a name="studio-updated-byoi-specs-run"></a>

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html) を更新することで、以下を設定できます。例については、[コンテナ設定を更新する](studio-updated-byoi-how-to-container-configuration.md)を参照してください。
+ `Entrypoint` – ランタイムでコンテナに渡される `ContainerEntrypoint` と `ContainerArguments` を設定できます。エントリポイントの設定には、`ContainerConfig` の使用をお勧めします。例については、上記のリンクを参照してください。
+ `EnvVariables` – Studio を使用する場合、コンテナに `ContainerEnvironment` カスタム変数を定義できます。必要に応じて、`ContainerConfig` を使用して、環境変数を更新することもできます。例については、上記のリンクを参照してください。

  SageMaker AI 固有の環境変数が優先され、同じ名前の変数は上書きされます。例えば、SageMaker AI は、 AWS サービスと SageMaker AI 機能との適切な統合を確保するために、`AWS_` および `SAGEMAKER_` で始まる環境変数を自動的に提供します。以下は、SageMaker AI 固有の環境変数の例です。
  + `AWS_ACCOUNT_ID`
  + `AWS_REGION`
  + `AWS_DEFAULT_REGION`
  + `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`
  + `SAGEMAKER_SPACE_NAME`
  + `SAGEMAKER_APP_TYPE`

## ユーザーとファイルシステムの仕様
<a name="studio-updated-byoi-specs-user-and-filesystem"></a>
+ `WorkingDirectory` – スペースの Amazon EBS ボリュームはパス `/home/sagemaker-user` にマウントされます。マウントパスを変更することはできません。`WORKDIR` 命令を使用して、イメージの作業ディレクトリを `/home/sagemaker-user` 内のフォルダに設定します。
+ `UID` – Docker コンテナのユーザー ID。UID=1000 はサポートされている値です。sudo アクセス権をユーザーに追加できます。ID は再マッピングされ、コンテナで実行されるプロセスに必要以上の権限は付与されません。
+ `GID` – Docker コンテナのグループ ID。GID=100 はサポートされている値です。sudo アクセス権をユーザーに追加できます。ID は再マッピングされ、コンテナで実行されるプロセスに必要以上の権限は付与されません。
+ メタデータディレクトリ – が使用する `/opt/.sagemakerinternal`および `/opt/ml` ディレクトリ AWS。`/opt/ml` のメタデータファイルには、`DomainId` などのリソースに関するメタデータが含まれています。

  次のコマンドを使用してファイルシステムの内容を表示します。

  ```
  cat /opt/ml/metadata/resource-metadata.json
  ```
+ ログディレクトリ – `/var/log/studio` は、アプリケーションとアプリケーションに関連する拡張機能のログディレクトリ用に予約されています。これらフォルダは、イメージ作成時に使用しないことをお勧めします。

## アプリケーションのヘルスチェックと URL
<a name="studio-updated-byoi-specs-app-healthcheck"></a>

ヘルスチェックと URL は、アプリケーションによって異なります。イメージを構築しているアプリケーションに関連付けられている次のリンクを選択します。
+ Code Editor 向け [アプリケーションのヘルスチェックと URL](code-editor-custom-images.md#code-editor-custom-images-app-healthcheck)
+ JupyterLab 向け [アプリケーションのヘルスチェックと URL](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-admin-guide-custom-images-app-healthcheck)

## Dockerfile サンプル
<a name="studio-updated-byoi-specs-dockerfile-templates"></a>

このページの要件と特定のアプリケーションのニーズの両方を満たす Dockerfile サンプルについては、各アプリケーションの セクションにあるサンプル Dockerfile にアクセスしてください。以下のオプションには、Amazon SageMaker Studio アプリケーションが含まれます。
+ Code Editor 向け [Dockerfile サンプル](code-editor-custom-images.md#code-editor-custom-images-dockerfile-templates)
+ JupyterLab 向け [Dockerfile サンプル](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-custom-images-dockerfile-templates)

**注記**  
独自のイメージを SageMaker Unified Studio に取り込む (BYOI) 場合は、「*Amazon SageMaker Unified Studio ユーザーガイド*」の「[Dockerfile 仕様](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html)」に従う必要があります。  
SageMaker Unified Studio の `Dockerfile` の例については、「*Amazon SageMaker Unified Studio ユーザーガイド*」の「[Dockerfile の例](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example)」を参照してください。