Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Attachement de votre image personnalisée à votre domaine Cette page fournit des instructions sur la façon d’attacher votre image personnalisée à votre domaine. Suivez la procédure suivante pour utiliser la console Amazon SageMaker AI pour accéder à votre domaine et démarrer le ** processus de saisie ** d'une image. Les instructions suivantes partent du principe que vous avez transféré une image vers un référentiel Amazon ECR situé dans le même domaine Région AWS que votre domaine. Si vous ne l’avez pas déjà fait, consultez [Création d’une image personnalisée et envoi (push) vers Amazon ECR](studio-updated-byoi-how-to-prepare-image.md). Lorsque vous choisissez d’attacher une image, deux options s’offrent à vous : + Joindre une ** nouvelle image ** : cette option permet de créer une image et une version d'image dans votre boutique d'images SageMaker AI, puis de la joindre à votre domaine. **Note** Si vous poursuivez le processus BYOI, à partir de [Création d’une image personnalisée et envoi (push) vers Amazon ECR](studio-updated-byoi-how-to-prepare-image.md), utilisez l’option **Nouvelle image**. + Joindre une image ** existante ** : si vous avez déjà créé l'image personnalisée que vous souhaitez dans la boutique d'images SageMaker AI, utilisez cette option. Cette option attache une image personnalisée existante à votre domaine. Pour afficher vos images personnalisées dans la boutique d'images SageMaker AI, consultez[Visualisation des détails de l’image personnalisée (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console). ------ #### [ New image ] **Pour attacher une nouvelle image à votre domaine** 1. Ouvrez la console [ SageMaker AI](https://console.aws.amazon.com/sagemaker). 1. Développez la section **Configurations d’administrateur**, si vous ne l’avez pas encore fait. 1. Sous **Configurations d’administrateur**, choisissez **Domaines**. 1. Dans la liste **Domaines**, sélectionnez le domaine auquel vous souhaitez attacher l’image. **Note** Si vous joignez l'image à un projet SageMaker Unified Studio et que vous avez besoin de précisions sur le domaine à utiliser, consultez [ Afficher les détails du domaine SageMaker AI associé à votre projet](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain). 1. Ouvrez l’onglet **Environnement**. 1. Dans la section **Images personnalisées pour les applications Personal Studio**, choisissez **Attacher l’image**. 1. Pour **Source de l’image**, choisissez **Nouvelle image**. 1. Incluez l’URI de votre image Amazon ECR. Le format est le suivant : ``` {{account-id}}.dkr.ecr.{{aws-region}}.amazonaws.com/{{repository-name}}:{{tag}} ``` 1. Pour obtenir l’URI de votre image Amazon ECR, accédez à la page de vos [référentiels privés Amazon ECR](https://console.aws.amazon.com/ecr/private-registry/repositories). 1. Choisissez le lien du nom de votre référentiel. 1. Choisissez l’icône **Copier l’URI** qui correspond à la version de votre image (**Balise d’image**). 1. Suivez le reste de ces instructions pour attacher votre image personnalisée. **Note** Assurez-vous que vous utilisez le type d’application correspondant à votre `Dockerfile`. Pour de plus amples informations, veuillez consulter [Exemples de fichiers Docker](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates). Une fois que l’image est attachée avec succès à votre domaine, vous pouvez la visualiser dans l’onglet **Environnement**. ------ #### [ Existing image ] **Pour attacher une image existante à votre domaine** 1. Ouvrez la console [ SageMaker AI](https://console.aws.amazon.com/sagemaker). 1. Développez la section **Configurations d’administrateur**, si vous ne l’avez pas encore fait. 1. Sous **Configurations d’administrateur**, choisissez **Domaines**. 1. Dans la liste **Domaines**, sélectionnez le domaine auquel vous souhaitez attacher l’image. **Note** Si vous joignez l'image à un projet SageMaker Unified Studio et que vous avez besoin de précisions sur le domaine à utiliser, consultez [ Afficher les détails du domaine SageMaker AI associé à votre projet](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/view-project-details.html#view-project-details-smai-domain). 1. Ouvrez l’onglet **Environnement**. 1. Dans la section **Images personnalisées pour les applications Personal Studio**, choisissez **Attacher l’image**. 1. Pour **Source de l’image**, choisissez **Image existante**. 1. Choisissez une image existante et une version d'image dans la boutique d'images SageMaker AI. Si vous ne parvenez pas à visualiser la version de votre image, vous devrez peut-être créer une version d’image. Pour de plus amples informations, veuillez consulter [Visualisation des détails de l’image personnalisée (console)](studio-updated-byoi-view-images.md#studio-updated-byoi-view-images-console). 1. Suivez le reste de ces instructions pour attacher votre image personnalisée. **Note** Assurez-vous que vous utilisez le type d’application correspondant à votre `Dockerfile`. Pour de plus amples informations, veuillez consulter [Exemples de fichiers Docker](studio-updated-byoi-specs.md#studio-updated-byoi-specs-dockerfile-templates). Une fois que l’image est attachée avec succès à votre domaine, vous pouvez la visualiser dans l’onglet **Environnement**. ------ Une fois que votre image est attachée avec succès à votre domaine, les utilisateurs du domaine peuvent choisir l’image pour leur application. Pour de plus amples informations, veuillez consulter [Lancement d’une image personnalisée dans Studio](studio-updated-byoi-how-to-launch.md). **Note** Si vous avez joint une image personnalisée à votre projet SageMaker Unified Studio, vous devez lancer l'application depuis SageMaker Unified Studio. Pour plus d'informations, consultez la section [ Lancer votre image personnalisée ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-launch-custom-image.html) dans le guide de l'utilisateur d'*Amazon SageMaker Unified Studio*.