Joindre une image SageMaker AI personnalisée - 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.

Joindre une image SageMaker AI personnalisée

Important

Les IAM politiques personnalisées qui autorisent Amazon SageMaker Studio ou Amazon SageMaker Studio Classic à 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 IAM politique 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.

Important

Depuis le 30 novembre 2023, l'expérience Amazon SageMaker Studio précédente s'appelle désormais Amazon SageMaker Studio Classic. La section suivante est spécifique à l'utilisation de l'application Studio Classic. Pour plus d'informations sur l'utilisation de l'expérience Studio mise à jour, consultezAmazon SageMaker Studio.

Pour utiliser une image SageMaker IA personnalisée, vous devez joindre une version de l'image à votre domaine ou à votre espace partagé. Lorsque vous joignez une version d'image, elle apparaît dans le lanceur SageMaker Studio Classic et est disponible dans la liste déroulante Sélectionner une image, que les utilisateurs utilisent pour lancer une activité ou modifier l'image utilisée par un bloc-notes.

Pour mettre une image SageMaker IA personnalisée à la disposition de tous les utilisateurs d'un domaine, vous devez associer l'image au domaine. Pour mettre une image à la disposition de tous les utilisateurs d'un espace partagé, vous pouvez l'attacher à l'espace partagé. Pour rendre une image accessible à un seul utilisateur, vous devez l'attacher au profil de l'utilisateur. Lorsque vous joignez une image, SageMaker AI utilise par défaut la dernière version de l'image. Vous pouvez également attacher une version d'image spécifique. Après avoir joint la version, vous pouvez choisir la version dans le lanceur SageMaker AI ou dans le sélecteur d'image lorsque vous lancez un bloc-notes.

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

Les sections suivantes montrent comment associer une image SageMaker AI personnalisée à votre domaine à l'aide de la console SageMaker AI ou du AWS CLI. Vous ne pouvez attacher une image personnalisée à un espace partagé qu'à l'aide d' AWS CLI.

Joindre l'image SageMaker AI à un domaine

Joindre l'image SageMaker AI à l'aide de la console

