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 afin d'accéder à votre domaine et de démarrer le processus **d'ajout d'image**. Les instructions suivantes supposent que vous avez transféré une image vers un référentiel Amazon ECR Région AWS identique à celui de 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 créera une image et une version d'image dans votre magasin d'images SageMaker AI, puis l'associera à 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 le magasin d'images SageMaker AI, utilisez cette option. Cette option attache une image personnalisée existante à votre domaine. Pour afficher vos images personnalisées dans le magasin 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 et une version d'image existantes dans le magasin 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 [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*.