

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 imagem personalizada ao seu domínio
<a name="studio-updated-byoi-how-to-attach-to-domain"></a>

Esta página contém instruções sobre como anexar uma imagem personalizada ao seu domínio. Use o procedimento a seguir para usar o console do Amazon SageMaker AI para navegar até seu domínio e iniciar o processo de **anexar imagem**.

As instruções a seguir pressupõem que você tenha enviado uma imagem para um repositório Amazon ECR no mesmo que seu Região da AWS domínio. Se ainda não fez feito isso, consulte [Criar uma imagem personalizada e enviá-la ao Amazon ECR](studio-updated-byoi-how-to-prepare-image.md).

Ao escolher anexar uma imagem, há duas opções:
+ Anexar uma **nova imagem**: essa opção criará uma imagem e uma versão de imagem em seu armazenamento de imagens de SageMaker IA e, em seguida, as anexará ao seu domínio.
**nota**  
Se você estiver continuando o processo de BYOI, em [Criar uma imagem personalizada e enviá-la ao Amazon ECR](studio-updated-byoi-how-to-prepare-image.md), use a opção **Nova imagem**.
+ Anexar uma **imagem existente**: se você já criou a imagem personalizada pretendida no armazenamento de imagens de SageMaker IA, use essa opção. Esta opção anexa uma imagem personalizada existente ao seu domínio. Para ver suas imagens personalizadas no armazenamento de imagens de SageMaker IA, consulte[Visualizar detalhes da imagem personalizada (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).

------
#### [ New image ]

**Como anexar uma nova imagem ao seu domínio**

1. Abra o [console de SageMaker IA](https://console.aws.amazon.com/sagemaker).

1. Expanda a seção **Configurações do administrador**, se ainda não tiver feito isso.

1. Em **Configurações do administrador**, escolha **Domínios**.

1. Na lista **Domínios**, selecione o domínio ao qual deseja anexar a imagem.
**nota**  
Se você estiver anexando a imagem a um projeto do SageMaker Unified Studio e precisar de esclarecimentos sobre qual domínio usar, consulte [Exibir os detalhes do domínio SageMaker AI associados ao seu](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) projeto.

1. Abra a página de **Ambiente**.

1. Na seção **Imagens personalizadas para aplicações pessoais do Studio**, escolha **Anexar imagem**.

1. Em **Origem da imagem**, escolha **Imagem existente**.

1. Inclua o URI da imagem do Amazon ECR. O formato é o seguinte.

   ```
   account-id.dkr.ecr.aws-region.amazonaws.com/repository-name:tag
   ```

   1. Para obter o URI da imagem do Amazon ECR, navegue até a página [Repositórios privados do Amazon ECR](https://console.aws.amazon.com/ecr/private-registry/repositories).

   1. Escolha o link do nome do repositório.

   1. Escolha o ícone de **copiar URI** que corresponde à versão da sua imagem (**Etiqueta da imagem**).

1. Siga o restante das instruções para anexar sua imagem personalizada.
**nota**  
Verifique se você está usando o tipo de aplicação consistente com o seu `Dockerfile`. Para obter mais informações, consulte [Exemplos de Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).

Depois que a imagem for anexada com êxito ao seu domínio, você poderá visualizá-la na guia **Ambiente**.

------
#### [ Existing image ]

**Como anexar uma imagem existente ao seu domínio**

1. Abra o [console de SageMaker IA](https://console.aws.amazon.com/sagemaker).

1. Expanda a seção **Configurações do administrador**, se ainda não tiver feito isso.

1. Em **Configurações do administrador**, escolha **Domínios**.

1. Na lista **Domínios**, selecione o domínio ao qual deseja anexar a imagem.
**nota**  
Se você estiver anexando a imagem a um projeto do SageMaker Unified Studio e precisar de esclarecimentos sobre qual domínio usar, consulte [Exibir os detalhes do domínio SageMaker AI associados ao seu](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain) projeto.

1. Abra a página de **Ambiente**.

1. Na seção **Imagens personalizadas para aplicações pessoais do Studio**, escolha **Anexar imagem**.

1. Em **Origem da imagem**, escolha **Imagem existente**.

1. Escolha uma imagem existente e uma versão de imagem no armazenamento de imagens de SageMaker IA.

   Se você não conseguir visualizar a versão da imagem, talvez seja necessário criar uma versão da imagem. Para obter mais informações, consulte [Visualizar detalhes da imagem personalizada (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console).

1. Siga o restante das instruções para anexar sua imagem personalizada.
**nota**  
Verifique se você está usando o tipo de aplicação consistente com o seu `Dockerfile`. Para obter mais informações, consulte [Exemplos de Dockerfile](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates).

Depois que a imagem for anexada com êxito ao seu domínio, você poderá visualizá-la na guia **Ambiente**.

------

Depois que sua imagem for anexada com êxito ao seu domínio, os usuários do domínio poderão escolhê-la para a aplicação deles. Para obter mais informações, consulte [Iniciar uma imagem personalizada no Studio](studio-updated-byoi-how-to-launch.md).

**nota**  
Se você anexou uma imagem personalizada ao seu projeto do SageMaker Unified Studio, precisará iniciar o aplicativo de dentro do SageMaker Unified Studio. Para obter mais informações, consulte [Inicie sua imagem personalizada](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html) no *Guia do usuário do Amazon SageMaker Unified Studio*.