Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Préférences
Contactez-nous
Commentaire
AWS Documentation
Créer un compte AWS

Joindre une image SageMaker AI personnalisée

PDF
RSS
Mode de mise au point
Joindre une image SageMaker AI personnalisée - Amazon SageMaker AI
Attacher une version d'image à votre domaine à l'aide de la consoleJoignez une version d'image existante à votre domaine à l'aide du AWS CLI

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.

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.

Important

Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L'autorisation d'ajouter des balises aux ressources est requise car Studio et Studio Classic balisent automatiquement toutes les ressources qu'ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour de plus amples informations, veuillez consulter Fournir des autorisations pour le balisage des ressources d' SageMaker IA.

AWS politiques gérées pour Amazon SageMaker AIqui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.

Ce guide explique comment associer une RStudio image personnalisée à votre domaine Amazon SageMaker AI à l'aide de la console SageMaker AI ou du AWS Command Line Interface (AWS CLI).

Pour utiliser une image SageMaker IA personnalisée, vous devez associer une RStudio image personnalisée à votre domaine. Lorsque vous joignez une version d'image, elle apparaît dans le RStudio lanceur et est disponible dans la liste déroulante Sélectionner une image. Vous utilisez le menu déroulant pour modifier l'image utilisée par RStudio.

Le nombre de versions d'image pouvant être attachées est limité. Après avoir atteint la limite, vous devez d'abord détacher une version afin d'attacher une autre version de l'image.

Attacher une version d'image à votre domaine à l'aide de la console

Vous pouvez associer une version d'image SageMaker AI personnalisée à votre domaine à l'aide du panneau de configuration de la console SageMaker AI. Vous pouvez également créer une image SageMaker AI personnalisée et une version d'image, puis associer cette version à votre domaine.

