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 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](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiques gérées pour Amazon SageMaker AI](security-iam-awsmanpol.md)qui 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 en savoir plus sur l’utilisation de l’expérience Studio mise à jour, consultez [Amazon SageMaker Studio](studio-updated.md).
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](studio-updated-migrate.md).
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 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 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 décrit 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](studio-byoi-create.md).
**Pour attacher une image existante**
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, choisissez **Configurations d’administrateur**.
1. Sous **Configurations d’administrateur**, choisissez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine auquel attacher l’image.
1. Sur la page **Domain details** (Détails du domaine), sélectionnez l’onglet **Environment** (Environnement).
1. Dans l'onglet **Environnement**, sous **Images SageMaker Studio Classic personnalisées associées au domaine**, choisissez **Joindre une image**.
1. Pour **Source de l’image**, choisissez **Image existante**.
1. Choisissez une image existante dans la liste.
1. Choisissez une version de l'image dans la liste.
1. Choisissez **Suivant**.
1. Vérifiez les valeurs pour **Image name** (Nom de l'image), **Image display name** (Nom d'affichage de l'image) et **Description**.
1. 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](studio-byoi-create.md).
1. (Facultatif) Ajoutez des balises pour l’image.
1. 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.
1. Pour **Type d'image**, sélectionnez **Image SageMaker Studio**
1. 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](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md) dans le référentiel d'échantillons d'images personnalisés de SageMaker Studio Classic. 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](studio-byoi-specs.md).
1. (Facultatif) Pour **Nom d’affichage du noyau**, saisissez le nom d’affichage du noyau.
1. Choisissez **Add kernel (Ajouter le noyau)**.
1. Sélectionnez **Soumettre**.
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. Vous devez effectuer les étapes suivantes pour créer le domaine et joindre l' SageMaker image 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' SageMaker image 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
```
La réponse devrait être similaire à ce qui suit.
```
vpc-xxxxxxxx
```
1. Obtenez votre sous-réseau par défaut IDs à l'aide de l'ID VPC indiqué à l'étape précédente.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values= \
--query "Subnets[*].SubnetId" --output json
```
La réponse devrait être similaire à ce qui suit.
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. 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.
```
{
"DomainName": "domain-with-custom-image",
"VpcId": "",
"SubnetIds": [
""
],
"DefaultUserSettings": {
"ExecutionRole": "",
"KernelGatewayAppSettings": {
"CustomImages": [
{
"ImageName": "custom-image",
"AppImageConfigName": "custom-image-config"
}
]
}
},
"AuthMode": "IAM"
}
```
1. 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 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, consultez[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md). 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](gs-studio-delete-domain.md).
Vous devez effectuer les étapes suivantes pour ajouter l' SageMaker image à 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' SageMaker image personnalisée à votre domaine**
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, choisissez **Configurations d’administrateur**.
1. Sous **Configurations d’administrateur**, choisissez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine auquel attacher l’image.
1. Sur la page **Domain details** (Détails du domaine), sélectionnez l'onglet **Domain settings** (Paramètres du domaine).
1. 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`.
1. Utilisez l’ID de domaine pour obtenir la description du domaine.
```
aws sagemaker describe-domain \
--domain-id
```
La réponse devrait être similaire à ce qui suit.
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Enregistrez la section des paramètres utilisateur par défaut de la réponse dans un fichier nommé `default-user-settings.json`.
1. 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"
}
],
...
}
}
}
```
1. 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 \
--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 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](gs-studio-delete-domain.md).
Vous devez effectuer les étapes suivantes pour ajouter l' SageMaker image à 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' SageMaker image personnalisée à votre espace partagé**
1. Ouvrez la console Amazon SageMaker AI à l'adresse [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Dans le panneau de navigation de gauche, choisissez **Configurations d’administrateur**.
1. Sous **Configurations d’administrateur**, choisissez **Domaines**.
1. Sur la page **Domaines**, sélectionnez le domaine auquel attacher l’image.
1. Sur la page **Domain details** (Détails du domaine), sélectionnez l'onglet **Domain settings** (Paramètres du domaine).
1. 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`.
1. Utilisez l’ID de domaine pour obtenir la description du domaine.
```
aws sagemaker describe-domain \
--domain-id
```
La réponse devrait être similaire à ce qui suit.
```
{
"DomainId": "d-xxxxxxxxxxxx",
...
"DefaultSpaceSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Enregistrez la section des paramètres d'espace par défaut de la réponse dans un fichier nommé `default-space-settings.json`.
1. 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"
}
],
...
}
}
}
```
1. 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 \
--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' 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
```