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 SageMaker image personnalisée dans Amazon SageMaker Studio Classic
Important
Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer SageMaker des ressources Amazon doivent également autoriser l'ajout de 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 peuvent se produire lors de la tentative de création de ressources. AccessDenied 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 accordent 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.
Note
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 en savoir plus sur l’utilisation de l’expérience Studio mise à jour, consultez Amazon SageMaker Studio.
Studio Classic est toujours maintenu pour les charges de travail existantes, mais n'est plus disponible pour l'intégration. Vous pouvez uniquement arrêter ou supprimer des applications Studio Classic existantes et vous ne pouvez pas en créer de nouvelles. Nous vous recommandons de migrer votre charge de travail vers la nouvelle expérience Studio.
Pour utiliser une SageMaker image personnalisée, vous devez joindre une version de l'image à votre domaine ou à votre espace partagé. Lorsque vous joignez une version d'image, celle-ci 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 SageMaker image personnalisée à la disposition de tous les utilisateurs d'un domaine, vous devez joindre 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 la dernière version de l'image par défaut. Vous pouvez également attacher une version d’image spécifique. Après avoir joint la version, vous pouvez la choisir dans l' SageMaker AI Launcher 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 joindre une SageMaker image 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' SageMaker image à un domaine
Joindre l' SageMaker image à l'aide de la console
Cette rubrique explique comment associer une version d' SageMaker image personnalisée existante à votre domaine à l'aide du panneau de configuration SageMaker AI. Vous pouvez également créer une SageMaker image 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, consultez Création d'une SageMaker image personnalisée pour Amazon SageMaker Studio Classic.
Pour attacher une image existante
-
Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/
. -
Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.
-
Sous Configurations d’administrateur, choisissez Domaines.
-
Sur la page Domaines, sélectionnez le domaine auquel attacher l’image.
-
Sur la page Domain details (Détails du domaine), sélectionnez l’onglet Environment (Environnement).
-
Dans l'onglet Environnement, sous Images personnalisées de SageMaker Studio Classic attachées au domaine, choisissez Joindre une image.
-
Pour Source de l’image, choisissez Image existante.
-
Choisissez une image existante dans la liste.
-
Choisissez une version de l'image dans la liste.
-
Choisissez Suivant.
-
Vérifiez les valeurs pour Image name (Nom de l'image), Image display name (Nom d'affichage de l'image) et Description.
-
Choisissez le rôle IAM. Pour de plus amples informations, veuillez consulter Création d'une SageMaker image personnalisée pour Amazon SageMaker Studio Classic.
-
(Facultatif) Ajoutez des balises pour l’image.
-
Spécifiez le chemin de montage EFS. Il s'agit du chemin d'accès dans l'image pour monter le répertoire de base Amazon Elastic File System (EFS) de l'utilisateur.
-
Pour Type d'image, sélectionnez Image SageMaker Studio
-
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 https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md
DEVELOPMENT dans le référentiel SageMaker Studio Classic Custom Image Samples. Pour plus d’informations, consultez les sections Découverte du noyau et Données utilisateur de Spécifications SageMaker d'image personnalisées pour Amazon SageMaker Studio Classic. -
(Facultatif) Pour Nom d’affichage du noyau, saisissez le nom d’affichage du noyau.
-
Choisissez Add kernel (Ajouter le noyau).
-
Sélectionnez Soumettre.
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' SageMaker image à l'aide du AWS CLI
Les sections suivantes montrent comment joindre une SageMaker image 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' SageMaker image à un nouveau domaine
La section suivante illustre comment créer un nouveau domaine avec la version attachée. Cette procédure exige que vous spécifiiez les informations Amazon Virtual Private Cloud (Amazon VPC) et le rôle d'exécution requis pour créer le domaine. Pour créer le domaine et y joindre l' SageMaker image personnalisée, procédez comme suit :
Obtenez votre ID de VPC et vos ID de sous-réseau 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' SageMaker image personnalisée à votre domaine
-
Obtenez votre ID de VPC par défaut.
aws ec2 describe-vpcs \ --filters Name=isDefault,Values=true \ --query "Vpcs[0].VpcId" --output textLa réponse devrait être similaire à ce qui suit.
vpc-xxxxxxxx -
Obtenez vos ID de sous-réseau par défaut à l’aide de l’ID de VPC indiqué à l’étape précédente.
aws ec2 describe-subnets \ --filters Name=vpc-id,Values=<vpc-id>\ --query "Subnets[*].SubnetId" --output jsonLa réponse devrait être similaire à ce qui suit.
[ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ] -
Créez un fichier de configuration nommé
create-domain-input.json. Insérez l'ID de VPC, les ID de sous-réseau,ImageNameetAppImageConfigNamedans les étapes précédentes. Étant donné queImageVersionNumbern’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" } -
Créez le domaine avec l' SageMaker image personnalisée jointe.
aws sagemaker create-domain \ --cli-input-json file://create-domain-input.jsonLa 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' SageMaker image à votre domaine actuel
Si vous avez intégré un domaine SageMaker AI, vous pouvez joindre l'image personnalisée à votre domaine actuel. Pour plus d'informations sur l'intégration à un domaine d' SageMaker IA, consultezPrésentation du domaine Amazon SageMaker AI. Vous n’avez pas besoin de spécifier les informations de VPC ni le rôle d’exécution lorsque vous attachez une image personnalisée à votre domaine actuel. Après avoir attaché la version, vous devez supprimer toutes les applications de votre domaine et rouvrir Studio Classic. Pour obtenir des informations sur la suppression des applis, consultez Supprimer un domaine Amazon SageMaker AI.
Pour ajouter l' SageMaker image à votre domaine actuel, procédez comme suit.
Obtenez le vôtre
DomainIDdepuis le panneau de configuration SageMaker AI.Utilisez le
DomainIDpour obtenir lesDefaultUserSettingsdu domaine.Ajoutez
ImageNameetAppImageConfigen tant queCustomImageauxDefaultUserSettings.Mettez à jour votre domaine pour inclure l'image personnalisée.
Pour ajouter l' SageMaker image personnalisée à votre domaine
-
Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/
. -
Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.
-
Sous Configurations d’administrateur, choisissez Domaines.
-
Sur la page Domaines, sélectionnez le domaine auquel attacher l’image.
-
Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Domain settings (Paramètres du domaine).
-
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. -
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": [ ], ... } } } -
Enregistrez la section des paramètres utilisateur par défaut de la réponse dans un fichier nommé
default-user-settings.json. -
Insérer la
ImageNameetAppImageConfigNamedes étapes précédentes en tant qu'image personnalisée. Étant donné queImageVersionNumbern'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" } ], ... } } } -
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.jsonLa réponse devrait être similaire à ce qui suit.
{ "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx" }
Joindre l' SageMaker image à un espace partagé
Vous pouvez uniquement joindre l' SageMaker image à un espace partagé à l'aide du AWS CLI. Après avoir attaché 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, consultez Supprimer un domaine Amazon SageMaker AI.
Pour ajouter l' SageMaker image à un espace partagé, procédez comme suit.
Obtenez le vôtre
DomainIDdepuis le panneau de configuration SageMaker AI.Utilisez le
DomainIDpour obtenir lesDefaultSpaceSettingsdu domaine.Ajoutez
ImageNameetAppImageConfigen tant queCustomImageauxDefaultSpaceSettings.Mettez à jour votre domaine de sorte à inclure l'image personnalisée pour l'espace partagé.
Pour ajouter l' SageMaker image personnalisée à votre espace partagé
-
Ouvrez la console Amazon SageMaker AI à l'adresse https://console.aws.amazon.com/sagemaker/
. -
Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.
-
Sous Configurations d’administrateur, choisissez Domaines.
-
Sur la page Domaines, sélectionnez le domaine auquel attacher l’image.
-
Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Domain settings (Paramètres du domaine).
-
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. -
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": [ ], ... } } } -
Enregistrez la section des paramètres d'espace par défaut de la réponse dans un fichier nommé
default-space-settings.json. -
Insérer la
ImageNameetAppImageConfigNamedes étapes précédentes en tant qu’image personnalisée. Étant donné queImageVersionNumbern’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" } ], ... } } } -
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.jsonLa 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' SageMaker image personnalisée et 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>