Anexar uma SageMaker imagem personalizada - Amazon SageMaker

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

Anexar uma SageMaker imagem personalizada

Importante

IAMPolíticas personalizadas que permitem que o Amazon SageMaker Studio ou o Amazon SageMaker 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 IAM política permitir que o Studio e o Studio Classic criem recursos, mas não permita a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte Forneça permissões para marcar recursos SageMaker.

AWS Políticas gerenciadas para a Amazon SageMakerque 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 para usar o aplicativo Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte SageMaker Estúdio Amazon.

Para usar uma SageMaker imagem personalizada, você deve anexar uma versão da imagem ao seu domínio ou espaço compartilhado. Quando você anexa uma versão de imagem, ela aparece no SageMaker Studio Classic Launcher e está disponível na lista suspensa Selecionar imagem, que os usuários usam para iniciar uma atividade ou alterar a imagem usada por um notebook.

Para disponibilizar uma SageMaker imagem personalizada para todos os usuários em um domínio, você anexa a imagem ao domínio. Para disponibilizar uma imagem para todos os usuários em um espaço compartilhado, você pode anexar a imagem ao espaço compartilhado. Para disponibilizar uma imagem para um único usuário, você anexa a imagem ao perfil do usuário. Quando você anexa uma imagem, SageMaker usa a versão mais recente da imagem por padrão. Você também pode anexar uma versão específica da imagem. Depois de anexar a versão, você pode escolher a versão no SageMaker Launcher ou no seletor de imagens ao iniciar um notebook.

Há um limite para o número de versões de imagem que podem ser anexadas a qualquer momento. Depois de atingir o limite, você deve desanexar uma versão para anexar outra versão da imagem.

As seções a seguir demonstram como anexar uma SageMaker imagem personalizada ao seu domínio usando o SageMaker console ou AWS CLI o. Você só pode anexar uma imagem personalizada a um espaço compartilhado usando o AWS CLI.

Anexar a SageMaker imagem a um domínio

Anexe a SageMaker imagem usando o console

Este tópico descreve como você pode anexar uma versão de SageMaker imagem personalizada existente ao seu domínio usando o painel SageMaker de controle. Você também pode criar uma SageMaker imagem personalizada e uma versão da imagem e, em seguida, anexar essa versão ao seu domínio. Para obter o procedimento para criar uma imagem e uma versão da imagem, consulte Crie uma SageMaker imagem personalizada.

Para anexar uma imagem existente
  1. Abra o SageMaker console da Amazon 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 domínios.

  4. Na página Domínios, selecione o domínio ao qual anexar a imagem.

  5. Na página de Detalhes do domínio, selecione a guia de Ambiente.

  6. Na guia Ambiente, em Imagens personalizadas do SageMaker Studio Classic anexadas ao domínio, escolha Anexar imagem.

  7. Em Fonte da imagem, escolha Imagem existente.

  8. Escolha uma imagem existente na lista.

  9. Escolha uma versão da imagem na lista.

  10. Escolha Próximo.

  11. Verifique os valores para Nome da imagem, Nome de exibição da imagem e Descrição.

  12. Escolha a IAM função. Para obter mais informações, consulte Crie uma SageMaker imagem personalizada.

  13. (Opcional) Adicione tags à imagem.

  14. Especifique o caminho de EFS montagem. Esse é o caminho dentro da imagem para montar o diretório inicial do Amazon Elastic File System (EFS) do usuário.

  15. Em Tipo de imagem, selecione Imagem de SageMaker estúdio

  16. Em Nome do kernel, insira o nome de um kernel existente na imagem. Para obter informações sobre como obter as informações do kernel da imagem, consulte DEVELOPMENTo repositório SageMaker Studio Classic Custom Image Samples. Para obter mais informações, consulte as seções Descoberta do kernel e Dados do usuário do Especificações de SageMaker imagem personalizadas.

  17. (Opcional) Em Nome de exibição do kernel, insira o nome de exibição do kernel.

  18. Escolha Adicionar kernel.

  19. Escolha Enviar.

    1. Aguarde até que a versão da imagem seja anexada ao domínio. Quando anexada, a versão é exibida na lista de imagens personalizadas e destacada brevemente.

Anexe a SageMaker imagem usando o AWS CLI

As seções a seguir demonstram como anexar uma SageMaker imagem personalizada ao criar um novo domínio ou atualizar seu domínio existente usando AWS CLI o.

Anexar a SageMaker imagem a um novo domínio

A seção a seguir demonstra como criar um novo domínio com a versão anexada. Essas etapas exigem que você especifique as informações da Amazon Virtual Private Cloud (VPC) e a função de execução necessárias para criar o domínio. Você executa as etapas a seguir para criar o domínio e anexar a SageMaker imagem personalizada:

  • Obtenha seu VPC ID e sub-rede IDs padrão.

  • Crie o arquivo de configuração para o domínio, que especifica a imagem.

  • Crie um domínio com o arquivo de configuração.

