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**
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](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que 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 RStudio imagem personalizada ao seu domínio Amazon SageMaker AI usando o console de SageMaker IA ou o AWS Command Line Interface (AWS CLI).
Para usar uma SageMaker imagem personalizada, você deve anexar uma RStudio imagem personalizada ao seu domínio. Quando você anexa uma versão de imagem, ela aparece no RStudio Launcher e está disponível na lista suspensa **Selecionar imagem**. Você usa o menu suspenso para alterar a imagem usada por. 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.
**Topics**
+ [Anexe uma versão da imagem ao seu domínio usando o console](#rstudio-byoi-attach-console)
+ [Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI](#rstudio-byoi-attach-cli)
## Anexe uma versão da 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 console SageMaker AI. 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**
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio desejado.
1. Escolha **Ambiente**.
1. Em **Imagens do Custom SageMaker Studio Classic anexadas ao domínio**, escolha **Anexar imagem**.
1. 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 para SageMaker IA devem estar habilitadas.
1. Escolha uma imagem existente na lista.
1. Escolha uma versão da imagem na lista.
1. Escolha **Próximo**.
1. Insira valores para **Nome da imagem**, **Nome de exibição da imagem** e **Descrição**.
1. Escolha o Perfil do IAM. Para obter mais informações, consulte [Crie uma RStudio imagem personalizada](rstudio-byoi-create.md).
1. (Opcional) Adicione tags à imagem.
1. (Opcional) Escolha **Adicionar nova tag** e, em seguida, adicione uma tag de configuração.
1. Em **Tipo de imagem**, selecione **RStudioImagem**.
1. 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 a AWS CLI. 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 RStudio reinicie.
### 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 [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)política anexada.
Use as etapas a seguir para criar o domínio e anexar a imagem de SageMaker IA personalizada:
+ Obtenha seu ID de VPC 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 SageMaker imagem 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
```
Resposta:
```
vpc-xxxxxxxx
```
1. Obtenha sua sub-rede padrão IDs usando o ID da VPC da etapa anterior.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values= \
--query "Subnets[*].SubnetId" --output json
```
Resposta:
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. 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. A função de execução deve atender aos requisitos em [Concluir os pré-requisitos](rstudio-byoi-prerequisites.md).
```
{
"DomainName": "domain-with-custom-r-image",
"VpcId": "",
"SubnetIds": [
""
],
"DomainSettings": {
"RStudioServerProDomainSettings": {
"DomainExecutionRoleArn": ""
}
},
"DefaultUserSettings": {
"ExecutionRole": "",
"RSessionAppSettings": {
"CustomImages": [
{
"AppImageConfigName": "rstudio-custom-config",
"ImageName": "rstudio-custom-image"
}
]
}
},
"AuthMode": "IAM"
}
```
1. 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
Este método pressupõe que você já esteja integrado ao domínio. Para obter mais informações, consulte [Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md).
**nota**
Você deve excluir todas as aplicações no seu domínio para atualizar o domínio com a nova versão de imagem. Para obter informações sobre como excluir esses aplicações, consulte [Excluir um domínio da Amazon SageMaker AI](gs-studio-delete-domain.md).
Use as etapas a seguir para adicionar a SageMaker imagem ao seu domínio atual.
+ Obtenha o seu no console `DomainID` de SageMaker IA.
+ 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 console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio desejado.
1. Escolha **Configurações de domínio**.
1. Em **Configurações gerais**, encontre o **ID do domínio**. O ID está no seguinte formato: `d-xxxxxxxxxxxx`.
1. Use o ID do domínio para obter a descrição do domínio.
```
aws sagemaker describe-domain \
--domain-id
```
Resposta:
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Salve a seção `DefaultUserSettings` da resposta em um arquivo chamado `update-domain-input.json`.
1. 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": {
"RSessionAppSettings": {
"CustomImages": [
{
"ImageName": "rstudio-custom-image",
"AppImageConfigName": "rstudio-custom-config"
}
]
}
}
}
```
1. 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 \
--cli-input-json file://update-domain-input.json
```
Resposta:
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}
```
1. Exclua a aplicação do `RStudioServerPro`. Você deve reiniciar o aplicativo de `RStudioServerPro` domínio compartilhado para a interface do usuário do RStudio Launcher para obter as alterações mais recentes.
```
aws sagemaker delete-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
1. Para criar um nova aplicação `RStudioServerPro`. Você deve criar esse aplicação usando o AWS CLI.
```
aws sagemaker create-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```