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.
# Éditeur de code dans Amazon SageMaker Studio
L’éditeur de code, basé sur [Code-OSS, Visual Studio Code – Open Source](https://github.com/microsoft/vscode#visual-studio-code---open-source-code---oss), vous aide à écrire, tester, déboguer et exécuter votre code d’analytique et de machine learning. L'éditeur de code s'étend et est entièrement intégré à Amazon SageMaker Studio. Il prend également en charge les extensions d’environnement de développement intégré (IDE) disponibles dans le [registre Open VSX](https://open-vsx.org/). La page suivante fournit des informations sur l’éditeur de code et les principaux détails de son utilisation.
Code Editor possède l'extension [AWS Toolkit for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) préinstallée, qui permet de se connecter Services AWS à un générateur de code à usage général basé sur l'apprentissage automatique qui fournit des recommandations de code en temps réel. [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html) Pour plus d’informations sur les extensions, consultez [Connexions et extensions de l’éditeur de code](code-editor-use-connections-and-extensions.md).
**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’expérience Studio mise à jour. Pour en savoir plus sur l’utilisation de l’application Studio Classic, consultez [Amazon SageMaker Studio classique](studio.md).
Pour lancer l’éditeur de code, créez un espace privé de l’éditeur de code. L’espace de l’éditeur de code utilise une instance Amazon Elastic Compute Cloud (Amazon EC2) pour vos calculs et un volume Amazon Elastic Block Store (Amazon EBS) individuel pour votre stockage. Tout ce qui se trouve dans votre espace, comme votre code, votre profil Git et les variables d’environnement, est stocké sur le même volume Amazon EBS. Le volume dispose de 3 000 IOPS et d'un débit de 125. MBps Votre administrateur a configuré les paramètres de stockage Amazon EBS par défaut pour votre espace.
La taille de stockage par défaut est de 5 Go, mais votre administrateur peut augmenter la quantité d’espace dont vous disposez. Pour de plus amples informations, veuillez consulter [Modification de la taille de stockage par défaut](code-editor-admin-storage-size.md).
Le répertoire de travail de vos utilisateurs dans le volume de stockage est `/home/sagemaker-user`. Si vous spécifiez votre propre AWS KMS clé pour chiffrer le volume, tout le contenu du répertoire de travail est chiffré à l'aide de votre clé gérée par le client. Si vous ne spécifiez aucune AWS KMS clé, les données qu'elles contiennent `/home/sagemaker-user` sont chiffrées à l'aide d'une clé AWS gérée. Que vous spécifiiez ou non une AWS KMS clé, toutes les données situées en dehors du répertoire de travail sont chiffrées à l'aide d'une clé AWS gérée.
Vous pouvez augmenter ou réduire verticalement votre capacité de calcul en modifiant le type d’instance Amazon EC2 qui exécute votre application d’éditeur de code. Avant de modifier le type d’instance associé, vous devez d’abord arrêter votre espace d’éditeur de code. Pour de plus amples informations, veuillez consulter [Instances et images de l’application d’éditeur de code](code-editor-use-instances.md).
Votre administrateur peut vous fournir une configuration de cycle de vie pour personnaliser votre environnement. Vous pouvez spécifier la configuration de cycle de vie lorsque vous créez l’espace. Pour de plus amples informations, veuillez consulter [Configurations du cycle de vie de l’éditeur de code](code-editor-use-lifecycle-configurations.md).
Vous pouvez également apporter votre propre système de stockage de fichiers si vous possédez un volume Amazon EFS.
![\[La page d’accueil de l’interface utilisateur de l’application d’éditeur de code.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-home.png)
**Topics**
+ [Utilisation de l’éditeur de code](code-editor-use.md)
+ [Guide de l’administrateur de l’éditeur de code](code-editor-admin.md)
# Utilisation de l’éditeur de code
Les rubriques de cette section fournissent des guides d'utilisation de l'éditeur de code, notamment comment lancer Services AWS, ajouter des connexions, arrêter des ressources, etc. Après avoir créé un espace d’éditeur de code, vous pouvez accéder à votre session d’éditeur de code directement via le navigateur.
Dans votre environnement d’éditeur de code, vous pouvez effectuer les opérations suivantes :
+ Accéder à tous les artefacts conservés dans votre répertoire personnel
+ Clonez vos GitHub référentiels et validez les modifications
+ Accédez au SageMaker Python SDK
Vous pouvez retourner dans Studio pour passer en revue toutes les ressources créées dans votre environnement d’éditeur de code, telles que les expériences, les pipelines ou les tâches d’entraînement.
**Topics**
+ [Vérification de la version de l’éditeur de code](code-editor-use-version.md)
+ [Instances et images de l’application d’éditeur de code](code-editor-use-instances.md)
+ [Lancement d’une application d’éditeur de code dans Studio](code-editor-use-studio.md)
+ [Lancez une application d'éditeur de code à l'aide du AWS CLI](code-editor-launch-cli.md)
+ [Clonage d’un référentiel dans l’éditeur de code](code-editor-use-clone-a-repository.md)
+ [Connexions et extensions de l’éditeur de code](code-editor-use-connections-and-extensions.md)
+ [Arrêt des ressources de l’éditeur de code](code-editor-use-log-out.md)
# Vérification de la version de l’éditeur de code
Les étapes suivantes montrent comment vérifier la version de votre application d’éditeur de code.
**Pour vérifier la version de l’application d’éditeur de code**
1. Lancez et exécutez un espace d’éditeur de code et accédez à l’interface utilisateur de l’application d’éditeur de code. Pour de plus amples informations, veuillez consulter [Lancement d’une application d’éditeur de code dans Studio](code-editor-use-studio.md).
1. Dans le coin supérieur gauche de l’interface utilisateur de l’éditeur de code, choisissez le bouton de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-menu-icon.png)). Choisissez ensuite **Aide**. Ensuite, choisissez **À propos**.
# Instances et images de l’application d’éditeur de code
Seules certaines instances sont compatibles avec les applications de l’éditeur de code. Vous pouvez choisir le type d’instance compatible avec votre cas d’utilisation dans le menu déroulant **Instance**.
Les instances à **lancement rapide** démarrent beaucoup plus rapidement que les autres instances. Pour plus d’informations sur les types d’instances à lancement rapide dans Studio, [Types d'instances disponibles pour une utilisation avec les blocs-notes Amazon SageMaker Studio Classic](notebooks-available-instance-types.md).
**Note**
Si vous utilisez un type d’instance GPU lors de la configuration de votre application d’éditeur de code, vous devez également utiliser une image basée sur le GPU. L’interface utilisateur de l’espace d’éditeur de code sélectionne automatiquement une image compatible lorsque vous sélectionnez votre type d’instance.
Dans un espace, vos données sont stockées dans un volume Amazon EBS qui persiste indépendamment de la vie d’une instance. Vous ne perdrez pas vos données en changeant les instances. Si votre espace d’éditeur de code est `Running`, vous devez arrêter cet espace avant de modifier les types d’instance.
Le tableau suivant répertorie les images CPU et GPU ARNs de l'éditeur de code disponibles pour chaque région.
| Région | CPU | GPU |
| --- | --- | --- |
| us-east-1 | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-1:885854791233:image/sagemaker-distribution-gpu |
| us-east-2 | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-east-2:37914896644:image/sagemaker-distribution-gpu |
| us-west-1 | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-1:053634841547:image/sagemaker-distribution-gpu |
| us-west-2 | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-west-2:542918446943:image/sagemaker-distribution-gpu |
| af-south-1 | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-cpu | arn:aws:sagemaker:af-south-1:238384257742:image/sagemaker-distribution-gpu |
| ap-east-1 | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-east-1:523751269255:image/sagemaker-distribution-gpu |
| ap-south-1 | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-south-1:245090515133:image/sagemaker-distribution-gpu |
| ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-2:064688005998:image/sagemaker-distribution-gpu |
| ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-1:022667117163:image/sagemaker-distribution-gpu |
| ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-2:648430277019:image/sagemaker-distribution-gpu |
| ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-1:010972774902:image/sagemaker-distribution-gpu |
| ca-central-1 | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ca-central-1:481561238223:image/sagemaker-distribution-gpu |
| eu-central-1 | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-central-1:545423591354:image/sagemaker-distribution-gpu |
| eu-west-1 | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-1:819792524951:image/sagemaker-distribution-gpu |
| eu-west-2 | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-2:021081402939:image/sagemaker-distribution-gpu |
| eu-west-3 | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-west-3:856416204555:image/sagemaker-distribution-gpu |
| eu-north-1 | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-north-1:175620155138:image/sagemaker-distribution-gpu |
| eu-south-1 | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-cpu | arn:aws:sagemaker:eu-south-1:810671768855:image/sagemaker-distribution-gpu |
| sa-east-1 | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-cpu | arn:aws:sagemaker:sa-east-1:567556641782:image/sagemaker-distribution-gpu |
| ap-northeast-3 | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-northeast-3:564864627153:image/sagemaker-distribution-gpu |
| ap-southeast-3 | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-cpu | arn:aws:sagemaker:ap-southeast-3:370607712162:image/sagemaker-distribution-gpu |
| me-south-1 | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-south-1:523774347010:image/sagemaker-distribution-gpu |
| me-central-1 | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-cpu | arn:aws:sagemaker:me-central-1:358593528301:image/sagemaker-distribution-gpu |
| il-central-1 | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-cpu | arn:aws:sagemaker:il-central-1:080319125002:image/sagemaker-distribution-gpu |
| cn-north-1 | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-north-1:674439102856:image/sagemaker-distribution-gpu |
| cn-northwest-1 | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-cpu | arn:aws:sagemaker:cn-northwest-1:651871951035:image/sagemaker-distribution-gpu |
| us-gov-west-1 | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-west-1:300992924816:image/sagemaker-distribution-gpu |
| us-gov-east-1 | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-cpu | arn:aws:sagemaker:us-gov-east-1:300993876623:image/sagemaker-distribution-gpu |
Si vous rencontrez des limites d’instances, contactez votre administrateur. Pour obtenir plus de stockage et de calcul pour un utilisateur, les administrateurs peuvent demander une augmentation de ses AWS quotas. Pour plus d'informations sur la demande d'augmentation de quota, consultez [Amazon SageMaker AI Endpoints and Quotas](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).
# Lancement d’une application d’éditeur de code dans Studio
Pour configurer et accéder à votre environnement de développement intégré d’éditeur de code via Studio, vous devez créer un espace d’éditeur de code. Pour plus d’informations sur les espaces dans Studio, consultez [Espaces Amazon SageMaker Studio](studio-updated-spaces.md).
![\[Bouton de l’application d’éditeur de code et vignette d’aperçu dans l’interface utilisateur de Studio.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-studio-home.png)
La procédure suivante montre comment créer et exécuter un espace d’éditeur de code.
**Pour créer et exécuter un espace d’éditeur de code**
1. Lancez l’expérience Studio mise à jour. Pour plus d'informations, consultez [Lancer Amazon SageMaker Studio](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-launch.html).
1. Effectuez l’une des actions suivantes :
+ Dans l'interface utilisateur Amazon SageMaker Studio mise à jour, sélectionnez **Code Editor** dans le menu **Applications**.
+ Dans l'interface utilisateur Amazon SageMaker Studio mise à jour, choisissez **Afficher les espaces de l'éditeur de code** dans la section **Vue d'ensemble** de la page d'accueil de Studio.
1. Dans l’angle supérieur droit de la page de destination de l’éditeur de code, choisissez **Créer un espace d’éditeur de code**.
1. Saisissez un nom pour votre espace d’éditeur de code. Ce nom doit comporter entre 1 et 62 caractères, uniquement des lettres, des chiffres et des traits d’union.
1. Choisissez **Créer un espace**.
1. Une fois l’espace créé, vous disposez de plusieurs options avant de décider de l’exécuter :
+ Vous pouvez modifier les paramètres **Stockage (Go)**, **Configuration du cycle de vie** ou **Attacher le système de fichiers EFS personnalisé**. Les options pour ces paramètres sont disponibles en fonction de la spécification de l’administrateur.
+ Dans le menu déroulant **Instance**, vous pouvez choisir le type d’instance le plus compatible avec votre cas d’utilisation. Dans le menu déroulant **Image**, vous pouvez choisir une image de SageMaker distribution ou une image personnalisée fournie par votre administrateur.
**Note**
Le fait de basculer entre les images de distribution de SageMaker modifie la version sous-jacente utilisée de l’éditeur de code, ce qui peut entraîner des incompatibilités dues à la mise en cache du navigateur. Vous devez vider le cache du navigateur lorsque vous passez d’une image à l’autre.
Si vous utilisez un type d’instance GPU lors de la configuration de votre application d’éditeur de code, vous devez également utiliser une image basée sur le GPU. Dans un espace, vos données sont stockées dans un volume Amazon EBS qui persiste indépendamment de la vie d’une instance. Vous ne perdrez pas vos données en changeant les instances.
**Important**
Les politiques IAM personnalisées qui permettent aux utilisateurs de Studio de créer des espaces doivent également accorder l’autorisation de répertorier des images (`sagemaker: ListImage`) afin de visualiser des images personnalisées. Pour ajouter l’autorisation, consultez [Ajout ou suppression d’autorisations d’identité](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le Guide de l’utilisateur *Gestion des identités et des accès AWS*.
[AWS politiques gérées pour Amazon SageMaker AI](security-iam-awsmanpol.md)qui donnent des autorisations pour créer des ressources d' SageMaker IA incluent déjà des autorisations pour répertorier des images lors de la création de ces ressources.
**Note**
Pour mettre à jour les paramètres d’espace, vous devez d’abord arrêter votre espace. Si votre éditeur de code utilise une NVMe instance avec des magasins d'instances, toutes les données stockées dans le NVMe magasin sont supprimées lorsque l'espace est arrêté.
1. Après avoir mis à jour vos paramètres, choisissez **Exécuter Space** dans la page détaillée de l’espace.
1. Lorsque le statut de l’espace est `Running`, choisissez **Ouvrir l’éditeur de code** pour accéder à votre session d’éditeur de code.
![\[Page des détails de l’espace d’une application d’éditeur de code dans l’interface utilisateur de Studio.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-open.png)
# Lancez une application d'éditeur de code à l'aide du AWS CLI
Pour configurer et accéder à votre environnement de développement intégré d’éditeur de code via l’ AWS Command Line Interface (AWS CLI), vous devez créer un espace d’éditeur de code. Assurez-vous de respecter les [Exécuter les opérations prérequises](code-editor-admin-prerequisites.md) avant d’appliquer les étapes suivantes. Utilisez la procédure suivante pour créer et exécuter un espace d’éditeur de code.
**Pour créer et exécuter un espace d’éditeur de code**
1. Accédez à un espace à l'aide de Gestion des identités et des accès AWS (IAM) ou AWS IAM Identity Center d'une authentification. Pour plus d'informations sur l'accès aux espaces à l'aide du AWS CLI, consultez la section *Accès aux espaces à l'aide du AWS Command Line Interface* in[Espaces Amazon SageMaker Studio](studio-updated-spaces.md).
1. Créez une application et spécifiez `CodeEditor` comme `app-type` à l’aide de la commande suivante.
Si vous utilisez un type d’instance GPU lors de la création de votre application d’éditeur de code, vous devez également utiliser une image basée sur le GPU.
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:account-id:image/sagemaker-distribution-cpu"
```
Pour plus d'informations sur l'image de l'éditeur de code disponible ARNs, consultez[Instances et images de l’application d’éditeur de code](code-editor-use-instances.md).
1. Une fois l’application d’éditeur de code en service, lancez-la à l’aide d’une URL présignée. Vous pouvez utiliser l’API `describe-app` pour vérifier si votre application est en service. Utilisez l’API `create-presigned-domain-url` pour créer une URL présignée :
```
aws sagemaker create-presigned-domain-url \
--domain-id domain-id \
--space-name space-name \
--user-profile-name user-profile-name \
--session-expiration-duration-in-seconds 43200 \
--landing-uri app:CodeEditor:
```
1. Ouvrez l’URL générée pour commencer à travailler dans votre application d’éditeur de code.
# Clonage d’un référentiel dans l’éditeur de code
Vous pouvez parcourir les dossiers et cloner un référentiel dans la fenêtre **Explorateur** de l’interface utilisateur de l’application d’éditeur de code.
Pour cloner un référentiel, procédez comme suit :
**Pour cloner un référentiel**
1. Ouvrez votre application d’éditeur de code dans le navigateur, puis choisissez le bouton **Exploration** (![\[Icon representing multiple documents or pages stacked on top of each other.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-exploration-icon.png)) dans le volet de navigation de gauche.
1. Choisissez **Cloner le référentiel** dans la fenêtre **Explorateur**. Indiquez ensuite l’URL du référentiel ou sélectionnez une source de référentiel dans l’invite.
1. Choisissez un dossier dans lequel cloner votre référentiel. Notez que le dossier de l’éditeur de code par défaut est `/home/sagemaker-user/`. Le clonage de votre référentiel peut prendre un certain temps.
1. Pour ouvrir le référentiel cloné, choisissez **Ouvrir dans une nouvelle fenêtre** ou **Ouvrir**.
1. Pour revenir à la page d’accueil de l’interface utilisateur de l’application d’éditeur de code, choisissez **Annuler**.
1. Dans le référentiel, une invite vous demande si vous faites confiance aux auteurs des fichiers de votre nouveau référentiel. Vous avez deux options :
1. Pour faire confiance au dossier et activer toutes les fonctionnalités, choisissez **Oui, je fais confiance aux auteurs**.
1. Pour parcourir le contenu du référentiel en *mode restreint*, choisissez **Non, je ne fais pas confiance aux auteurs**.
En mode restreint, les tâches ne sont pas autorisées à s’exécuter, le débogage est désactivé, les paramètres de l’espace de travail ne sont pas appliqués et les extensions ont des fonctionnalités limitées.
Pour quitter le mode restreint, faites confiance aux auteurs de tous les fichiers de votre dossier actuel ou de son dossier parent, et activez toutes les fonctionnalités, choisissez **Gérer** dans la bannière **Mode restreint**.
# Connexions et extensions de l’éditeur de code
L'éditeur de code prend en charge les connexions IDE Services AWS ainsi que les extensions disponibles dans le [registre Open VSX](https://open-vsx.org/).
## Connexions à AWS
Les environnements de l’éditeur de code sont intégrés à [AWS Toolkit pour VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) pour ajouter des connexions aux Services AWS. Pour commencer à établir des connexions à Services AWS, vous devez disposer d'informations d'identification Gestion des identités et des accès AWS (IAM) valides. Pour plus d'informations, consultez [Authentification et accès pour le AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).
Dans votre environnement d’éditeur de code, vous pouvez ajouter des connexions pour :
+ [AWS Explorateur](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/aws-explorer.html) : visualisez, modifiez et déployez AWS des ressources dans Amazon S3 CloudWatch, etc.
L'accès à certaines fonctionnalités d' AWS Explorer nécessite certaines AWS autorisations. Pour plus d'informations, consultez [Authentification et accès pour le AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/establish-credentials.html).
+ [Amazon CodeWhisperer](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codewhisperer.html) : créez des applications plus rapidement grâce aux suggestions de code basées sur l’IA.
Pour l'utiliser Amazon CodeWhisperer avec l'éditeur de code, vous devez ajouter les autorisations suivantes à votre rôle d'exécution SageMaker AI.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CodeWhispererPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
Pour plus d’informations, consultez [Création de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) et [Ajout et suppression d’autorisations basées sur l’identité IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l’utilisateur IAM*.
## Extensions
L’éditeur de code prend en charge les extensions de l’IDE disponibles dans le [registre Open VSX](https://open-vsx.org/).
Pour commencer à utiliser les extensions dans votre environnement d’éditeur de code, choisissez l’icône **Extensions** (![\[Icon showing two overlapping squares representing multiple windows or instances.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-extensions-icon.png)) dans le volet de navigation de gauche. Ici, vous pouvez configurer les connexions à AWS en installant AWS Toolkit. Pour plus d’informations, consultez [Installing the AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-toolkit.html) (Installation de).
Dans la barre de recherche, vous pouvez rechercher directement des extensions supplémentaires via le [registre Open VSX](https://open-vsx.org/), telles que AWS Toolkit, Jupyter, Python, etc.
# Arrêt des ressources de l’éditeur de code
Lorsque vous avez fini d’utiliser un espace d’éditeur de code, vous pouvez utiliser Studio pour l’arrêter. De cette façon, vous arrêtez d’encourir des coûts pour l’espace.
Vous pouvez également supprimer les ressources inutilisées de l’éditeur de code en utilisant l’ AWS CLI.
## Arrêt de votre espace d’éditeur de code à l’aide de Studio
Pour arrêter votre espace d’éditeur de code dans Studio, procédez comme suit :
**Pour arrêter votre espace d’éditeur de code dans Studio**
1. Revenez à la page de destination de l’éditeur de code en effectuant l’une des opérations suivantes :
1. Dans la barre de navigation, dans le coin supérieur gauche, choisissez **Éditeur de code**.
1. Dans le volet de navigation de gauche, vous pouvez également choisir **Éditeur de code** dans le menu **Applications**.
1. Recherchez le nom de l’espace d’éditeur de code que vous avez créé. Si le statut de votre espace est **En cours d’utilisation**, choisissez **Arrêter** dans la colonne **Action**. Vous pouvez également arrêter votre espace directement sur la page des détails de l’espace en choisissant **Arrêter l’espace**. L’espace peut prendre un certain temps pour s’arrêter.
![\[Page des détails de l’espace dans l’interface utilisateur de l’application d’éditeur de code.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-stop-space.png)
Les ressources supplémentaires telles que les points de terminaison SageMaker AI, les clusters Amazon EMR (Amazon EMR) et les compartiments Amazon Simple Storage Service (Amazon S3) créés à partir de Studio ne sont pas automatiquement supprimées lorsque votre instance spatiale s'arrête. Pour ne plus accumuler de frais liés aux ressources, supprimez toutes les ressources supplémentaires. Pour plus d’informations, consultez [Suppression des ressources inutilisées](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-clean-up.html).
## Supprimez les ressources de l'éditeur de code à l'aide du AWS CLI
Vous pouvez supprimer votre application Code Editor et votre espace à l'aide du AWS Command Line Interface (AWS CLI).
+ [DeleteApp](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteApp.html)
+ [DeleteSpace](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteSpace.html)
# Guide de l’administrateur de l’éditeur de code
Vous pouvez utiliser l’éditeur de code avec une instance à la demande pour accélérer le démarrage et configurer le stockage. Vous pouvez lancer une application d'éditeur de code via Amazon SageMaker Studio ou via le AWS CLI. Vous pouvez également modifier les paramètres par défaut de l’éditeur de code dans la console de domaine. Pour de plus amples informations, veuillez consulter [Modification des paramètres du domaine](domain-edit.md). Les rubriques suivantes décrivent comment les administrateurs peuvent configurer l’éditeur de code, basé sur Code-OSS, Visual Studio Code – Open Source, en modifiant les options de stockage, en personnalisant les environnements et en gérant l’accès des utilisateurs, ainsi qu’en fournissant des informations sur les conditions préalables requises pour utiliser l’éditeur de code.
**Topics**
+ [Exécuter les opérations prérequises](code-editor-admin-prerequisites.md)
+ [Octroi à vos utilisateurs d’un accès à des espaces privés](code-editor-admin-user-access.md)
+ [Modification de la taille de stockage par défaut](code-editor-admin-storage-size.md)
+ [Configurations du cycle de vie de l’éditeur de code](code-editor-use-lifecycle-configurations.md)
+ [Images personnalisées](code-editor-custom-images.md)
# Exécuter les opérations prérequises
Pour utiliser l’éditeur de code, basé sur Code-OSS, Visual Studio Code – Open Source, vous devez remplir les conditions préalables requises suivantes.
1. Vous devez d'abord vous connecter au domaine Amazon SageMaker AI et créer un profil utilisateur. Pour de plus amples informations, veuillez consulter [Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md).
1. Si vous interagissez avec votre application d'éditeur de code à l'aide du AWS CLI, vous devez également remplir les conditions préalables suivantes.
1. Mettez à jour le AWS CLI en suivant les étapes de [la section Installation de la AWS CLI version actuelle](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html#install-tool-bundled).
1. À partir de votre ordinateur local, exécutez `aws configure` et fournissez vos informations d’identification AWS . Pour plus d'informations sur les AWS informations d'identification, voir [Comprendre et obtenir vos AWS informations d'identification](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html).
1. (Facultatif) Pour obtenir davantage de stockage et de calcul pour votre application, vous pouvez demander une augmentation de vos AWS quotas. Pour plus d'informations sur la demande d'augmentation de quota, consultez [Amazon SageMaker AI Endpoints and Quotas](https://docs.aws.amazon.com/general/latest/gr/sagemaker.html).
# Octroi à vos utilisateurs d’un accès à des espaces privés
**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.
Cette section fournit une politique qui accorde aux utilisateurs l’accès à des espaces privés. Vous pouvez également utiliser cette politique pour restreindre les espaces privés et les applications qui y sont associés au propriétaire associé au profil utilisateur.
Vous devez fournir des autorisations à vos utilisateurs aux éléments suivants :
+ Espaces privés
+ Profil utilisateur requis pour accéder aux espaces privés
Pour fournir des autorisations, attachez la politique suivante aux rôles IAM de vos utilisateurs.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioCreatePresignedDomainUrlForUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreatePresignedDomainUrl"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
{
"Sid": "SMStudioAppPermissionsListAndDescribe",
"Effect": "Allow",
"Action": [
"sagemaker:ListApps",
"sagemaker:ListDomains",
"sagemaker:ListUserProfiles",
"sagemaker:ListSpaces",
"sagemaker:DescribeApp",
"sagemaker:DescribeDomain",
"sagemaker:DescribeUserProfile",
"sagemaker:DescribeSpace"
],
"Resource": "*"
},
{
"Sid": "SMStudioAppPermissionsTagOnCreate",
"Effect": "Allow",
"Action": [
"sagemaker:AddTags"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:*/*",
"Condition": {
"Null": {
"sagemaker:TaggingAction": "false"
}
}
},
{
"Sid": "SMStudioRestrictSharedSpacesWithoutOwners",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioRestrictSpacesToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/domain-id/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private",
"Shared"
]
}
}
},
{
"Sid": "SMStudioRestrictCreatePrivateSpaceAppsToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/domain-id/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/domain-id/user-profile-name"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private"
]
}
}
}
]
}
```
------
# Modification de la taille de stockage par défaut
Vous pouvez modifier les paramètres de stockage par défaut de vos utilisateurs. Vous pouvez également modifier les paramètres de stockage par défaut en fonction des exigences de votre organisation et des besoins de vos utilisateurs.
Pour modifier la taille de stockage de vos utilisateurs, procédez comme suit :
1. Mettez à jour les paramètres de stockage Amazon EBS dans le domaine.
1. Créez un profil utilisateur et spécifiez les paramètres de stockage qu’il contient.
Utilisez la commande suivante AWS Command Line Interface (AWS CLI) pour mettre à jour le domaine.
```
aws --region $REGION sagemaker update-domain \
--domain-id $DOMAIN_ID \
--default-user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":5,
"MaximumEbsVolumeSizeInGb":100
}
}
}'
```
Utilisez la AWS CLI commande suivante pour créer le profil utilisateur et définir les paramètres de stockage par défaut.
```
aws --region $REGION sagemaker create-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":5,
"MaximumEbsVolumeSizeInGb":100
}
}
}'
```
Utilisez les AWS CLI commandes suivantes pour mettre à jour les paramètres de stockage par défaut dans le profil utilisateur.
```
aws --region $REGION sagemaker update-user-profile \
--domain-id $DOMAIN_ID \
--user-profile-name $USER_PROFILE_NAME \
--user-settings '{
"SpaceStorageSettings": {
"DefaultEbsStorageSettings":{
"DefaultEbsVolumeSizeInGb":25,
"MaximumEbsVolumeSizeInGb":200
}
}
}'
```
# Configurations du cycle de vie de l’éditeur de code
Vous pouvez utiliser les configurations de cycle de vie de l’éditeur de code pour automatiser la personnalisation de votre environnement Studio. Cette personnalisation comprend l’installation de packages personnalisés, la configuration d’extensions, le préchargement de jeux de données et la configuration de référentiels de code source.
Les instructions suivantes utilisent le AWS Command Line Interface (AWS CLI) pour créer, attacher, déboguer et détacher des configurations de cycle de vie pour le type `CodeEditor` d'application :
+ [Création et attachement de configurations de cycle de vie dans Studio](code-editor-use-lifecycle-configurations-studio-create.md)
+ [Débogage des configurations de cycle de vie dans Studio](code-editor-use-lifecycle-configurations-studio-debug.md)
+ [Détachement des configurations de cycle de vie dans Studio](code-editor-use-lifecycle-configurations-studio-detach.md)
# Création et attachement de configurations de cycle de vie dans Studio
La section suivante fournit des AWS CLI commandes permettant de créer une configuration de cycle de vie, d'associer une configuration de cycle de vie lors de la création d'un nouveau profil utilisateur et d'associer une configuration de cycle de vie lors de la mise à jour d'un profil utilisateur. Pour connaître les conditions préalables et les étapes générales relatives à la création et à l’attachement de configurations de cycle de vie dans Studio, consultez [Création d’une configuration de cycle de vie](jl-lcc-create.md).
Lorsque vous créez votre configuration de cycle de vie Studio à l’aide de la commande `create-studio-lifecycle-config`, assurez-vous de spécifier que `studio-lifecycle-config-app-type` est `CodeEditor`. L’exemple suivant montre comment créer une nouvelle configuration de cycle de vie Studio pour votre application d’éditeur de code.
```
aws sagemaker create-studio-lifecycle-config \
--studio-lifecycle-config-name my-code-editor-lcc \
--studio-lifecycle-config-content $LCC_CONTENT \
--studio-lifecycle-config-app-type CodeEditor
```
Notez l’ARN de la configuration de cycle de vie nouvellement créée qui est renvoyée. Lorsque vous attachez une configuration de cycle de vie, fournissez cet ARN dans la liste `LifecycleConfigArns` de `CodeEditorAppSettings`.
Vous pouvez attacher une configuration de cycle de vie lors de la création d’un profil utilisateur ou d’un domaine. L’exemple suivant montre comment créer un profil utilisateur auquel la configuration du cycle de vie est attachée. Vous pouvez également créer un nouveau domaine avec une configuration de cycle de vie attachée à l’aide de la commande [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/create-domain.html).
```
# Create a new UserProfile
aws sagemaker create-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
Vous pouvez également attacher une configuration de cycle de vie lors de la mise à jour d’un profil utilisateur ou d’un domaine. L’exemple suivant montre comment mettre à jour un profil utilisateur auquel la configuration de cycle de vie est attachée. Vous pouvez également mettre à jour un nouveau domaine avec une configuration de cycle de vie attachée à l’aide de la commande [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html).
```
# Update a UserProfile
aws sagemaker update-user-profile \
--domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[lifecycle-configuration-arn-list]
}
}'
```
# Débogage des configurations de cycle de vie dans Studio
Pour déboguer des scripts de configuration de cycle de vie pour l’éditeur de code, vous devez utiliser Studio. Pour des instructions sur le débogage des configurations de cycle de vie dans Studio, consultez [Débogage des configurations de cycle de vie](jl-lcc-debug.md). Pour trouver les journaux d’une application spécifique, recherchez les flux de journaux en utilisant le format suivant :
```
domain-id/space-name/CodeEditor/default/LifecycleConfigOnStart
```
# Détachement des configurations de cycle de vie dans Studio
Pour détacher des configurations de cycle de vie pour l’éditeur de code, vous pouvez utiliser la console ou l’ AWS CLI. Pour connaître les étapes à suivre pour détacher les configurations de cycle de vie de la console Studio, consultez [Détachement des configurations de cycle de vie](jl-lcc-delete.md).
Pour détacher une configuration de cycle de vie à l'aide de AWS CLI, supprimez la configuration de cycle de vie souhaitée de la liste des configurations de cycle de vie associées à la ressource. Transmettez ensuite la liste dans le cadre de la commande respective :
+ [update-user-profile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-user-profile.html)
+ [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html)
Par exemple, la commande suivante supprime toutes les configurations de cycle de vie pour l’application d’éditeur de code attachée au domaine.
```
aws sagemaker update-domain --domain-id domain-id \
--default-user-settings '{
"CodeEditorAppSettings": {
"LifecycleConfigArns":
[]
}
}'
```
# Création d’une configuration de cycle de vie pour cloner des référentiels dans une application d’éditeur de code
Cette section montre comment cloner un référentiel et créer une application d’éditeur de code avec la configuration de cycle de vie attachée.
1. À partir de votre ordinateur local, créez un fichier nommé `my-script.sh` avec le contenu suivant :
```
#!/bin/bash
set -eux
```
1. Clonez le référentiel de votre choix dans votre script de configuration de cycle de vie.
```
export REPOSITORY_URL="https://github.com/aws-samples/sagemaker-studio-lifecycle-config-examples.git"
git -C /home/sagemaker-user clone $REPOSITORY_URL
```
1. Après avoir finalisé votre script, créez et attachez votre configuration de cycle de vie. Pour de plus amples informations, veuillez consulter [Création et attachement de configurations de cycle de vie dans Studio](code-editor-use-lifecycle-configurations-studio-create.md).
1. Créez votre application d’éditeur de code avec la configuration de cycle de vie attachée.
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
```
Pour plus d'informations sur l'image de l'éditeur de code disponible ARNs, consultez[Instances et images de l’application d’éditeur de code](code-editor-use-instances.md).
# Création d’une configuration de cycle de vie pour installer les extensions de l’éditeur de code
Cette section explique comment créer une configuration de cycle de vie pour installer des extensions à partir du [registre Open VSX](https://open-vsx.org/) dans votre environnement d’éditeur de code.
1. À partir de votre ordinateur local, créez un fichier nommé `my-script.sh` avec le contenu suivant :
```
#!/bin/bash
set -eux
```
1. Dans le script, installez l’extension [Registre Open VSX](https://open-vsx.org/) de votre choix :
```
sagemaker-code-editor --install-extension AmazonEMR.emr-tools --extensions-dir /opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions
```
Vous pouvez extraire le nom de l’extension à partir de l’URL de l’extension dans le [registre Open VSX](https://open-vsx.org/). Le nom de l’extension à utiliser dans la commande `sagemaker-code-editor` doit contenir tout le texte qui suit `https://open-vsx.org/extension/` dans l’URL. Remplacez toutes les instances d’une barre oblique (`/`) par un point (`.`). Par exemple, `AmazonEMR/emr-tools` sera `AmazonEMR.emr-tools`.
![\[Page d’extension Amazon EMR dans le registre Open VSX.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/code-editor/code-editor-emr-extension.png)
1. Après avoir finalisé votre script, créez et attachez votre configuration de cycle de vie. Pour de plus amples informations, veuillez consulter [Création et attachement de configurations de cycle de vie dans Studio](code-editor-use-lifecycle-configurations-studio-create.md).
1. Créez votre application d’éditeur de code avec la configuration de cycle de vie attachée :
```
aws sagemaker create-app \
--domain-id domain-id \
--space-name space-name \
--app-type CodeEditor \
--app-name default \
--resource-spec "SageMakerImageArn=arn:aws:sagemaker:region:image-account-id:image/sagemaker-distribution-cpu,LifecycleConfigArn=arn:aws:sagemaker:region:user-account-id:studio-lifecycle-config/my-code-editor-lcc,InstanceType=ml.t3.large"
```
Pour plus d'informations sur l'image de l'éditeur de code disponible ARNs, consultez[Instances et images de l’application d’éditeur de code](code-editor-use-instances.md). Pour plus d’informations sur les connexions et les extensions, consultez [Connexions et extensions de l’éditeur de code](code-editor-use-connections-and-extensions.md).
# Images personnalisées
Si vous avez besoin de fonctionnalités différentes de celles fournies par SageMaker la distribution, vous pouvez apporter votre propre image avec vos extensions et packages personnalisés. Vous pouvez également l’utiliser pour personnaliser l’interface utilisateur de l’éditeur de code en fonction de vos propres besoins en matière de marque ou de conformité.
La page suivante fournit des informations et des modèles spécifiques à l'éditeur de code pour créer vos propres images d' SageMaker IA personnalisées. Ceci est destiné à compléter les informations et les instructions d'Amazon SageMaker Studio sur la création de votre propre image SageMaker AI et l'intégration de votre propre image dans Studio. Pour en savoir plus sur les images Amazon SageMaker AI personnalisées et sur la manière d'intégrer votre propre image dans Studio, consultez[Apporter votre propre image (BYOI)](studio-updated-byoi.md).
**Topics**
+ [Surveillance de l’état et URL des applications](#code-editor-custom-images-app-healthcheck)
+ [Exemples de fichiers Docker](#code-editor-custom-images-dockerfile-templates)
## Surveillance de l’état et URL des applications
+ `Base URL` : l’URL de base de l’application BYOI doit être `CodeEditor/default`. Vous ne pouvez avoir qu’une seule application et elle doit toujours être nommée `default`.
+ Health check endpoint — Vous devez héberger votre serveur Code Editor sur le port 0.0.0.0 8888 pour que l' SageMaker IA le détecte.
+ Authentification — Vous devez réussir `sagemaker-code-editor` à l'`--without-connection-token`ouverture pour permettre à l' SageMaker IA d'authentifier vos utilisateurs.
**Note**
Si vous utilisez Amazon SageMaker Distribution comme image de base, ces exigences sont déjà prises en compte dans le `entrypoint-code-editor` script inclus.
## Exemples de fichiers Docker
Les exemples suivants sont des fichiers `Dockerfile` qui répondent aux informations ci-dessus et aux [Spécifications d’images personnalisées](studio-updated-byoi-specs.md).
**Note**
Si vous apportez votre propre image à SageMaker Unified Studio, vous devez suivre les [spécifications Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) du guide de l'*utilisateur d'Amazon SageMaker Unified Studio*.
`Dockerfile`vous trouverez des exemples d' SageMaker Unified Studio dans l'[exemple Dockerfile du guide](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) de l'*utilisateur d'Amazon SageMaker Unified Studio*.
------
#### [ Example micromamba Dockerfile ]
Voici un exemple de fichier Docker permettant de créer une image à partir de zéro à l’aide d’un environnement de base [https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html) :
```
FROM mambaorg/micromamba:latest
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
USER root
RUN micromamba install -y --name base -c conda-forge sagemaker-code-editor
USER $NB_UID
CMD eval "$(micromamba shell hook --shell=bash)"; \
micromamba activate base; \
sagemaker-code-editor --host 0.0.0.0 --port 8888 \
--without-connection-token \
--base-path "/CodeEditor/default"
```
------
#### [ Example SageMaker AI Distribution Dockerfile ]
Voici un exemple de Dockerfile permettant de créer une image basée sur [Amazon SageMaker AI Distribution](https://github.com/aws/sagemaker-distribution/tree/main) :
```
FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
ENV MAMBA_USER=$NB_USER
USER root
# install scrapy in the base environment
RUN micromamba install -y --name base -c conda-forge scrapy
# download VSCodeVim
RUN \
wget https://github.com/VSCodeVim/Vim/releases/download/v1.27.2/vim-1.27.2.vsix \
-P /tmp/exts/ --no-check-certificate
# Install the extension
RUN \
extensionloc=/opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions \
&& sagemaker-code-editor \
--install-extension "/tmp/exts/vim-1.27.2.vsix" \
--extensions-dir "${extensionloc}"
USER $MAMBA_USER
ENTRYPOINT ["entrypoint-code-editor"]
```
------