Para adicionar a SageMaker imagem personalizada ao seu domínio
  1. Obtenha seu VPC ID padrão.

    aws ec2 describe-vpcs \ --filters Name=isDefault,Values=true \ --query "Vpcs[0].VpcId" --output text

    A resposta deve ser semelhante ao seguinte.

    vpc-xxxxxxxx
  2. Obtenha sua sub-rede padrão IDs usando o VPC ID da etapa anterior.

    aws ec2 describe-subnets \ --filters Name=vpc-id,Values=<vpc-id> \ --query "Subnets[*].SubnetId" --output json

    A resposta deve ser semelhante ao seguinte.

    [ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ]
  3. Crie um arquivo de configuração denominado create-domain-input.json. Insira o VPC ID, a sub-rede IDs e AppImageConfigName as etapas anteriores. ImageName Como o ImageVersionNumber não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso.

    { "DomainName": "domain-with-custom-image", "VpcId": "<vpc-id>", "SubnetIds": [ "<subnet-ids>" ], "DefaultUserSettings": { "ExecutionRole": "<execution-role>", "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "custom-image", "AppImageConfigName": "custom-image-config" } ] } }, "AuthMode": "IAM" }
  4. Crie o domínio com a SageMaker imagem personalizada anexada.

    aws sagemaker create-domain \ --cli-input-json file://create-domain-input.json

    A resposta deve ser semelhante ao seguinte.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx", "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..." }

Anexe a SageMaker imagem ao seu domínio atual

Se você se integrou a um SageMaker domínio, poderá anexar a imagem personalizada ao seu domínio atual. Para obter mais informações sobre a integração em um SageMaker domínio, consulteVisão geral SageMaker do domínio da Amazon. Você não precisa especificar as VPC informações e a função de execução ao anexar uma imagem personalizada ao seu domínio atual. Depois de anexar a versão, você deve excluir todos os aplicativos em seu domínio e reabrir o Studio Classic. Para obter informações sobre como excluir aplicativos, consulte Excluir um SageMaker domínio da Amazon.

Você executa as etapas a seguir para adicionar a SageMaker imagem ao seu domínio atual.

  • Obtenha seu no painel DomainID de SageMaker controle.

  • Use o DomainID para obter o DefaultUserSettings para o domínio.

  • Adicione o ImageName e AppImageConfig como uma CustomImage ao DefaultUserSettings.

  • Atualize seu domínio para incluir a imagem personalizada.

Para adicionar a SageMaker imagem personalizada ao seu domínio
  1. Abra o SageMaker console da Amazon 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 domínios.

  4. Na página Domínios, selecione o domínio ao qual anexar a imagem.

  5. Na página de detalhes do domínio, selecione a guia Configurações do domínio.

  6. Na guia Configurações do domínio, em Configurações gerais, encontre o DomainId. O ID está no seguinte formato: d-xxxxxxxxxxxx.

  7. Use o ID do domínio para obter a descrição do domínio.

    aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>

    A resposta deve ser semelhante ao seguinte.

    { "DomainId": "d-xxxxxxxxxxxx", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Salve a seção de configurações padrão do usuário da resposta em um arquivo chamado default-user-settings.json.

  9. Insira o ImageName e AppImageConfigName das etapas anteriores como uma imagem personalizada. Como o ImageVersionNumber não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso.

    { "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  10. Use o ID do domínio e o arquivo de configurações padrão do usuário para atualizar seu domínio.

    aws sagemaker update-domain \ --domain-id <d-xxxxxxxxxxxx> \ --cli-input-json file://default-user-settings.json

    A resposta deve ser semelhante ao seguinte.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Anexe a SageMaker imagem a um espaço compartilhado

Você só pode anexar a SageMaker imagem a um espaço compartilhado usando AWS CLI o. Depois de anexar a versão, você deve excluir todos os aplicativos em seu espaço compartilhado e reabrir o Studio Classic. Para obter informações sobre como excluir aplicativos, consulte Excluir um SageMaker domínio da Amazon.

Você executa as etapas a seguir para adicionar a SageMaker imagem a um espaço compartilhado.

  • Obtenha seu no painel DomainID de SageMaker controle.

  • Use o DomainID para obter o DefaultSpaceSettings para o domínio.

  • Adicione o ImageName e AppImageConfig como uma CustomImage ao DefaultSpaceSettings.

  • Atualize seu domínio para incluir a imagem personalizada com o espaço compartilhado.

Para adicionar a SageMaker imagem personalizada ao seu espaço compartilhado
  1. Abra o SageMaker console da Amazon 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 domínios.

  4. Na página Domínios, selecione o domínio ao qual anexar a imagem.

  5. Na página de detalhes do domínio, selecione a guia Configurações do domínio.

  6. Na guia Configurações do domínio, em Configurações gerais, encontre o DomainId. O ID está no seguinte formato: d-xxxxxxxxxxxx.

  7. Use o ID do domínio para obter a descrição do domínio.

    aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>

    A resposta deve ser semelhante ao seguinte.

    { "DomainId": "d-xxxxxxxxxxxx", ... "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Salve a seção de configurações padrão do espaço da resposta em um arquivo chamado default-space-settings.json.

  9. Insira ImageName e AppImageConfigName das etapas anteriores como uma imagem personalizada. Como ImageVersionNumber não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso.

    { "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  10. Use o ID do domínio e o arquivo de configurações padrão do espaço para atualizar seu domínio.

    aws sagemaker update-domain \ --domain-id <d-xxxxxxxxxxxx> \ --cli-input-json file://default-space-settings.json

    A resposta deve ser semelhante ao seguinte.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Veja a imagem anexada em SageMaker

Depois de criar a SageMaker imagem personalizada e anexá-la ao seu domínio, a imagem aparece na guia Ambiente do domínio. Você só pode visualizar as imagens anexadas para espaços compartilhados AWS CLI usando o comando a seguir.

aws sagemaker describe-domain \ --domain-id <d-xxxxxxxxxxxx>