Especificações de imagem personalizadas - SageMaker IA da Amazon
Executando a imagemEspecificações para o usuário e o sistema de arquivosVerificação de integridade e URL de aplicaçõesExemplos de Dockerfile

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Especificações de imagem personalizadas

A imagem que você especifica no Dockerfile deve atender as especificações nas seções a seguir para criar a imagem com sucesso.

Executando a imagem

As configurações a seguir podem ser feitas atualizando seu ContainerConfig. Para obter um exemplo, consulte Atualizar a configuração do contêiner.

  • Entrypoint— Você pode configurar ContainerEntrypoint e ContainerArguments que são passados para o contêiner em tempo de execução. Recomendamos configurar seu ponto de entrada usando o. ContainerConfig Veja o link acima para ver um exemplo.

  • EnvVariables— Ao usar o Studio, você pode definir ContainerEnvironment variáveis personalizadas para seu contêiner. Opcionalmente, você pode atualizar suas variáveis ambientais usandoContainerConfig. Veja o link acima para ver um exemplo.

    SageMaker As variáveis de ambiente específicas da IA têm precedência e substituirão todas as variáveis com os mesmos nomes. Por exemplo, a SageMaker IA fornece automaticamente variáveis de ambiente prefixadas com AWS_ e SAGEMAKER_ para garantir a integração adequada com AWS os serviços e a funcionalidade da SageMaker IA. Veja a seguir alguns exemplos de variáveis de ambiente SageMaker específicas de IA:

    • AWS_ACCOUNT_ID

    • AWS_REGION

    • AWS_DEFAULT_REGION

    • AWS_CONTAINER_CREDENTIALS_RELATIVE_URI

    • SAGEMAKER_SPACE_NAME

    • SAGEMAKER_APP_TYPE

Especificações para o usuário e o sistema de arquivos

  • WorkingDirectory: O volume do Amazon EBS do seu espaço está montado no caminho /home/sagemaker-user. Não é possível mudar o caminho de montagem. Use a instrução WORKDIR para definir o diretório de trabalho da sua imagem como uma pasta em /home/sagemaker-user.

  • UID: O ID do usuário do contêiner do Docker. UID=1000 é um valor compatível. É possível adicionar acesso sudo aos seus usuários. Eles IDs são remapeados para evitar que um processo em execução no contêiner tenha mais privilégios do que o necessário.

  • GID: O ID do grupo do contêiner do Docker. GID=100 é um valor compatível. É possível adicionar acesso sudo aos seus usuários. Eles IDs são remapeados para evitar que um processo em execução no contêiner tenha mais privilégios do que o necessário.

  • Diretórios de metadados — Os /opt/ml diretórios /opt/.sagemakerinternal e usados pelo. AWS O arquivo de metadados em /opt/ml contém metadados sobre recursos como DomainId.

    Use o seguinte comando para mostrar o conteúdo do sistema de arquivos:

    cat /opt/ml/metadata/resource-metadata.json

  • Diretórios de registro — /var/log/studio são reservados para os diretórios de registro de seus aplicativos e as extensões associadas a eles. Recomendamos que você não use essas pastas para criar sua imagem.

Verificação de integridade e URL de aplicações

A verificação de integridade e o URL dependem dos aplicativos. Escolha o link a seguir associado ao aplicativo para o qual você está criando a imagem.

Exemplos de Dockerfile

Para exemplos de Dockerfile que atendam aos requisitos desta página e às necessidades específicas de seu aplicativo, navegue até os exemplos de Dockerfiles na seção do respectivo aplicativo. As opções a seguir incluem aplicativos do Amazon SageMaker Studio.

nota

Se você estiver trazendo sua própria imagem para o SageMaker Unified Studio, precisará seguir as especificações do Dockerfile no Guia do usuário do Amazon SageMaker Unified Studio.

Dockerfileexemplos do SageMaker Unified Studio podem ser encontrados no exemplo do Dockerfile no Guia do usuário do Amazon SageMaker Unified Studio.