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
-
Abra o console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/
. -
No painel de navegação à esquerda, escolha Configurações do administrador.
-
Em Configurações do administrador, escolha Domínios.
-
Na página Domínios, selecione o Domínio ao qual anexar a imagem.
-
Na página de Detalhes do domínio, selecione a guia de Ambiente.
-
Na guia Ambiente, em Imagens personalizadas do SageMaker Studio Classic anexadas ao domínio, escolha Anexar imagem.
-
Em Fonte da imagem, escolha Imagem existente.
-
Escolha uma imagem existente na lista.
-
Escolha uma versão da imagem na lista.
-
Escolha Próximo.
-
Verifique os valores para Nome da imagem, Nome de exibição da imagem e Descrição.
-
Escolha o Perfil do IAM. Para obter mais informações, consulte Crie uma imagem de SageMaker IA personalizada.
-
(Opcional) Adicione tags para a imagem.
-
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.
-
Em Tipo de imagem, selecione Imagem de SageMaker estúdio
-
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. -
(Opcional) Em Nome de exibição do kernel, insira o nome de exibição do kernel.
-
Escolha Adicionar kernel.
-
Escolha Enviar.
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
-
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
-
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 jsonA resposta deve ser semelhante ao seguinte:
[ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ]
-
Crie um arquivo de configuração denominado
create-domain-input.json
. Insira o ID da VPC, a sub-rede IDs eImageName
as etapasAppImageConfigName
anteriores. Como oImageVersionNumber
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" } -
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 oDefaultUserSettings
para o domínio.Adicione o
ImageName
eAppImageConfig
como umaCustomImage
aoDefaultUserSettings
.Atualize seu domínio para incluir a imagem personalizada.
Para adicionar a imagem de SageMaker IA personalizada ao seu domínio
-
Abra o console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/
. -
No painel de navegação à esquerda, escolha Configurações do administrador.
-
Em Configurações do administrador, escolha Domínios.
-
Na página Domínios, selecione o Domínio ao qual anexar a imagem.
-
Na página de detalhes do domínio, selecione a guia Configurações do domínio.
-
Na guia Configurações do domínio, em Configurações gerais, encontre o
DomainId
. O ID está no seguinte formato:d-xxxxxxxxxxxx
. -
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": [ ], ... } } }
-
Salve a seção de configurações padrão do usuário da resposta em um arquivo chamado
default-user-settings.json
. -
Insira o
ImageName
e oAppImageConfigName
das etapas anteriores como uma imagem personalizada. Como oImageVersionNumber
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" } ], ... } } }
-
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.jsonA 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 oDefaultSpaceSettings
para o domínio.Adicione o
ImageName
eAppImageConfig
como umaCustomImage
aoDefaultSpaceSettings
.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
-
Abra o console do Amazon SageMaker AI em https://console.aws.amazon.com/sagemaker/
. -
No painel de navegação à esquerda, escolha Configurações do administrador.
-
Em Configurações do administrador, escolha Domínios.
-
Na página Domínios, selecione o Domínio ao qual anexar a imagem.
-
Na página de detalhes do domínio, selecione a guia Configurações do domínio.
-
Na guia Configurações do domínio, em Configurações gerais, encontre o
DomainId
. O ID está no seguinte formato:d-xxxxxxxxxxxx
. -
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": [ ], ... } } }
-
Salve a seção de configurações padrão do espaço da resposta em um arquivo chamado
default-space-settings.json
. -
Insira o
ImageName
e oAppImageConfigName
das etapas anteriores como uma imagem personalizada. Como oImageVersionNumber
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" } ], ... } } }
-
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.jsonA 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>