Détachement et nettoyage des ressources d’images personnalisées - Amazon SageMaker AI

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

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.

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.

  2. Développez la section Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Domaines.

  4. Dans la liste Domaines, sélectionnez un domaine.

  5. Ouvrez l’onglet Environnement.

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

  7. Choisissez Détacher.

  8. Suivez les instructions de détachement.

Suppression de votre image personnalisée
  1. Ouvrez la console SageMaker AI.

  2. Développez la section Configurations d’administrateur, si vous ne l’avez pas encore fait.

  3. Sous Configurations d’administrateur, choisissez Images.

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

  5. Sélectionnez Delete (Supprimer).

  6. 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.

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

  3. Sous Registre privé, choisissez Référentiels.

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

  5. Sélectionnez Delete (Supprimer).

  6. Suivez les instructions de suppression.

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-regionest 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 votreRé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 votreRégion AWS.

      aws sagemaker list-images \ --region ${REGION}
  2. 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, 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.

  3. 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 CodeEditorAppSettings.

    { "DomainId": "domain-id", "DefaultUserSettings": { "CodeEditorAppSettings": { "CustomImages": [ ] } } }
    JupyterLab: update domain configuration file example

    Exemple de fichier de configuration pour JupyterLab, utiliser JupyterLabAppSettings.

    { "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}
  4. Enregistrez le fichier.

  5. Appelez le domaine de mise à jour à 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.

    aws sagemaker update-domain \ --cli-input-json file://update-domain.json \ --region ${REGION}
  6. Supprimez la configuration de l’image de l’application.

    aws sagemaker delete-app-image-config \ --app-image-config-name ${APP_IMAGE_CONFIG}
  7. 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}
  8. (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 qui suivent.

      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}
    2. 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}