Joindre l' SageMaker image à un domaine Joindre l' SageMaker image à un espace partagé Voir l'image attachée

Joindre une SageMaker image personnalisée

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 plus d’informations, consultez Fournir des autorisations pour le balisage des ressources SageMaker.

AWS Politiques gérées pour Amazon SageMakerqui 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 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, 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 SageMaker image 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 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 choisir la version dans le SageMaker lanceur 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 SageMaker image personnalisée à votre domaine à l'aide de la SageMaker console 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 décrit comment associer une version d' SageMaker image personnalisée existante à votre domaine à l'aide du SageMaker panneau de configuration. 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, veuillez consulter Création d'une SageMaker image personnalisée.

Pour attacher une image existante

Ouvrez la SageMaker console Amazon à l'adresse https://console.aws.amazon.com/sagemaker/.
Dans le panneau de navigation de gauche, choisissez Configurations d'administrateur.
Sous Configurations d'administration, sélectionnez les domaines.
Sur la page Domaines, sélectionnez le domaine auquel associer l'image.
Sur la page Domain details (Détails du domaine), sélectionnez l'onglet Environment (Environnement).
Dans l'onglet Environnement, sous Images SageMaker Studio Classic personnalisées associé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 plus d’informations, consultez Création d'une SageMaker image personnalisée.
(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 DEVELOPMENT dans le référentiel d'échantillons 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 SageMaker d'image personnalisées.
(Facultatif) Pour Kernel display name (Nom d'affichage du noyau), saisissez le nom d'affichage du noyau.
Choisissez Add kernel (Ajouter le noyau).
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' 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 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 text

La 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 json

La 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, ImageName et AppImageConfigName dans les étapes 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.


{
    "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.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/..."
}

Joindre l' SageMaker image à votre domaine actuel

Si vous avez intégré un SageMaker domaine, vous pouvez associer l'image personnalisée à votre domaine actuel. Pour plus d'informations sur l'intégration à un SageMaker domaine, consultezVue d'ensemble SageMaker du domaine Amazon. 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 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 SageMaker domaine Amazon.

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

Obtenez le vôtre DomainID depuis SageMaker le panneau de commande.
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' SageMaker image personnalisée à votre domaine

Ouvrez la SageMaker console Amazon à l'adresse https://console.aws.amazon.com/sagemaker/.
Dans le panneau de navigation de gauche, choisissez Configurations d'administrateur.
Sous Configurations d'administration, sélectionnez les domaines.
Sur la page Domaines, sélectionnez le domaine auquel associer 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 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"
              }
           ],
           ...
        }
    }
}

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' SageMaker image à un espace partagé

Vous ne pouvez joindre l' SageMaker image à 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 SageMaker domaine Amazon.

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

Obtenez le vôtre DomainID depuis SageMaker le panneau de commande.
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' SageMaker image personnalisée à votre espace partagé

Ouvrez la SageMaker console Amazon à l'adresse https://console.aws.amazon.com/sagemaker/.
Dans le panneau de navigation de gauche, choisissez Configurations d'administrateur.
Sous Configurations d'administration, sélectionnez les domaines.
Sur la page Domaines, sélectionnez le domaine auquel associer 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.


{
    "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.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

Une fois que vous avez créé l' SageMaker image 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>

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Création d'une SageMaker image

Lancer une image personnalisée