Conceitos básicos do modo local

As seções a seguir descrevem as etapas necessárias para começar a usar o modo local no Amazon SageMaker Studio, incluindo:

• Como concluir os pré-requisitos

• Configurar EnableDockerAccess

• Docker instalação

Pré-requisitos

Preencha os seguintes pré-requisitos para usar o modo local nas aplicações do Studio:

• Para extrair imagens de um repositório do Amazon Elastic Container Registry, a conta que hospeda a imagem do Amazon ECR deve fornecer permissão de acesso para a função de execução do usuário. A função de execução do domínio também deve permitir o acesso ao Amazon ECR.

• Verifique se você está usando a versão mais recente do SDK do Studio Python usando o seguinte comando: 

  pip install -U sagemaker

• Para usar o modo local e Docker capacidades, defina o seguinte parâmetro do domínio DockerSettings usando o AWS Command Line Interface (AWS CLI): 

  EnableDockerAccess : ENABLED

• UsandoEnableDockerAccess, você também pode controlar se os usuários no domínio podem usar o modo local. Por padrão, o modo local e Docker os recursos não são permitidos nos aplicativos do Studio. Para obter mais informações, consulte Configurar EnableDockerAccess.

• Instale o   Docker CLI no aplicativo Studio seguindo as etapas em. Docker instalação

Configurar EnableDockerAccess

As seções a seguir mostram como definir EnableDockerAccess quando o domínio tem acesso público à internet ou está no modo VPC-only.

nota

As alterações serão aplicadas ao EnableDockerAccess apenas nas aplicações criadas após a atualização do domínio. Crie uma aplicação depois de atualizar o domínio.

Acesso público à internet

Os seguintes comandos de exemplo mostram como configurar o EnableDockerAccess ao criar um novo domínio ou atualizar um domínio existente com acesso público à Internet:

# create new domain
aws --region region \
    sagemaker create-domain --domain-name domain-name \
    --vpc-id vpc-id \
    --subnet-ids subnet-ids \
    --auth-mode IAM \
    --default-user-settings "ExecutionRole=execution-role" \
    --domain-settings '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}' \
    --query DomainArn \
    --output text

# update domain
aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED"}}'

Modo VPC-only

Ao usar um domínio no VPC-only modo, Docker as solicitações push e pull de imagem são roteadas pela VPC de serviço em vez da VPC configurada pelo cliente. Por causa dessa funcionalidade, os administradores podem configurar uma lista de informações confiáveis Contas da AWS que os usuários podem criar no Amazon ECR Docker solicitações de operações de pull e push para.

Em caso de Docker A solicitação push ou pull de imagem é feita para uma pessoa Conta da AWS que não está na lista de confiáveis Contas da AWS; a solicitação falha. Docker As operações pull and push fora do Amazon Elastic Container Registry (Amazon ECR) não são suportadas VPC-only no modo.

Por padrão, os itens a seguir Contas da AWS são confiáveis:

• A conta que hospeda o domínio SageMaker AI.

• SageMaker Contas de IA que hospedam as seguintes imagens de SageMaker IA:

  • Imagens da estrutura DLC

  • Sklearn, Spark, XGBoost processando imagens

Para configurar uma lista de outros confiáveis Contas da AWS, especifique o VpcOnlyTrustedAccounts valor da seguinte forma:

aws --region region \
    sagemaker update-domain --domain-id domain-id \
    --domain-settings-for-update '{"DockerSettings": {"EnableDockerAccess": "ENABLED", "VpcOnlyTrustedAccounts": ["account-list"]}}'

Docker instalação

Para usar Docker, você deve instalar manualmente Docker do terminal do seu aplicativo Studio. As etapas para instalar Docker são diferentes se o domínio tem acesso à internet ou não.

Acesso à Internet

Se o domínio for criado com acesso público à Internet ou no VPC-only modo com acesso limitado à Internet, use as etapas a seguir para instalar Docker.

1. (Opcional) Se seu domínio for criado no VPC-only modo com acesso limitado à Internet, crie um gateway NAT público com acesso ao Docker site. Para ter instruções, consulte Gateways NAT.

2. Navegue até o terminal do aplicativo Studio que você deseja instalar Docker em.

3. Para retornar o sistema operacional da aplicação, execute o seguinte comando no terminal:

   cat /etc/os-release

4. Instalar Docker seguindo as instruções para o sistema operacional do aplicativo no repositório Amazon SageMaker AI Local Mode Examples.

   Por exemplo, instale Docker ativado Ubuntu seguindo o script em https://github.com/aws-samples/amazon-sagemaker-local-mode/blob/main/sagemaker_studio_docker_cli_install/sagemaker- ubuntu-focal-docker-cli -install.sh com as seguintes considerações:

   • Se os comandos encadeados falharem, execute comandos individualmente.

   • O Studio suporta apenas Docker versão 20.10.X. e Docker Engine Versão da API1.41.

   • Os pacotes a seguir não são obrigatórios para usar o Docker A CLI no Studio e sua instalação podem ser ignoradas:

     • containerd.io

     • docker-ce

     • docker-buildx-plugin

   nota

   Você não precisa iniciar o Docker serviço em seus aplicativos. A instância que hospeda o aplicativo Studio é executada Docker serviço por padrão. Todos Docker As chamadas de API são roteadas por meio do Docker serviço automaticamente.

5. Use o exposto Docker soquete para Docker interações nos aplicativos do Studio. Por padrão, o seguinte soquete é exposto:

   unix:///docker/proxy.sock

   A seguinte variável de ambiente da aplicação do Studio para o USER padrão usa esse soquete exposto:

   DOCKER_HOST

Sem acesso à internet

Se o domínio for criado no VPC-only modo sem acesso à Internet, use as etapas a seguir para instalar Docker.

1. Navegue até o terminal do aplicativo Studio que você deseja instalar Docker em.

2. Execute o seguinte comando no terminal para retornar o sistema operacional da aplicação:

   cat /etc/os-release

3. Baixe o necessário Docker .debarquivos para sua máquina local. Para instruções sobre como baixar os arquivos necessários para o sistema operacional da aplicação do Studio, consulte Instalar o Docker Engine.

   Por exemplo, instale Docker de um pacote no Ubuntu seguindo as etapas de 1 a 4 em Instalar a partir de um pacote com as seguintes considerações:

   • Instalar Docker de um pacote. O uso de outros métodos para instalar o Docker não funcionará.

   • Instale os pacotes mais recentes correspondentes a Docker versão20.10.X.

   • Os pacotes a seguir não são obrigatórios para usar o Docker CLI no Studio. Não é necessário instalar:

     • containerd.io

     • docker-ce

     • docker-buildx-plugin

   nota

   Você não precisa iniciar o Docker serviço em seus aplicativos. A instância que hospeda o aplicativo Studio é executada Docker serviço por padrão. Todos Docker As chamadas de API são roteadas por meio do Docker serviço automaticamente.

4. Carregue os arquivos .deb no sistema de arquivos do Amazon EFS ou no sistema de arquivos do Amazon EBS da aplicação.

5. Instale manualmente os pacotes .deb docker-ce-cli e docker-compose-plugin por meio do terminal da aplicação do Studio. Para obter mais informações e instruções, consulte a etapa 5 em Instalar a partir de um pacote no Docker site de documentos.

6. Use o exposto Docker soquete para Docker interações nos aplicativos do Studio. Por padrão, o seguinte soquete é exposto:

   unix:///docker/proxy.sock

   A seguinte variável de ambiente da aplicação do Studio para o USER padrão usa esse soquete exposto:

   DOCKER_HOST