本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
自訂映像
如果您需要與 SageMaker 分佈提供的功能不同,您可以使用自訂擴充功能和套件來攜帶自己的映像。您也可以使用它來個人化程式碼編輯器 UI,以滿足您自己的品牌或合規需求。
以下頁面將提供程式碼編輯器特定的資訊和範本,以建立您自己的自訂 SageMaker AI 映像。這是為了補充 Amazon SageMaker Studio 的資訊和指示,以建立您自己的 SageMaker AI 映像並將您自己的映像帶到 Studio。若要了解自訂 Amazon SageMaker AI 映像,以及如何將您自己的映像帶到 Studio,請參閱 使用您自己的映像 (BYOI)。
應用程式的運作狀態檢查和 URL
-
Base URL
– BYOI 應用程式的基本 URL 必須為 CodeEditor/default
。您只能有一個應用程式,且必須一律命名為 default
。
-
運作狀態檢查端點 – 您必須將程式碼編輯器伺服器託管在 0.0.0.0 連接埠 8888,SageMaker AI 才能偵測它。
-
身分驗證 – 您必須在開啟--without-connection-token
時通過sagemaker-code-editor
,以允許 SageMaker AI 驗證您的使用者。
如果您使用 Amazon SageMaker Distribution 作為基礎映像,這些要求已在包含的entrypoint-code-editor
指令碼中處理。
Dockerfile 範例
下列範例是Dockerfile
符合上述資訊的 和 自訂映像規格。
如果您要將自己的映像帶到 SageMaker Unified Studio,則需要遵循 Amazon SageMaker Unified Studio 使用者指南中的 Dockerfile 規格。
Dockerfile
您可以在 Amazon SageMaker Unified Studio 使用者指南的 Dockerfile 範例中找到 SageMaker Unified Studio 的範例。 Amazon SageMaker
- Example micromamba Dockerfile
-
以下是使用micromamba
基本環境從頭開始建立映像的範例 Dockerfile:
FROM mambaorg/micromamba:latest
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
USER root
RUN micromamba install -y --name base -c conda-forge sagemaker-code-editor
USER $NB_UID
CMD eval "$(micromamba shell hook --shell=bash)"; \
micromamba activate base; \
sagemaker-code-editor --host 0.0.0.0 --port 8888 \
--without-connection-token \
--base-path "/CodeEditor/default"
- Example SageMaker AI Distribution Dockerfile
-
以下是根據 Amazon SageMaker AI Distribution 建立映像的範例 Dockerfile:
FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
ENV MAMBA_USER=$NB_USER
USER root
# install scrapy in the base environment
RUN micromamba install -y --name base -c conda-forge scrapy
# download VSCodeVim
RUN \
wget https://github.com/VSCodeVim/Vim/releases/download/v1.27.2/vim-1.27.2.vsix \
-P /tmp/exts/ --no-check-certificate
# Install the extension
RUN \
extensionloc=/opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions \
&& sagemaker-code-editor \
--install-extension "/tmp/exts/vim-1.27.2.vsix" \
--extensions-dir "${extensionloc}"
USER $MAMBA_USER
ENTRYPOINT ["entrypoint-code-editor"]