

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.

# Détachement et nettoyage des ressources d’images personnalisées
<a name="studio-updated-byoi-how-to-detach-from-domain"></a>

La page suivante fournit des instructions sur la façon de détacher vos images personnalisées et de nettoyer les ressources associées à l'aide de la console Amazon SageMaker AI ou du AWS Command Line Interface (AWS CLI). 

**Important**  
Vous devez d'abord détacher votre image personnalisée de votre domaine avant de la supprimer du magasin d'images SageMaker AI. Dans le cas contraire, vous risquez de rencontrer des erreurs en visualisant les informations de votre domaine ou en attachant de nouvelles images personnalisées à votre domaine.   
Si vous rencontrez une erreur lors du chargement d’une image personnalisée, consultez [Impossible de charger l’image personnalisée](studio-updated-troubleshooting.md#studio-updated-troubleshooting-custom-image). 

## Détachement et suppression d’images personnalisées (console)
<a name="studio-updated-byoi-how-to-detach-from-domain-console"></a>

Vous trouverez ci-dessous des instructions sur la façon de détacher vos images personnalisées de l' SageMaker IA et de nettoyer vos ressources d'images personnalisées à l'aide de la console.

**Détachement de votre image personnalisée de votre domaine**

1. Ouvrez la [console SageMaker AI](https://console.aws.amazon.com/sagemaker).

1. Développez la section **Configurations d’administrateur**.

1. Sous **Configurations d’administrateur**, choisissez **Domaines**.

1. Dans la liste **Domaines**, sélectionnez un domaine.

1. Ouvrez l’onglet **Environnement**.

1. Pour **Images personnalisées pour les applications Personal Studio**, cochez les cases correspondant aux images que vous souhaitez détacher.

1. Choisissez **Détacher**.

1. Suivez les instructions de détachement.

**Suppression de votre image personnalisée**

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 **Images**.

1. Dans la liste **Images**, sélectionnez une image que vous souhaiteriez supprimer.

1. Sélectionnez **Delete (Supprimer)**.

1. Suivez les instructions pour supprimer votre image et toutes ses versions de l' SageMaker IA.

**Suppression de vos images personnalisées et du référentiel dans Amazon ECR**
**Important**  
Cela supprimera également toutes les images de conteneur et tous les artefacts figurant dans ce référentiel.

1. Ouvrez la [console Amazon ECR](https://console.aws.amazon.com/ecr).

1. Si vous ne l’avez pas encore fait, développez le volet de navigation de gauche.

1. Sous **Registre privé**, choisissez **Référentiels**.

1. Sélectionnez les référentiels que vous souhaitez supprimer.

1. Sélectionnez **Delete (Supprimer)**.

1. Suivez les instructions de suppression.

## Détachement et suppression d’images personnalisées (AWS CLI)
<a name="studio-updated-byoi-how-to-detach-from-domain-cli"></a>

La section suivante montre un exemple illustrant comment détacher vos images personnalisées à l’aide de l’ AWS CLI.

1. Définissez d'abord vos variables pour les AWS CLI commandes qui suivent.

   ```
   ACCOUNT_ID=account-id
   REGION=aws-region
   APP_IMAGE_CONFIG=app-image-config
   SAGEMAKER_IMAGE_NAME=custom-image-name
   ```
   + `aws-region`est celui Région AWS de votre domaine Amazon SageMaker AI. Vous pouvez le trouver en haut à droite de n'importe quelle page de AWS console. 
   + `app-image-config` est le nom de la configuration de votre image d’application. Utilisez la AWS CLI commande suivante pour répertorier les configurations d'image d'application dans votre Région AWS.

     ```
     aws sagemaker list-app-image-configs \
            --region ${REGION}
     ```
   + `custom-image-name` est le nom de l’image personnalisée. Utilisez la AWS CLI commande suivante pour répertorier les images de votre Région AWS.

     ```
     aws sagemaker list-images \
            --region ${REGION}
     ```

1. Pour détacher l’image et les versions d’image de votre domaine à l’aide de ces instructions, vous devez créer ou mettre à jour un fichier json de configuration de domaine.
**Note**  
Si vous avez suivi les instructions fournies dans [Attachement de votre image personnalisée à votre domaine](studio-updated-byoi-how-to-attach-to-domain.md), vous avez peut-être mis à jour votre domaine à l’aide du fichier nommé `update-domain.json`.   
Si vous n’avez pas ce fichier, vous pouvez créer un nouveau fichier json à la place.

   Créez un fichier nommé `update-domain.json` que vous utiliserez pour mettre à jour votre domaine.

1. Pour supprimer les images personnalisées, vous devez laisser `CustomImages` vide, par exemple `"CustomImages": []`. Choisissez l'une des options suivantes pour afficher des exemples de fichiers de configuration pour Code Editor ou JupyterLab.

------
#### [ Code Editor: update domain configuration file example ]

   Exemple de fichier de configuration pour l’éditeur de code, utilisant [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CodeEditorAppSettings.html).

   ```
   {
       "DomainId": "domain-id",
       "DefaultUserSettings": {
           "CodeEditorAppSettings": {
               "CustomImages": [
               ]
           }
       }
   }
   ```

------
#### [ JupyterLab: update domain configuration file example ]

   Exemple de fichier de configuration pour JupyterLab, utiliser [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_JupyterLabAppSettings.html).

   ```
   {
       "DomainId": "domain-id",
       "DefaultUserSettings": {
           "JupyterLabAppSettings": {
               "CustomImages": [
               ]
           }
       }
   }
   ```

------

   `domain-id` est l’ID du domaine auquel votre image est attachée. Utilisez la commande suivante pour dresser la liste de vos domaines.

   ```
   aws sagemaker list-domains \
         --region ${REGION}
   ```

1. Enregistrez le fichier.

1. Appelez le [domaine de mise à jour à](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html) AWS CLI l'aide du fichier de configuration du domaine de mise à jour,. `update-domain.json`
**Note**  
Avant de pouvoir mettre à jour les images personnalisées, vous devez supprimer toutes les **applications** de votre domaine. Vous **n’avez pas** besoin de supprimer les profils utilisateur ni les espaces partagés. Pour obtenir les instructions de suppression des applications, choisissez l’une des options suivantes.  
Si vous souhaitez utiliser la console SageMaker AI, consultez[Arrêtez les ressources d' SageMaker IA de votre domaine](sm-console-domain-resources-shut-down.md).
Si vous souhaitez utiliser le AWS CLI, suivez les étapes 1 à 3 de[Supprimer un domaine Amazon SageMaker AI (AWS CLI)](gs-studio-delete-domain.md#gs-studio-delete-domain-cli).

   ```
   aws sagemaker update-domain \
       --cli-input-json file://update-domain.json \
       --region ${REGION}
   ```

1. Supprimez la configuration de l’image de l’application.

   ```
   aws sagemaker delete-app-image-config \
       --app-image-config-name ${APP_IMAGE_CONFIG}
   ```

1. Supprimez l’image personnalisée. Cela supprime également toutes les versions de l’image. Cela ne supprime pas l’image et les versions de l’image du conteneur Amazon ECR. Pour ce faire, utilisez les étapes facultatives suivantes.

   ```
   aws sagemaker delete-image \
       --image-name ${SAGEMAKER_IMAGE_NAME}
   ```

1. (Facultatif) Supprimez vos ressources Amazon ECR. La liste suivante fournit des AWS CLI commandes permettant d'obtenir les informations relatives à vos ressources Amazon ECR pour les étapes ci-dessous.

   1. Définissez vos variables pour les AWS CLI commandes suivantes.

      ```
      ECR_REPO_NAME=ecr-repository-name
      ```

      `ecr-repository-name` est le nom de votre référentiel Amazon Elastic Container Registry. 

      Pour afficher la liste des détails de vos référentiels, utilisez la commande suivante.

      ```
      aws ecr describe-repositories \
              --region ${REGION}
      ```

   1. Supprimez votre référentiel d’Amazon ECR. 
**Important**  
Cela supprimera également toutes les images de conteneur et tous les artefacts figurant dans ce référentiel.

      ```
      aws ecr delete-repository \
            --repository-name ${ECR_REPO_NAME} \
            --force \
            --region ${REGION}
      ```