Cette rubrique décrit comment associer une version d'image SageMaker AI personnalisée existante à votre domaine à l'aide du panneau de configuration 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 connaître la procédure de création d'une image et d'une version d'image, veuillez consulter Création d'une image SageMaker AI personnalisée.

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. Sur la page Domaines, sélectionnez le domaine auquel vous souhaitez joindre l'image.

  5. Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Environment (Environnement).

  6. Dans l'onglet Environnement, sous Images SageMaker Studio Classic personnalisées associées au domaine, choisissez Joindre une image.

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

  8. Choisissez une image existante dans la liste.

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

  10. Choisissez Suivant.

  11. Vérifiez les valeurs pour Image name (Nom de l'image), Image display name (Nom d'affichage de l'image) et Description.

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

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

  14. Spécifiez le chemin de EFS montage. Il s'agit du chemin dans l'image pour monter le répertoire de base Amazon Elastic File System (EFS) de l'utilisateur.

  15. Pour Type d'image, sélectionnez Image SageMaker Studio

  16. Pour Kernel name (Nom du noyau), saisissez le nom d'un noyau existant dans l'image. Pour plus d'informations sur la façon d'obtenir les informations du noyau à partir de l'image, consultez DEVELOPMENTle référentiel d'exemples d'images personnalisés de SageMaker Studio Classic. Pour de plus amples informations, veuillez consulter les sections Découverte du noyau et Données utilisateur de Spécifications d'image SageMaker AI personnalisées.

  17. (Facultatif) Pour Kernel display name (Nom d'affichage du noyau), saisissez le nom d'affichage du noyau.

  18. Choisissez Add kernel (Ajouter le noyau).

  19. Sélectionnez Envoyer.

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

Joignez l'image SageMaker AI à l'aide du AWS CLI

Les sections suivantes montrent comment joindre une image SageMaker AI personnalisée lors de la création d'un nouveau domaine ou de la mise à jour de votre domaine existant à l'aide du AWS CLI.

Joindre l'image SageMaker AI à un nouveau domaine

La section suivante illustre comment créer un nouveau domaine avec la version attachée. Ces étapes nécessitent que vous spécifiiez les informations Amazon Virtual Private Cloud (VPC) et le rôle d'exécution requis pour créer le domaine. Vous devez effectuer les étapes suivantes pour créer le domaine et joindre l'image SageMaker AI personnalisée :

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

  • 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 VPC identifiant par défaut.

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

    La réponse devrait être similaire à ce qui suit.

    vpc-xxxxxxxx
  2. Obtenez votre sous-réseau par défaut IDs à l'aide de l'VPCID indiqué à l'étape précédente.

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

    La réponse devrait être similaire à ce qui suit.

    [ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ]
  3. Créez un fichier de configuration nommé create-domain-input.json. Insérez l'VPCID, le sous-réseau IDs et AppImageConfigName les étapes précédentes. ImageName É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.

    { "DomainName": "domain-with-custom-image", "VpcId": "<vpc-id>", "SubnetIds": [ "<subnet-ids>" ], "DefaultUserSettings": { "ExecutionRole": "<execution-role>", "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "custom-image", "AppImageConfigName": "custom-image-config" } ] } }, "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

    La réponse devrait être similaire à ce qui suit.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx", "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..." }

Joignez l'image SageMaker AI à votre domaine actuel

Si vous avez intégré un domaine SageMaker AI, vous pouvez associer l'image personnalisée à votre domaine actuel. Pour plus d'informations sur l'intégration dans un domaine SageMaker AI, consultezPrésentation du domaine Amazon SageMaker AI. Il n'est pas nécessaire de spécifier les VPC informations et le rôle d'exécution lorsque vous associez une image personnalisée à votre domaine actuel. Après avoir joint la version, vous devez supprimer toutes les applications de votre domaine et rouvrir Studio Classic. Pour obtenir des informations sur la suppression des applis, veuillez consulter Supprimer un domaine Amazon SageMaker AI.

Vous devez effectuer les étapes suivantes pour ajouter l'image SageMaker AI à votre domaine actuel.

  • Obtenez le vôtre DomainID depuis le panneau de commande 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. Sur la page Domaines, sélectionnez le domaine auquel vous souhaitez joindre l'image.

  5. Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Domain settings (Paramètres du domaine).

  6. Dans l'onglet Domain settings (Paramètres du domaine), sous General settings (Paramètres généraux), recherchez le DomainId. 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>

    La réponse devrait être similaire à ce qui suit.

    { "DomainId": "d-xxxxxxxxxxxx", "DefaultUserSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Enregistrez la section des paramètres utilisateur par défaut de la réponse dans un fichier nommé default-user-settings.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": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  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://default-user-settings.json

    La réponse devrait être similaire à ce qui suit.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Joindre l'image SageMaker AI à un espace partagé

Vous ne pouvez joindre l'image SageMaker AI à un espace partagé qu'à l'aide du AWS CLI. Après avoir joint la version, vous devez supprimer toutes les applications de votre espace partagé et rouvrir Studio Classic. Pour obtenir des informations sur la suppression des applis, veuillez consulter Supprimer un domaine Amazon SageMaker AI.

Vous devez effectuer les étapes suivantes pour ajouter l'image SageMaker AI à un espace partagé.

  • Obtenez le vôtre DomainID depuis le panneau de commande SageMaker AI.

  • Utilisez le DomainID pour obtenir les DefaultSpaceSettings du domaine.

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

  • Mettez à jour votre domaine de sorte à inclure l'image personnalisée pour l'espace partagé.

Pour ajouter l'image SageMaker AI personnalisée à votre espace partagé
  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. Sur la page Domaines, sélectionnez le domaine auquel vous souhaitez joindre l'image.

  5. Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Domain settings (Paramètres du domaine).

  6. Dans l'onglet Domain settings (Paramètres du domaine), sous General settings (Paramètres généraux), recherchez le DomainId. 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>

    La réponse devrait être similaire à ce qui suit.

    { "DomainId": "d-xxxxxxxxxxxx", ... "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ ], ... } } }
  8. Enregistrez la section des paramètres d'espace par défaut de la réponse dans un fichier nommé default-space-settings.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.

    { "DefaultSpaceSettings": { "KernelGatewayAppSettings": { "CustomImages": [ { "ImageName": "string", "AppImageConfigName": "string" } ], ... } } }
  10. Utilisez l'ID de domaine et le fichier des paramètres d'espace par défaut pour mettre à jour votre domaine.

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

    La réponse devrait être similaire à ce qui suit.

    { "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }

Afficher l'image ci-jointe dans SageMaker AI

Une fois que vous avez créé l'image SageMaker AI personnalisée et que vous l'avez attachée à votre domaine, l'image apparaît dans l'onglet Environnement du domaine. Vous pouvez uniquement afficher les images jointes pour les espaces partagés à AWS CLI l'aide de la commande suivante.

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