Anexe uma versão de imagem ao seu domínio usando o console Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI

Anexar uma SageMaker imagem 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 ter 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.

Este guia mostra como anexar uma imagem personalizada do RStudio ao seu SageMaker domínio da Amazon usando o SageMaker console ou o AWS Command Line Interface (AWS CLI).

Para usar uma SageMaker imagem personalizada, você deve anexar uma imagem personalizada do RStudio ao seu domínio. Quando você anexa uma versão de imagem, ela aparece no Inicializador do RStudio e está disponível na lista suspensa Selecionar imagem. Você usa o menu suspenso para alterar a imagem usada pelo RStudio.

Há um limite para o número de versões de imagens que você pode anexar. Depois de atingir o limite, você deve primeiro separar uma versão para poder anexar uma versão diferente da imagem.

Tópicos

Anexe uma versão de imagem ao seu domínio usando o console
Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI

Anexe uma versão de imagem ao seu domínio usando o console

Você pode anexar uma versão de SageMaker imagem personalizada ao seu domínio usando o painel de controle do SageMaker console. 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 anexar uma imagem existente

Abra o SageMaker console da Amazon 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.
Selecione o domínio desejado.
Escolha Ambiente.
Em Imagens do Custom SageMaker Studio Classic anexadas ao domínio, escolha Anexar imagem.
Em Fonte da imagem, escolha Imagem existente ou Nova imagem.

Se você selecionar Imagem existente, escolha uma imagem na loja de SageMaker imagens da Amazon.

Se você selecionar Nova imagem, forneça o caminho de registro do Amazon ECR para sua imagem do Docker. O caminho deve estar no mesmo Região da AWS que o domínio. O repositório Amazon ECR deve estar na mesma conta do seu domínio, ou as permissões entre contas SageMaker devem estar habilitadas.
Escolha um imagem existente na lista.
Escolha uma versão da imagem na lista.
Escolha Next (Próximo).
Insira valores para Nome da imagem, Nome de exibição da imagem e Descrição.
Escolha a Função do IAM. Para ter mais informações, consulte Crie uma imagem personalizada do RStudio.
(Opcional) Adicione tags à imagem.
(Opcional) Escolha Adicionar nova tag e, em seguida, adicione uma tag de configuração.
Em Tipo de imagem, selecione Imagem do RStudio.
Selecione Enviar.

Aguarde até que a versão da imagem seja anexada ao domínio. Depois que a versão é anexada, ela aparece na lista de imagens personalizadas e fica brevemente em destaque.

Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI

Dois métodos são apresentados para anexar a versão da imagem ao seu domínio usando AWS CLI o. No primeiro método, você cria um novo domínio com a versão anexada. Esse método é mais simples, mas você deve especificar as informações e a função de execução da Amazon Virtual Private Cloud (Amazon VPC) necessárias para criar o domínio.

Se você já se integrou ao domínio, pode usar o segundo método para anexar a versão da imagem ao seu domínio atual. Nesse caso, você não precisa especificar as informações e a função de execução do Amazon VPC. Depois de anexar a versão, exclua todos os aplicativos em seu domínio e reinicie o RStudio.

Anexar a SageMaker imagem a um novo domínio

Para usar esse método, você deve especificar uma função de execução que tenha a AmazonSageMakerFullAccesspolítica anexada.

Use as etapas a seguir para criar o domínio e anexar a SageMaker imagem personalizada:

Obtenha seu ID de VPC e IDs de sub-rede por 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

Obtenha seu ID de VPC padrão.


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

Resposta:


vpc-xxxxxxxx

Obtenha os IDs de sub-rede padrão usando o ID da VPC da etapa anterior.


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

Resposta:


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

Crie um arquivo de configuração denominado create-domain-input.json. Insira o ID da VPC, os IDs de sub-rede, ImageName e AppImageConfigName das etapas anteriores. Como o ImageVersionNumber não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso. A função de execução deve atender aos requisitos em Concluir os pré-requisitos.


{
  "DomainName": "domain-with-custom-r-image",
  "VpcId": "<vpc-id>",
  "SubnetIds": [
    "<subnet-ids>"
  ],
  "DomainSettings": {
    "RStudioServerProDomainSettings": {
      "DomainExecutionRoleArn": "<execution-role>"
    }
  },
  "DefaultUserSettings": {
    "ExecutionRole": "<execution-role>",
    "RSessionAppSettings": {
      "CustomImages": [
        {
         "AppImageConfigName": "rstudio-custom-config",
         "ImageName": "rstudio-custom-image"
        }
      ]
     }
  },
  "AuthMode": "IAM"
}

Crie o domínio com a SageMaker imagem personalizada anexada.


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

Resposta:


{
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
    "Url": "https://domain-id.studio.region.sagemaker.aws/..."
}

Anexar a SageMaker imagem a um domínio existente

Esse método pressupõe que você já tenha feito a integração com o domínio. Para ter mais informações, consulte Visão geral SageMaker do domínio da Amazon.

nota

Você deve excluir todos os aplicativos em seu domínio para atualizar o domínio com a nova versão da imagem. Para obter informações sobre como excluir esses aplicativos, consulte Excluir um SageMaker domínio da Amazon.

Use as etapas a seguir para adicionar a SageMaker imagem ao seu domínio atual.

Obtenha o DomainID seu no SageMaker console.
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

Abra o SageMaker console da Amazon 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.
Selecione o domínio desejado.
Escolha as configurações do domínio.
Em Configurações gerais, encontre o ID do domínio. 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>

Resposta:


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Salve a seção DefaultUserSettings da resposta em um arquivo chamado update-domain-input.json.

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": {
        "RSessionAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "rstudio-custom-image",
                 "AppImageConfigName": "rstudio-custom-config"
              }
           ]
        }
    }
}

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://update-domain-input.json

Resposta:


{
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}

Exclua o aplicativo do RStudioServerPro. Você deve reiniciar o aplicativo de domínio compartilhado do RStudioServerPro para a interface do usuário do Inicializador do RStudio para obter as alterações mais recentes.
```
aws sagemaker delete-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default
```

Para criar um novo aplicativo RStudioServerPro. Você deve criar esse aplicativo usando o AWS CLI.


aws sagemaker create-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar uma imagem

Execute uma imagem personalizada