自訂映像規格 - Amazon SageMaker AI
執行映像使用者和檔案系統的規格應用程式的運作狀態檢查和 URLDockerfile 範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

自訂映像規格

您在 Dockerfile 中指定的映像必須符合以下各節中的規格，才能成功建立映像。

執行映像

您可以透過更新 ContainerConfig 來進行下列組態。如需範例，請參閱 更新容器組態。

  • Entrypoint - 您可以設定在執行時期傳遞至容器的 ContainerEntrypoint 和 ContainerArguments。建議您使用 ContainerConfig 設定進入點。如需範例，請參閱上述連結。

  • EnvVariables - 使用 Studio 時，您可以定義容器的自訂 ContainerEnvironment 變數。您可以選擇性地使用 ContainerConfig 更新環境變數。如需範例，請參閱上述連結。

    SageMaker AI 特定環境變數優先使用，並會覆寫名稱相同的任何變數。例如，SageMaker AI 會自動提供字首為 AWS_ 和 SAGEMAKER_ 的環境變數，以確保與服務 AWS 和 SageMaker AI 功能適當整合。以下是幾個範例 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，則需要遵循《Amazon SageMaker Unified Studio 使用者指南》中的 Dockerfile 規格。

您可以在《Amazon SageMaker Unified Studio 使用者指南》的 Dockerfile 範例中找到 SageMaker Unified Studio 的 Dockerfile 範例。