カスタムイメージの仕様 - Amazon SageMaker AI

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

カスタムイメージの仕様

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

イメージを実行する

ContainerConfig を更新することで、以下を設定できます。例については、コンテナ設定を更新するを参照してください。

  • Entrypoint – ランタイムでコンテナに渡される ContainerEntrypointContainerArguments を設定できます。エントリポイントの設定には、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

ユーザーとファイルシステムの仕様

  • 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

ヘルスチェックと URL は、アプリケーションによって異なります。イメージを構築しているアプリケーションに関連付けられている次のリンクを選択します。

Dockerfile サンプル

このページの要件と特定のアプリケーションのニーズの両方を満たす Dockerfile サンプルについては、各アプリケーションの セクションにあるサンプル Dockerfile にアクセスしてください。以下のオプションには、Amazon SageMaker Studio アプリケーションが含まれます。

注記

独自のイメージを SageMaker Unified Studio に取り込む (BYOI) 場合は、「Amazon SageMaker Unified Studio ユーザーガイド」の「Dockerfile 仕様」に従う必要があります。

SageMaker Unified Studio の Dockerfile の例については、「Amazon SageMaker Unified Studio ユーザーガイド」の「Dockerfile の例」を参照してください。