Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Anexe uma imagem de SageMaker IA personalizada

Modo de foco
Anexe 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á.

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

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.

Para usar uma imagem de SageMaker IA 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 imagem de SageMaker IA 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, a SageMaker IA 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 AI 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 imagem de SageMaker IA personalizada ao seu domínio usando o console de SageMaker IA ou AWS CLI o. Você só pode anexar uma imagem personalizada a um espaço compartilhado usando o AWS CLI.

Anexe a imagem de SageMaker IA a um domínio

Anexe a imagem de SageMaker IA usando o console

Este tópico descreve como você pode anexar uma versão de imagem de SageMaker IA personalizada existente ao seu domínio usando o painel de controle de SageMaker IA. Você também pode criar uma imagem de SageMaker IA e uma versão de imagem personalizadas 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 imagem de SageMaker IA personalizada.

Para anexar uma imagem existente
  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 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 o Perfil do IAM. Para obter mais informações, consulte Crie uma imagem de SageMaker IA personalizada.

  13. (Opcional) Adicione tags para a imagem.

  14. Especifique o caminho de montagem do EFS. 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 DEVELOPMENT no 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 imagem de SageMaker IA 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 imagem de SageMaker IA usando o AWS CLI

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

Anexe a imagem de SageMaker IA a um novo domínio

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

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

  • 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 imagem de SageMaker IA personalizada ao seu domínio
  1. Obtenha seu ID de VPC 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 ID da VPC 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 ID da VPC, a sub-rede IDs e ImageName as etapas AppImageConfigName anteriores. 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 imagem de SageMaker IA 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 imagem de SageMaker IA ao seu domínio atual

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

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

  • Obtenha seu DomainID do painel de controle SageMaker AI.

  • 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 imagem de SageMaker IA personalizada ao seu domínio
  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 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 o 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 imagem de SageMaker IA a um espaço compartilhado

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

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

  • Obtenha seu DomainID do painel de controle SageMaker AI.

  • 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 imagem de SageMaker IA personalizada ao seu espaço compartilhado
  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 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 o ImageName e o 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.

    { "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 AI

Depois de criar a imagem de SageMaker IA 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>
PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.