Pour attacher une image existante

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d'administrateur.

  3. Sous Configurations d'administration, sélectionnez les domaines.

  4. Sélectionnez le domaine souhaité.

  5. Choisissez Environment (Environnement).

  6. Sous Images SageMaker Studio Classic personnalisées associées au domaine, choisissez Joindre une image.

  7. Pour Source de l'image, choisissez Image existante ou Nouvelle image.

    Si vous sélectionnez Image existante, choisissez une image dans la boutique d'images Amazon SageMaker AI.

    Si vous sélectionnez Nouvelle image, indiquez le chemin du registre Amazon ECR pour votre image Docker. Le chemin doit être situé dans le même Région AWS que le domaine. Le dépôt Amazon ECR doit se trouver sur le même compte que votre domaine, sinon les autorisations entre comptes pour l' SageMaker IA doivent être activées.

  8. Choisissez une image existante dans la liste.

  9. Choisissez une version de l'image dans la liste.

  10. Choisissez Suivant.

  11. Saisissez des valeurs pour Image name (Nom de l'image), Image display name (Nom d'affichage de l'image), et Description.

  12. Choisissez le rôle IAM. Pour de plus amples informations, veuillez consulter Création d'une RStudio image personnalisée.

  13. (Facultatif) Ajoutez des balises pour l'image.

  14. (Facultatif) Choisissez Ajouter une nouvelle balise, puis ajoutez une balise de configuration.

  15. Pour Type d'image, sélectionnez RStudioImage.

  16. Sélectionnez Envoyer.

Attendez que la version de l'image soit attachée au domaine. Lorsqu'elle est attachée, la version s'affiche dans la liste Images personnalisées et est brièvement mise en surbrillance.

Joignez une version d'image existante à votre domaine à l'aide du AWS CLI

Deux méthodes sont présentées pour attacher la version de l'image à votre domaine à l'aide de AWS CLI. Dans la première méthode, vous créez un domaine avec la version attachée. Cette méthode est plus simple, mais vous devez spécifier les informations Amazon Virtual Private Cloud (Amazon VPC) et le rôle d'exécution requis pour créer le domaine.

Si vous êtes déjà intégré au domaine, vous pouvez utiliser la deuxième méthode pour associer la version de l'image à votre domaine actuel. Dans ce cas, il n'est pas nécessaire de spécifier les informations d'Amazon VPC et le rôle d'exécution. Après avoir joint la version, supprimez toutes les applications de votre domaine et relancez-les RStudio.

Joindre l'image SageMaker AI à un nouveau domaine

Pour utiliser cette méthode, vous devez spécifier un rôle d'exécution auquel la AmazonSageMakerFullAccesspolitique est attachée.

Procédez comme suit pour créer le domaine et joindre l'image SageMaker AI personnalisée :

  • Obtenez votre ID VPC et votre sous-réseau par défaut. IDs

  • Créez le fichier de configuration du domaine, qui spécifie l'image.

  • Créez le domaine avec le fichier de configuration.

Pour ajouter l'image SageMaker AI personnalisée à votre domaine

  1. Obtenez votre ID de VPC par défaut.

    aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

    Réponse :

    vpc-xxxxxxxx

  2. Obtenez votre sous-réseau par défaut IDs à l'aide de l'ID VPC de l'étape précédente.

    aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

    Réponse :

    [
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

  3. Créez un fichier de configuration nommé create-domain-input.json. Insérez l'ID du VPC, le sous-réseau IDs et ImageName les étapes AppImageConfigName précédentes. Étant donné que ImageVersionNumber n'est pas spécifié, la dernière version de l'image est utilisée, qui est la seule version dans ce cas. Votre rôle d'exécution doit satisfaire aux exigences de Exécuter les opérations prérequises.

    {
  "DomainName": "domain-with-custom-r-image",
  "VpcId": "<vpc-id>",
  "SubnetIds": [
    "<subnet-ids>"
  ],
  "DomainSettings": {
    "RStudioServerProDomainSettings": {
      "DomainExecutionRoleArn": "<execution-role>"
    }
  },
  "DefaultUserSettings": {
    "ExecutionRole": "<execution-role>",
    "RSessionAppSettings": {
      "CustomImages": [
        {
         "AppImageConfigName": "rstudio-custom-config",
         "ImageName": "rstudio-custom-image"
        }
      ]
     }
  },
  "AuthMode": "IAM"
}

  4. Créez le domaine avec l'image SageMaker AI personnalisée jointe.

    aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

    Réponse :

    {
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
    "Url": "https://domain-id.studio.region.sagemaker.aws/..."
}

Joindre l'image SageMaker AI à un domaine existant

Cette méthode suppose que vous êtes déjà intégré au domaine. Pour de plus amples informations, veuillez consulter Présentation du domaine Amazon SageMaker AI.

Note

Vous devez supprimer toutes les applications de votre domaine pour mettre à jour le domaine avec la nouvelle version de l'image. Pour plus d'informations sur la suppression de ces applications, consultez.Supprimer un domaine Amazon SageMaker AI.

Suivez les étapes ci-dessous pour ajouter l'image SageMaker AI à votre domaine actuel.

  • Obtenez le vôtre DomainID depuis la console SageMaker AI.

  • Utilisez le DomainID pour obtenir les DefaultUserSettings du domaine.

  • Ajoutez ImageName et AppImageConfig en tant que CustomImage aux DefaultUserSettings.

  • Mettez à jour votre domaine pour inclure l'image personnalisée.

Pour ajouter l'image SageMaker AI personnalisée à votre domaine

  1. Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d'administrateur.

  3. Sous Configurations d'administration, sélectionnez les domaines.

  4. Sélectionnez le domaine souhaité.

  5. Choisissez les paramètres du domaine.

  6. Dans Paramètres généraux, recherchez l'ID de domaine. L'ID est au format suivant : d-xxxxxxxxxxxx.

  7. Utilisez l'ID de domaine pour obtenir la description du domaine.

    aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

    Réponse :

    {
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

  8. Enregistrez la section DefaultUserSettings de la réponse dans un fichier nommé update-domain-input.json.

  9. Insérer la ImageName et AppImageConfigName des étapes précédentes en tant qu'image personnalisée. Étant donné que ImageVersionNumber n'est pas spécifié, la dernière version de l'image est utilisée, qui est la seule version dans ce cas.

    {
    "DefaultUserSettings": {
        "RSessionAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "rstudio-custom-image",
                 "AppImageConfigName": "rstudio-custom-config"
              }
           ]
        }
    }
}

  10. Utilisez l'ID de domaine et le fichier de paramètres utilisateur par défaut pour mettre à jour votre domaine.

    aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://update-domain-input.json

    Réponse :

    {
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}

  11. Supprimez l'application RStudioServerPro. Vous devez redémarrer l'application RStudioServerPro partagée de domaine pour que l'interface utilisateur du RStudio lanceur prenne en compte les dernières modifications.

    aws sagemaker delete-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

  12. Créez une nouvelle application RStudioServerPro. Vous devez créer cette application à l'aide de AWS CLI.

    aws sagemaker create-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

Sur cette page

Related resources

Amazon SageMaker AI Référence d'API
AWS CLI commandes pour Amazon SageMaker AI
SDKs et outils 

Related resources

Amazon SageMaker AI Référence d'API
AWS CLI commandes pour Amazon SageMaker AI
SDKs et outils 

Rubrique précédente :

Créer une image

Avez-vous besoin d’aide ?

ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.