Crie uma imagem de SageMaker IA personalizada - SageMaker IA da Amazon

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á.

Crie uma imagem de SageMaker IA personalizada

Importante

Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte Forneça permissões para marcar recursos de SageMaker IA.

AWS políticas gerenciadas para Amazon SageMaker AIque dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

Importante

Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica ao uso da aplicação Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte SageMaker Estúdio Amazon.

Este tópico descreve como você pode criar uma imagem de SageMaker IA personalizada usando o console de SageMaker IA ou AWS CLI.

Quando você cria uma imagem no console, a SageMaker IA também cria uma versão inicial da imagem. A versão da imagem representa uma imagem de contêiner no Registro de contêiner Amazon Elastic Container Registry (ECR). A imagem do contêiner deve atender aos requisitos para ser usada no Amazon SageMaker Studio Classic. Para obter mais informações, consulte Especificações de imagem de SageMaker IA personalizadas. Para obter informações sobre como testar sua imagem localmente e resolver problemas comuns, consulte o repositório SageMaker Studio Classic Custom Image Samples.

Depois de criar sua imagem de SageMaker IA personalizada, você deve anexá-la ao seu domínio ou espaço compartilhado para usá-la com o Studio Classic. Para obter mais informações, consulte Anexe uma imagem de SageMaker IA personalizada.

Crie uma imagem de SageMaker IA a partir do console

A seção a seguir demonstra como criar uma imagem de SageMaker IA personalizada a partir do console de SageMaker IA.

Criar uma imagem
  1. Abra o console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/.

  2. No painel de navegação à esquerda, escolha Configurações do administrador.

  3. Em Configurações do administrador, escolha Imagens.

  4. Na página Imagens personalizadas, escolha Criar imagem.

  5. Em Fonte da imagem, insira o caminho do registro para a imagem de contêiner no Amazon ECR. O caminho é tem o seguinte formato:

    acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest]

  6. Escolha Próximo.

  7. Em Propriedades da imagem, insira o seguinte:

    • Nome da imagem: O nome deve ser exclusivo para a sua conta Região da AWS atual.

    • (Opcional) Nome de exibição: O nome exibido na interface de usuário do Studio Classic. Quando não fornecido, Image name é exibido.

    • (Opcional) Descrição: uma descrição da imagem.

    • Função do IAM — A função deve ter a AmazonSageMakerFullAccesspolítica anexada. Use a lista suspensa para escolher uma das seguintes opções:

      • Criar um novo perfil: Especifique quaisquer buckets adicionais do Amazon Simple Storage Service (Amazon S3) aos quais você deseja que os usuários dos cadernos tenham acesso. Se não quiser permitir acesso a buckets adicionais, escolha Nenhum.

        SageMaker A IA atribui a AmazonSageMakerFullAccess política à função. A função permite que os usuários de seus cadernos tenham acesso aos buckets do S3 listados ao lado das marcas de seleção.

      • Insira um ARN do perfil do IAM personalizado: Insira o nome do recurso da Amazon (ARN) da perfil do IAM.

      • Uso da função existente: Escolha uma das suas funções existentes na lista.

    • (Opcional) Tags de imagem: Escolha Adicionar nova tag. É possível adicionar até 50 tags. As tags podem ser pesquisadas usando a interface de usuário do Studio Classic, o console de SageMaker IA ou a Search API de SageMaker IA.

  8. Escolha Enviar.

A nova imagem é exibida na lista de imagens personalizadas e destacada brevemente. Depois que a imagem for criada com êxito, você poderá escolher o nome da imagem para ver suas propriedades ou escolher Criar versão para criar outra versão.

Para criar outra versão da imagem
  1. Escolha Criar versão na mesma linha da imagem.

  2. Em Fonte da imagem, insira o caminho do registro para a imagem do contêiner no Amazon ECR. A imagem do contêiner não deve ser a mesma usada em uma versão anterior da imagem de SageMaker IA.

Crie uma imagem de SageMaker IA a partir do AWS CLI

Você executa as etapas a seguir para criar uma imagem de SageMaker IA a partir da imagem do contêiner usando AWS CLI o.

  • Crie uma Image.

  • Crie uma ImageVersion.

  • Criar um arquivo de configuração.

  • Crie uma AppImageConfig.

Para criar as entidades de imagem de SageMaker IA
  1. Crie uma imagem de SageMaker IA.

    aws sagemaker create-image \ --image-name custom-image \ --role-arn arn:aws:iam::<acct-id>:role/service-role/<execution-role>

    A resposta deve ser semelhante ao seguinte:

    { "ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/custom-image" }
  2. Crie uma versão de imagem de SageMaker IA a partir da imagem do contêiner.

    aws sagemaker create-image-version \ --image-name custom-image \ --base-image <acct-id>.dkr.ecr.<region>.amazonaws.com/smstudio-custom:custom-image

    A resposta deve ser semelhante ao seguinte:

    { "ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/custom-image/1" }
  3. Verifique se a versão da imagem foi criada com sucesso.

    aws sagemaker describe-image-version \ --image-name custom-image \ --version-number 1

    A resposta deve ser semelhante ao seguinte:

    { "ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/custom-image/1", "ImageVersionStatus": "CREATED" }
    nota

    Se a resposta for "ImageVersionStatus": "CREATED_FAILED", ela também incluirá o motivo da falha. Um problema de permissão é uma causa comum de falha. Você também pode verificar seus CloudWatch registros da Amazon se tiver uma falha ao iniciar ou executar o KernelGateway aplicativo para obter uma imagem personalizada. O nome do grupo de logs é /aws/sagemaker/studio. O nome do fluxo de logs é $domainID/$userProfileName/KernelGateway/$appName.

  4. Crie um arquivo de configuração denominado app-image-config-input.json. O valor Name de KernelSpecs deve corresponder ao nome do KernelSpec disponível na imagem associada a esse AppImageConfig. Esse valor diferencia maiúsculas de minúsculas. Você pode encontrar os KernelSpecs disponíveis em uma imagem executando jupyter-kernelspec list partir de um shell dentro do contêiner. MountPath é o caminho dentro da imagem para montar seu diretório inicial do Amazon Elastic File System (Amazon EFS). Ele precisa ser diferente do caminho que você usa dentro do contêiner porque esse caminho será substituído quando seu diretório inicial do Amazon EFS for montado.

    nota

    Os seguintes valores DefaultUID e DefaultGID as combinações são os únicos valores aceitos:

    • DefaultUID: 1000 e DefaultGID: 100

    • DefaultUID: 0 e DefaultGID: 0

    { "AppImageConfigName": "custom-image-config", "KernelGatewayImageConfig": { "KernelSpecs": [ { "Name": "python3", "DisplayName": "Python 3 (ipykernel)" } ], "FileSystemConfig": { "MountPath": "/home/sagemaker-user", "DefaultUid": 1000, "DefaultGid": 100 } } }
  5. Crie o AppImageConfig usando o arquivo criado na etapa anterior.

    aws sagemaker create-app-image-config \ --cli-input-json file://app-image-config-input.json

    A resposta deve ser semelhante ao seguinte:

    { "AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/custom-image-config" }