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.
# RStudio sur la gestion de SageMaker l'IA sur Amazon
Les rubriques suivantes fournissent des informations sur la gestion RStudio sur Amazon SageMaker AI. Cela inclut des informations sur la configuration de votre RStudio environnement, les sessions utilisateur et les ressources nécessaires. Pour plus d'informations sur l'utilisation de RStudio l' SageMaker IA, consultez[RStudio sur le guide de l'utilisateur d'Amazon SageMaker AI](rstudio-use.md).
Pour plus d'informations sur la création d'un domaine Amazon SageMaker AI avec RStudio cette option activée, consultez[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md).
Pour plus d'informations sur les AWS régions dans lesquelles RStudio aucune SageMaker IA n'est prise en charge, consultez[Régions et quotas pris en charge](regions-quotas.md).
**Topics**
+ [Obtenir une RStudio licence](rstudio-license.md)
+ [RStudio Versionnage](rstudio-version.md)
+ [Réseau et stockage](rstudio-network.md)
+ [RStudioServerPro type d'instance](rstudio-select-instance.md)
+ [Ajouter une URL RStudio Connect](rstudio-configure-connect.md)
+ [Mettre à jour l'URL RStudio du gestionnaire de packages](rstudio-configure-pm.md)
+ [Créez un domaine Amazon SageMaker AI à RStudio l'aide du AWS CLI](rstudio-create-cli.md)
+ [Ajouter un RStudio support à un domaine existant](rstudio-add-existing.md)
+ [Images personnalisées RStudio sans SageMaker IA](rstudio-byoi.md)
+ [Créez un utilisateur à utiliser RStudio](rstudio-create-user.md)
+ [Connectez-vous en RStudio tant qu'autre utilisateur](rstudio-login-another.md)
+ [Mettre fin aux sessions d’un autre utilisateur](rstudio-terminate-another.md)
+ [Utiliser le tableau de bord RStudio administratif](rstudio-admin.md)
+ [Arrêter RStudio](rstudio-shutdown.md)
+ [Facturation et coût](rstudio-billing.md)
+ [Diagnostiquer les problèmes et obtenir une assistance](rstudio-troubleshooting.md)
# Obtenir une RStudio licence
RStudio sur Amazon SageMaker AI est un produit payant et nécessite que chaque utilisateur possède une licence appropriée. Les licences pour RStudio Amazon SageMaker AI peuvent être obtenues directement auprès de RStudio PBC ou en achetant un abonnement à Posit Workbench on Marketplace. AWS Pour les clients de Posit Workbench Enterprise, les licences sont émises sans frais supplémentaires. Pour utiliser une RStudio licence avec Amazon SageMaker AI, vous devez d'abord disposer d'une RStudio licence valide enregistrée auprès de AWS License Manager. Pour les licences achetées directement via Rstudio PBC, une autorisation de licence doit être créée pour votre AWS compte. Contactez-nous RStudio pour les achats directs de licences ou pour activer les licences existantes dans AWS License Manager. Pour plus d’informations sur l’enregistrement d’une licence auprès de AWS License Manager, consultez [Licences émises par le vendeur dans AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html).
Les rubriques suivantes montrent comment acquérir et valider une licence accordée par RStudio PBC.
**Obtenir une RStudio licence**
1. Si vous n'avez pas de RStudio licence, vous pouvez en acheter une AWS sur le Marketplace ou directement auprès de RStudio PBC.
+ Pour acheter un abonnement AWS sur la Marketplace, suivez les étapes pour [souscrire un contrat SaaS](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html) en recherchant **Posit Platform (RStudio on SageMaker)**. Pour valider la licence, vous serez redirigé vers un formulaire externe à la AWS Marketplace. Vous devez fournir des informations supplémentaires, y compris le nom et l’adresse e-mail de votre entreprise. Si vous ne pouvez pas accéder à ce formulaire pour fournir le nom de l'entreprise et une adresse e-mail de contact, créez un ticket auprès de Posit Support à l'[adresse https://support.posit. co/hc/en-us/requests/new](https://support.posit.co/hc/en-us/requests/new)avec les détails de votre achat.
+ Pour acheter directement auprès de RStudio PBC, rendez-vous sur [RStudio Tarification](https://www.rstudio.com/pricing/) ou contactez [sales@rstudio.com.](mailto:sales@rstudio.com) Lorsque vous achetez ou mettez à jour une RStudio licence, vous devez fournir le AWS compte qui hébergera votre domaine Amazon SageMaker AI.
Si vous possédez déjà une RStudio licence, contactez votre représentant RStudio commercial ou [envoyez un e-mail à sales@rstudio.com](mailto:sales@rstudio.com) pour ajouter RStudio Amazon SageMaker AI à votre licence Posit Workbench Enterprise existante ou pour convertir votre licence Posit Workbench Standard. Le représentant RStudio commercial vous enverra le bon de commande électronique approprié.
1. RStudio accorde une licence Posit Workbench à votre AWS compte via la AWS License Manager région USA Est (Virginie du Nord). Bien que la RStudio licence soit accordée dans la région de l'est des États-Unis (Virginie du Nord), votre licence peut être utilisée dans toutes les AWS régions prises en charge RStudio sur Amazon SageMaker AI. Vous pouvez vous attendre à ce que le processus d'octroi de licence soit terminé dans les trois jours ouvrables suivant la communication de votre identifiant de AWS compte RStudio.
1. Lorsque cette licence est accordée, vous recevez un e-mail de votre représentant RStudio commercial contenant des instructions pour accepter l'octroi de votre licence.
**Validez votre RStudio licence à utiliser avec Amazon SageMaker AI**
1. Connectez-vous à la AWS License Manager console dans la même région que votre domaine Amazon SageMaker AI. Si vous l'utilisez AWS License Manager pour la première fois, vous AWS License Manager invite à accorder l'autorisation d'utilisation AWS License Manager.
1. Sélectionnez **Commencer à utiliser le gestionnaire de AWS licences**.
1. Sélectionnez `I grant AWS License Manager the required permissions`, puis **Grant Permissions** (Accorder des autorisations).
1. Accédez à **Granted Licenses** (Licences accordées) sur le panneau de gauche.
1. Sélectionnez l'octroi de licence avec `RSW-SageMaker` comme `Product name` et sélectionnez **View** (Afficher).
1. Sur la page des détails de la licence, sélectionnez **Accepter & activer la licence**.
**RStudio tableau de bord administratif**
Vous pouvez utiliser le tableau de bord RStudio administratif pour voir le nombre d'utilisateurs associés à la licence en suivant les étapes décrites[Utiliser le tableau de bord RStudio administratif](rstudio-admin.md).
# RStudio Versionnage
**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.
Ce guide fournit des informations sur la mise à jour de `2025.05.1+513.pro3` version pour RStudio on SageMaker AI. À partir du 31 octobre 2025, de nouveaux domaines pris RStudio en charge sont créés avec Posit Workbench la version`2025.05.1+513.pro3`. Cela s’applique aux applications `RStudioServerPro` et aux applications `RSessionGateway` par défaut.
Les sections suivantes fournissent des informations sur cette `2025.05.1+513.pro3` version.
## Dernières mises à jour de version
La dernière RStudio version est`2025.05.1+513.pro3`.
+ Versions R prises en charge :
+ 4.5.1
+ 4.4.3
+ 4.4.0
+ 4.3.3
+ 4.2.3
+ 4.2.1
+ 4.1.3
+ 4.0.2
Pour plus d’informations sur les modifications de cette version, consultez [https://docs.posit.co/ide/news/](https://docs.posit.co/ide/news/).
**Note**
Pour garantir la compatibilité, nous vous recommandons RSessions d'utiliser un préfixe correspondant à la Posit Workbench version actuelle.
Si l'avertissement suivant s'affiche, il existe une incompatibilité de version entre la `RSession` et la Posit Workbench version utilisée dans RStudio SageMaker AI. Pour résoudre ce problème, mettez à jour la RStudio version du domaine. Pour plus d'informations sur la mise à jour de la RStudio version, consultez[Mise à niveau de la nouvelle version](rstudio-version-upgrade.md).
```
Session version 2024.04.2+764.pro1 does not match server version 2025.05.1+513.pro3 - this is an unsupported configuration, and you may experience unexpected issues as a result.
```
## Gestion des versions
Il existe actuellement deux versions de Posit Workbench prises en charge par l' SageMaker IA.
+ Dernière version : `2025.05.1+513.pro3`
Date d'obsolescence : 5 décembre 2026
+ Version précédente : `2024.04.2+764.pro1`
Date d'obsolescence : 30 avril 2026
**Note**
Bien que vous puissiez continuer à créer de nouveaux domaines avec l'ancienne version `2024.04.2+764.pro1` jusqu'au 30/04/2026 en épinglant explicitement la version lorsque vous créez le domaine à l'aide de la CLI, nous recommandons vivement aux clients de commencer à utiliser la `2025.05` version dans tous les domaines. POSIT a cessé de fournir des correctifs de vulnérabilité pour`2024.04.2+764.pro1`.
Les versions `2023.03.2-547.pro5` 1 et `2022.02.2-485.pro2` 2 sont obsolètes et ne sont plus prises en charge. Nous vous conseillons de procéder à une mise à jour vers la version la plus récente.
La Posit Workbench version par défaut sélectionnée par SageMaker AI dépend de la date de création du domaine.
+ Pour les domaines créés après le 31 octobre 2025, la version `2025.05.1+513.pro3` est la version sélectionnée par défaut.
+ Pour les domaines créés après le 04 septembre 2024 et avant le 31 octobre 2025, la version `2024.04.2+764.pro1` est la version sélectionnée par défaut. Vous pouvez mettre à jour vos domaines avec la dernière version (`2025.05.1+513.pro3`) en la définissant comme version par défaut pour le domaine. Pour de plus amples informations, veuillez consulter [Mise à niveau de la nouvelle version](rstudio-version-upgrade.md).
**Note**
La version par défaut de l'application `RSessionGateway` correspond à la version actuelle de l'application `RStudioServerPro`.
Le tableau suivant répertorie l'image ARNs des deux versions pour chacune d'elles Région AWS. Ils ARNs sont transmis dans le cadre d'une `update-domain` commande pour définir la version souhaitée.
| Region | ARN d'image `2024.04.2+764.pro1` | ARN d'image `2025.05.1+513.pro3` |
| --- | --- | --- |
| us-east-1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-east-2 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-2 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| af-south-1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-east-1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-south-1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ca-central-1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-central-1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-2 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-3 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-north-1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-south-1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| sa-east-1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2025.05-sagemaker-1.0 |
### Modifications apportées aux images BYOI
Si vous utilisez une image BYOI RStudio et que vous mettez à jour votre `RStudioServerPro` version`2025.05.1+513.pro3`, vous devez mettre à niveau vos images personnalisées pour utiliser la `2025.05.1+513.pro3` version et redéployer les images existantes. RSessions Si vous tentez de charger une image non compatible dans un domaine à l'aide RSession de la `2025.05.1+513.pro3` version, l'opération RSession échoue car elle ne peut pas analyser les paramètres qu'elle reçoit. Pour éviter tout échec, mettez à jour toutes les images personnalisées déployées dans votre application `RStudioServerPro` existante.
Le `RSW_VERSION` in Dockerfile doit être cohérent avec la Posit Workbench version utilisée dans RStudio SageMaker AI. Vous pouvez valider la version actuelle dans Posit Workbench. Pour ce faire, utilisez le nom de version situé dans le coin inférieur gauche de la page du lanceur Posit Workbench.
```
ARG RSW_VERSION=2025.05.1+513.pro3
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1"
ARG RSW_NAME=rstudio-workbench
ARG OS_CODE_NAME=jammy
ARG RSW_DOWNLOAD_URL=https://s3.amazonaws.com/rstudio-ide-build/server/${OS_CODE_NAME}/amd64
RUN RSW_VERSION_URL=`echo -n "${RSW_VERSION}" | sed 's/+/-/g'` \
&& curl -o rstudio-workbench.deb ${RSW_DOWNLOAD_URL}/${RSW_NAME}-${RSW_VERSION_URL}-amd64.deb \
&& gdebi -n ./rstudio-workbench.deb
```
# Mise à niveau de la nouvelle version
Les domaines existants utilisant la version `2024.04.2+764.pro1` peuvent effectuer une mise à niveau vers la version `2025.05.1+513.pro3` de l’une des deux manières suivantes :
+ Créez un nouveau domaine à partir du AWS CLI champ RStudio activé.
+ Mettez à jour un domaine existant pour utiliser la version `2025.05.1+513.pro3`.
La procédure suivante indique comment supprimer l' RStudio application pour un domaine existant, définir la version par défaut sur`2025.05.1+513.pro3`, puis créer une RStudio application.
1. Supprimez l’application `RStudioServerPro` et toutes les applications `RSessionGateway` associées à votre domaine existant. Pour plus d'informations sur la façon de trouver votre ID de domaine, consultez [Visualisation des domaines](domain-view.md). Pour plus d’informations sur la suppression des applications, consultez [Arrêter RStudio](rstudio-shutdown.md).
```
aws sagemaker delete-app \
--region region \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Si votre domaine utilise RStudio la version`2024.04.2+764.pro1`, mettez-le à jour pour le définir `2025.05.1+513.pro3` comme Posit Workbench version par défaut. La `SageMakerImageArn` valeur de la `update-domain` commande suivante indique la RStudio `2025.05.1+513.pro3` version par défaut. Cet ARN doit correspondre à la Region dans laquelle se trouve votre domaine. Pour une liste de toutes les options disponibles ARNs, voir[Gestion des versions](rstudio-version.md#rstudio-version-new).
Transmettez un ARN de rôle d'exécution pour le domaine qui fournit les autorisations de mise à jour du domaine.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2025.05.1+513.pro3-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Créez une nouvelle application `RStudioServerPro` dans le domaine existant.
```
aws sagemaker create-app \
--region region
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
La version de votre application `RStudioServerPro` est maintenant mise à jour vers `2025.05.1+513.pro3`. Vous pouvez désormais relancer vos applications `RSessionGateway`.
# Rétrograder vers une version précédente
Vous pouvez rétrograder manuellement la version de votre RStudio application existante vers la `2024.04.2+764.pro1` version précédente.
**Pour revenir à une version précédente**
1. Supprimez l'application `RStudioServerPro` associée à votre domaine existant. Pour plus d'informations sur la façon de trouver votre ID de domaine, consultez [Visualisation des domaines](domain-view.md).
```
aws sagemaker delete-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Transmettez l'ARN `2024.04.2+764.pro1` correspondant à votre nom pour votre Region dans le cadre de la commande `update-domain`. Pour une liste de toutes les options disponibles ARNs, voir[Gestion des versions](rstudio-version.md#rstudio-version-new). Vous devez également transmettre un ARN de rôle d'exécution pour le domaine qui fournit les autorisations de mise à jour du domaine.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2024.04.2+764.pro1-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Créez une nouvelle application `RStudioServerPro` dans le domaine existant. La RStudio version par défaut est. `2024.04.2+764.pro1`
```
aws sagemaker create-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
La version de votre application `RStudioServerPro` est désormais rétrogradée vers `2024.04.2+764.pro1`.
# Réseau et stockage
La rubrique suivante décrit les considérations relatives à l'accès au réseau et au stockage des données pour votre RStudio instance. Pour obtenir des informations générales sur l'accès au réseau et le stockage des données lors de l'utilisation d'Amazon SageMaker AI, consultez[Protection des données dans Amazon SageMaker AI](data-protection.md).
**Volumes Amazon EFS**
RStudio sur Amazon SageMaker AI partage un volume Amazon EFS avec l'application Amazon SageMaker Studio Classic du domaine. Lorsque l' RStudio application est ajoutée à un domaine, SageMaker AI crée un dossier nommé `shared` dans le répertoire Amazon EFS. Si ce `shared` dossier est supprimé ou modifié manuellement, l' RStudio application risque de ne plus fonctionner. Pour plus d’informations sur le volume Amazon EFS, reportez-vous à la section [Gérez votre volume de stockage Amazon EFS dans Amazon SageMaker Studio Classic](studio-tasks-manage-storage.md).
**Packages et scripts installés**
Les packages que vous installez de l'intérieur RStudio sont limités au niveau du profil utilisateur. Cela signifie que le package installé persiste pendant l' RSession arrêt, le redémarrage et ce, RSessions pour chaque profil utilisateur dans lequel il est installé. R Les scripts enregistrés dans RSessions se comportent de la même manière. Les packages et les scripts R sont enregistrés dans le volume Amazon EFS de l'utilisateur.
**Chiffrement**
RStudio sur Amazon, SageMaker l'IA prend en charge le chiffrement au repos.
**Utilisation RStudio en mode VPC uniquement**
RStudio sur Amazon, l' SageMaker IA prend en charge [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html)l'intégration. Grâce à cette intégration, vous pouvez utiliser RStudio l' SageMaker IA en mode VPC uniquement sans accès direct à Internet. Lorsque vous utilisez RStudio le mode VPC uniquement, vos groupes de sécurité sont automatiquement gérés par le service. Cela inclut la connectivité entre votre RServer et votre RSessions.
Les éléments suivants sont requis pour une utilisation RStudio en mode VPC uniquement. Pour plus d’informations sur la sélection d’un VPC, consultez [Choix d’un réseau Amazon VPC](onboard-vpc.md).
+ Un sous-réseau privé avec accès à Internet pour passer un appel à Amazon SageMaker AI & License Manager ou aux points de terminaison Amazon Virtual Private Cloud (Amazon VPC) pour SageMaker Amazon AI et License Manager.
+ Le domaine ne peut pas avoir plus de deux groupes de sécurité associés.
+ Un ID de groupe de sécurité à utiliser avec le domaine dans les paramètres du domaine. Celui-ci doit autoriser tous les accès sortants.
+ Un ID de groupe de sécurité à utiliser avec le point de terminaison Amazon VPC. Ce groupe de sécurité doit autoriser le trafic entrant à partir de l’ID du groupe de sécurité du domaine.
+ Point de terminaison Amazon VPC pour `sagemaker.api` et. AWS License Manager Celui-ci doit se trouver dans le même Amazon VPC que le sous-réseau privé.
# RStudioServerPro type d'instance
Lorsque vous décidez du type d'instance Amazon EC2 à utiliser pour votre RStudio ServerPro application, le principal facteur à prendre en compte est la bande passante. La bande passante est importante car l' RStudioServerPro instance est chargée de fournir l' RStudio interface utilisateur à tous les utilisateurs. Cela inclut les flux de travail lourds de l'interface utilisateur, tels que la génération de figures, d'animations et l'affichage de nombreuses lignes de données. Par conséquent, il peut y avoir une dégradation des performances de l'interface utilisateur en fonction de la charge de travail de tous les utilisateurs. Vous trouverez ci-dessous les types d'instances disponibles à utiliser pour votre RStudioServerPro. Pour obtenir des informations sur les tarifs de ces instances, consultez [Amazon SageMaker Pricing](https://aws.amazon.com/sagemaker/pricing/).
+ `system` : ce type d’instance est recommandé pour les domaines avec une faible utilisation de l’interface utilisateur.
**Note**
La valeur `system` est convertie en `ml.t3.medium`.
+ `ml.c5.4xlarge` : ce type d’instance est recommandé pour les domaines avec une utilisation modérée de l’interface utilisateur.
+ `ml.c5.9xlarge` : ce type d'instance est recommandé pour les domaines avec une utilisation intensive de l'interface utilisateur.
**Modification du type d' RStudio instance**
Pour modifier le type d'instance de votre instance RStudioServerPro, transmettez le nouveau type d'instance dans le cadre d'un appel à la commande `update-domain` CLI. Vous devez ensuite supprimer l'RStudioServerProapplication existante à l'aide de la commande `delete-app` CLI et créer une nouvelle RStudio ServerPro application à l'aide de la commande `create-app` CLI.
# Ajouter une URL RStudio Connect
RStudio Connect est une plateforme de publication pour les applications Shiny, les rapports R Markdown, les tableaux de bord, les diagrammes, etc. RStudio Connect permet de faire ressortir facilement les connaissances issues de l'apprentissage automatique et de la science des données en rendant l'hébergement de contenu simple et évolutif. Si vous disposez d'un serveur RStudio Connect, vous pouvez le définir comme emplacement par défaut où les applications sont publiées. Pour plus d'informations sur RStudio Connect, consultez [RStudio Connect](https://www.rstudio.com/products/connect/).
Lorsque vous intégrez RStudio sur un domaine Amazon SageMaker AI, aucun serveur RStudio Connect n'est créé. Vous pouvez créer un serveur RStudio Connect sur une instance Amazon EC2 pour utiliser le domaine Connect with SageMaker Amazon AI. Pour plus d'informations sur la configuration de votre serveur RStudio Connect, consultez [Host RStudio Connect et Package Manager pour le développement du ML RStudio sur Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/).
**Ajouter une URL RStudio Connect**
Si vous avez une URL RStudio Connect, vous pouvez mettre à jour l'URL par défaut afin que vos RStudio utilisateurs puissent y publier.
1. Accédez à la page **Domaines**.
1. Sélectionnez le domaine souhaité.
1. Choisissez **Paramètres du domaine**.
1. Sous **General Settings** (Paramètres généraux), sélectionnez **Edit** (Modifier).
1. Sur la nouvelle page, sélectionnez **RStudio Paramètres** sur le côté gauche.
1. Sous **URL de RStudio connexion**, entrez l'URL de RStudio connexion à ajouter.
1. Sélectionnez **Soumettre**.
**INTERFACE DE LIGNE DE COMMANDE (CLI)**
Vous pouvez définir une URL RStudio Connect par défaut lorsque vous créez votre domaine. La seule façon de mettre à jour votre URL RStudio Connect depuis le AWS CLI est de supprimer votre domaine et d'en créer un nouveau avec l'URL RStudio Connect mise à jour.
# Mettre à jour l'URL RStudio du gestionnaire de packages
RStudio Package Manager est un serveur de gestion de référentiels utilisé pour organiser et centraliser les packages au sein de votre organisation. Pour plus d'informations sur RStudio Package Manager, consultez [RStudio Package Manager](https://www.rstudio.com/products/package-manager/). Si vous ne fournissez pas votre propre URL de Package Manager, le domaine Amazon SageMaker AI utilise le référentiel Package Manager par défaut lors de votre intégration en RStudio suivant les étapes décrites dans[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md). Pour plus d'informations, consultez [Host RStudio Connect et Package Manager pour le développement du ML RStudio sur Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/). La procédure suivante montre comment mettre à jour l’URL Package Manager.
**Mettre à jour l’URL Package Manager**
Vous pouvez mettre à jour l'URL du gestionnaire de packages utilisée pour votre domaine RStudio activé comme suit.
1. Accédez à la page **Domaines**.
1. Sélectionnez le domaine souhaité.
1. Choisissez **Paramètres du domaine**.
1. Sous **General Settings** (Paramètres généraux), sélectionnez **Edit** (Modifier).
1. Sur la nouvelle page, sélectionnez **RStudio Paramètres** sur le côté gauche.
1. Sous **RStudio Package Manager**, entrez l'URL de votre RStudio Package Manager.
1. Sélectionnez **Soumettre**.
**INTERFACE DE LIGNE DE COMMANDE (CLI)**
La seule façon de mettre à jour l'URL de votre gestionnaire de packages depuis le AWS CLI est de supprimer votre domaine et d'en créer un nouveau avec l'URL du gestionnaire de packages mise à jour.
# Créez un domaine Amazon SageMaker AI à RStudio l'aide du AWS CLI
**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.
La rubrique suivante explique comment intégrer un domaine Amazon SageMaker AI avec l' RStudio option activée à l'aide du AWS CLI. Pour embarquer à l'aide du AWS Management Console, voir[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md).
## Conditions préalables
+ Installer et configurer l’[AWS CLI version 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configurer l'[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) avec des informations d'identification IAM
## Création d’un rôle `DomainExecution`
Pour lancer l' RStudio application, vous devez fournir un `DomainExecution` rôle. Ce rôle est utilisé pour déterminer s'il RStudio doit être lancé dans le cadre de la création du domaine Amazon SageMaker AI. Ce rôle est également utilisé par Amazon SageMaker AI pour accéder à la RStudio licence et aux RStudio journaux push.
**Note**
Le `DomainExecution` rôle doit au moins disposer AWS License Manager des autorisations nécessaires pour accéder à la RStudio licence et CloudWatch des autorisations pour envoyer des journaux à votre compte.
La procédure suivante montre comment créer le rôle `DomainExecution` avec l' AWS CLI.
1. Créez un fichier nommé `assume-role-policy.json` avec le contenu suivant.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": "sts:AssumeRole",
"Effect": "Allow",
"Principal": {
"Service": [
"sagemaker.amazonaws.com"
]
}
}
]
}
```
------
1. Créez le rôle `DomainExecution`. `` devrait être la région AWS dans laquelle lancer votre domaine.
```
aws iam create-role --region --role-name DomainExecution --assume-role-policy-document file://assume-role-policy.json
```
1. Créez un fichier nommé `domain-setting-policy.json` avec le contenu suivant. Cette politique permet à l' RStudioServerPro application d'accéder aux ressources nécessaires et permet à Amazon SageMaker AI de lancer automatiquement une RStudio ServerPro application lorsque l' RStudioServerPro application existante a le `Failed` statut `Deleted` OR.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"license-manager:ExtendLicenseConsumption",
"license-manager:ListReceivedLicenses",
"license-manager:GetLicense",
"license-manager:CheckoutLicense",
"license-manager:CheckInLicense",
"logs:CreateLogDelivery",
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:DeleteLogDelivery",
"logs:Describe*",
"logs:GetLogDelivery",
"logs:GetLogEvents",
"logs:ListLogDeliveries",
"logs:PutLogEvents",
"logs:PutResourcePolicy",
"logs:UpdateLogDelivery",
"sagemaker:CreateApp"
],
"Resource": "*"
}
]
}
```
------
1. Créez la politique de paramétrage du domaine attachée au rôle `DomainExecution`. Gardez en tête le `PolicyArn` de la réponse. Vous devrez saisir cet ARN dans les étapes suivantes.
```
aws iam create-policy --region --policy-name domain-setting-policy --policy-document file://domain-setting-policy.json
```
1. Attachez `domain-setting-policy` au rôle `DomainExecution`. Utilisez le `PolicyArn` renvoyé à l’étape précédente.
```
aws iam attach-role-policy --role-name DomainExecution --policy-arn
```
## Créez un domaine Amazon SageMaker AI avec RStudio l'application
L' RStudioServerPro application est lancée automatiquement lorsque vous créez un domaine Amazon SageMaker AI à l'aide de la commande `create-domain` CLI avec le `RStudioServerProDomainSettings` paramètre spécifié. Lors du lancement de l' RStudioServerPro application, Amazon SageMaker AI vérifie si une RStudio licence est valide dans le compte et échoue à créer le domaine si la licence n'est pas trouvée.
La création d'un domaine Amazon SageMaker AI varie en fonction de la méthode d'authentification et du type de réseau. Ces options doivent être utilisées ensemble, avec une méthode d’authentification et un type de connexion réseau sélectionnés. Pour plus d'informations sur les conditions requises pour créer un nouveau domaine, consultez [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html).
Les méthodes d'authentification suivantes sont prises en charge.
+ `IAM Auth`
+ `SSO Auth`
Les types de connexion réseau suivants sont pris en charge :
+ `PublicInternet`
+ `VPCOnly`
### Méthodes d'authentification
**Mode d’authentification IAM**
Ce qui suit montre comment créer un domaine Amazon SageMaker AI avec RStudio activé et un type de `IAM Auth` réseau. Pour plus d'informations Gestion des identités et des accès AWS, voir [Qu'est-ce que l'IAM ?](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) .
+ `DomainExecutionRoleArn` doit correspondre à l’ARN du rôle créé à l’étape précédente.
+ `ExecutionRole`est l'ARN du rôle attribué aux utilisateurs dans le domaine Amazon SageMaker AI.
+ `vpc-id`doit être l'ID de votre Amazon Virtual Private Cloud. `subnet-ids`doit être une liste de sous-réseaux séparés par des espaces. IDs Pour plus d'informations sur `vpc-id` et`subnet-ids`, voir [VPCs et les sous-réseaux](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`et `RStudioConnectUrl` sont facultatifs et doivent être définis sur ceux URLs de votre RStudio Package Manager et de votre serveur RStudio Connect, respectivement.
+ `app-network-access-type` doit être `PublicInternetOnly` ou `VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode IAM \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
**Authentification à l’aide d’IAM Identity Center**
Ce qui suit montre comment créer un domaine Amazon SageMaker AI avec RStudio activé et un type de `SSO Auth` réseau. AWS IAM Identity Center doit être activé pour la région dans laquelle le domaine est lancé. Pour plus d'informations sur IAM Identity Center, consultez [Qu'est-ce que c'est ? AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) .
+ `DomainExecutionRoleArn` doit correspondre à l’ARN du rôle créé à l’étape précédente.
+ `ExecutionRole`est l'ARN du rôle attribué aux utilisateurs dans le domaine Amazon SageMaker AI.
+ `vpc-id`doit être l'ID de votre Amazon Virtual Private Cloud. `subnet-ids`doit être une liste de sous-réseaux séparés par des espaces. IDs Pour plus d'informations sur `vpc-id` et`subnet-ids`, voir [VPCs et les sous-réseaux](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`et `RStudioConnectUrl` sont facultatifs et doivent être définis sur ceux URLs de votre RStudio Package Manager et de votre serveur RStudio Connect, respectivement.
+ `app-network-access-type` doit être `PublicInternetOnly` ou `VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode SSO \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
### Types de connexion
**PublicInternet/Type de réseau Internet direct**
Ce qui suit montre comment créer un domaine Amazon SageMaker AI avec RStudio activé et un type de `PublicInternet` réseau.
+ `DomainExecutionRoleArn` doit correspondre à l’ARN du rôle créé à l’étape précédente.
+ `ExecutionRole`est l'ARN du rôle attribué aux utilisateurs dans le domaine Amazon SageMaker AI.
+ `vpc-id`doit être l'ID de votre Amazon Virtual Private Cloud. `subnet-ids`doit être une liste de sous-réseaux séparés par des espaces. IDs Pour plus d'informations sur `vpc-id` et`subnet-ids`, voir [VPCs et les sous-réseaux](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl`et `RStudioConnectUrl` sont facultatifs et doivent être définis sur ceux URLs de votre RStudio Package Manager et de votre serveur RStudio Connect, respectivement.
+ `auth-mode` doit être `SSO` ou `IAM`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type PublicInternetOnly
```
**VPCOnly mode**
Ce qui suit montre comment lancer un domaine Amazon SageMaker AI avec RStudio activé et un type de `VPCOnly` réseau. Pour plus d’informations sur l’utilisation du type d’accès réseau `VPCOnly`, consultez [Connexion des blocs-notes Studio d’un VPC à des ressources externes](studio-notebooks-and-internet-access.md).
+ `DomainExecutionRoleArn` doit correspondre à l’ARN du rôle créé à l’étape précédente.
+ `ExecutionRole`est l'ARN du rôle attribué aux utilisateurs dans le domaine Amazon SageMaker AI.
+ `vpc-id`doit être l'ID de votre Amazon Virtual Private Cloud. `subnet-ids`doit être une liste de sous-réseaux séparés par des espaces. IDs Votre sous-réseau privé doit pouvoir soit accéder à Internet pour passer un appel à Amazon SageMaker AI, AWS License Manager soit disposer de points de terminaison Amazon VPC pour Amazon SageMaker AI et. AWS License Manager[Pour plus d'informations sur les points de terminaison Amazon VPC, consultez Interface [Amazon VPC endpoints](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html). Pour plus d'informations sur `vpc-id` et, voir et les sous-réseaux. `subnet-ids` VPCs ](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html)
+ `SecurityGroups`doit autoriser l'accès sortant à Amazon SageMaker AI et aux points de AWS License Manager terminaison.
+ `auth-mode` doit être `SSO` ou `IAM`.
**Note**
Lorsque vous utilisez des points de terminaison Amazon Virtual Private Cloud, le groupe de sécurité attaché à vos points de terminaison Amazon Virtual Private Cloud doit autoriser le trafic entrant provenant du groupe de sécurité que vous transmettez dans le cadre du paramètre `domain-setting` de l’appel de CLI `create-domain`.
Amazon SageMaker AI gère les groupes de sécurité pour vous. RStudio Cela signifie qu'Amazon SageMaker AI gère les règles des groupes de sécurité RSessions afin de garantir l'accès aux RStudio ServerPro applications. Amazon SageMaker AI crée une règle de groupe de sécurité par profil utilisateur.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings SecurityGroups=,ExecutionRole= \
--domain-settings SecurityGroupIds=,RStudioServerProDomainSettings={DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids "" \
--app-network-access-type VPCOnly --app-security-group-management Service
```
Remarque : L' RStudioServerPro application est lancée par un profil utilisateur spécial nommé`domain-shared`. Par conséquent, cette application n'est renvoyée dans le cadre d'appels d'API `list-app` par aucun autre profil utilisateur.
Vous devrez peut-être augmenter le quota Amazon VPC dans votre compte pour augmenter le nombre d'utilisateurs. Pour plus d’informations, consultez [Quotas Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html#vpc-limits-security-groups).
## Vérification de la création du domaine
Utilisez la commande suivante pour vérifier que votre domaine a été créé avec le `Status` `InService`. Votre `domain-id` est ajouté à l’ARN des domaines. Par exemple, `arn:aws:sagemaker:::domain/`.
```
aws sagemaker describe-domain --domain-id --region
```
# Ajouter un RStudio support à un domaine existant
**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.
Si vous avez ajouté une RStudio licence via AWS License Manager, vous pouvez créer un nouveau domaine Amazon SageMaker AI compatible avec RStudio on SageMaker AI. Si un domaine existant n'est pas pris en charge RStudio, vous pouvez ajouter un RStudio support à ce domaine sans avoir à le supprimer ni à le recréer.
La rubrique suivante explique comment ajouter cette prise en charge.
## Conditions préalables
Vous devez suivre les étapes suivantes avant de mettre à jour votre domaine actuel afin d'ajouter la prise en charge de RStudio l' SageMaker IA.
+ Installer et configurer l’[AWS CLI version 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configurer l’[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) avec des informations d’identification IAM
+ Créez un rôle d'exécution de domaine en suivant les étapes décrites dans [Créer un domaine SageMaker AI à RStudio l'aide du AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution). Ce rôle IAM au niveau du domaine est requis par l'application. RStudio ServerPro Le rôle nécessite l'accès à AWS License Manager pour vérifier une licence Posit Workbench valide et à Amazon CloudWatch Logs pour publier les journaux du serveur.
+ Apportez votre RStudio licence pour AWS License Manager suivre les étapes de la [RStudiolicence](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html).
+ (Facultatif) Si vous souhaitez utiliser RStudio le `VPCOnly` mode in, effectuez les étapes [RStudio en mode VPC uniquement](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html).
+ Assurez-vous que les groupes de sécurité que vous avez configurés pour chacun de vos [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)domaines respectent les quotas au niveau du compte. Lorsque vous configurez le profil utilisateur par défaut lors de la création du domaine, vous pouvez utiliser le `DefaultUserSettings` paramètre de l'[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API pour ajouter `SecurityGroups` ceux hérités par tous les profils utilisateur créés dans le domaine. Vous pouvez également fournir des groupes de sécurité supplémentaires pour un utilisateur spécifique dans le cadre des `UserSettings` paramètres de l'[CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Si vous avez ajouté des groupes de sécurité de cette manière, vous devez vous assurer que le nombre total de groupes de sécurité par profil utilisateur ne dépasse pas le quota maximum de 2 en mode `VPCOnly` et de 4 en mode `PublicInternetOnly`. Si le nombre total de groupes de sécurité qui en résulte pour un profil utilisateur dépasse le quota, vous pouvez combiner les règles de plusieurs groupes de sécurité en un seul groupe de sécurité.
## Ajouter un RStudio support à un domaine existant
Une fois les prérequis remplis, vous pouvez ajouter le RStudio support à votre domaine existant. Les étapes suivantes expliquent comment mettre à jour votre domaine existant pour ajouter la prise en charge de RStudio.
### Étape 1 : Suppression de toutes les applications dans le domaine
Pour ajouter la prise en charge RStudio dans votre domaine, l' SageMaker IA doit mettre à jour les groupes de sécurité sous-jacents pour tous les profils utilisateur existants. Pour ce faire, vous devez supprimer et recréer toutes les applications existantes dans le domaine. La procédure suivante indique comment supprimer toutes les applications.
1. Répertoriez toutes les applications du domaine.
```
aws sagemaker \
list-apps \
--domain-id-equals
```
1. Supprimez chaque application pour chaque profil utilisateur du domaine.
```
// JupyterServer apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type JupyterServer \
--app-name
// KernelGateway apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type KernelGateway \
--app-name
```
### Étape 2 : Mettre à jour tous les profils utilisateur avec la nouvelle liste de groupes de sécurité
Il s’agit d’une action unique que vous devez effectuer pour tous les profils utilisateur existants dans votre domaine une fois que vous aurez refactorisé vos groupes de sécurité existants. Cela vous empêche d'atteindre le quota pour le nombre maximal de groupes de sécurité. L'appel `UpdateUserProfile` d'API échoue si l'utilisateur possède des applications dont le [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)statut est en cours. Supprimez toutes les applications, puis appelez l’API `UpdateUserProfile` pour mettre à jour les groupes de sécurité.
**Note**
La configuration suivante relative au `VPCOnly` mode décrite dans [Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) Resources n'est plus nécessaire lors de l' RStudio ajout d'un support, `AppSecurityGroupManagement` car elle est gérée par SageMaker le service AI :
« [Trafic TCP au sein du groupe de sécurité](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Cela est nécessaire pour la connectivité entre l' JupyterServer application et les KernelGateway applications. Vous devez au moins autoriser l'accès à des ports situés dans la plage `8192-65535`. »
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
### Étape 3 - Activez RStudio en appelant l' UpdateDomain API
1. Appelez l'[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API pour ajouter la prise en charge d' RStudio on SageMaker AI. Le paramètre `defaultusersettings` n’est nécessaire que si vous avez refactorisé les groupes de sécurité par défaut pour vos profils utilisateur.
+ Pour le mode `VPCOnly` :
```
aws sagemaker \
update-domain \
--domain-id \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
+ Pour le mode `PublicInternetOnly` :
```
aws sagemaker \
update-domain \
--domain-id \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
1. Vérifiez si le statut du domaine est `InService`. Une fois le statut du domaine défini`InService`, le support pour RStudio on SageMaker AI est ajouté.
```
aws sagemaker \
describe-domain \
--domain-id
```
1. Vérifiez que l'état de RStudio ServerPro l'application est correct `InService` à l'aide de la commande suivante.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Étape 4 - Ajouter un RStudio accès pour les utilisateurs existants
Dans le cadre de la mise à jour de l' RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)étape 3, SageMaker AI marque tous les profils utilisateur existants dans le domaine comme étant `DISABLED` par défaut. Cela permet d’éviter de dépasser le nombre d’utilisateurs autorisé par votre licence actuelle. Une étape d'inscription unique permet d'ajouter un accès aux utilisateurs existants. Effectuez l'opt-in en appelant l'[UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API avec ce qui suit : [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Facultatif* - `UserGroup` = `R_STUDIO_USER` ou `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**Note**
Par défaut, le nombre d'utilisateurs pouvant y avoir accès RStudio est de 60.
### Étape 5 — Désactiver l' RStudio accès pour les nouveaux utilisateurs
Sauf indication contraire lors de l'appel`UpdateDomain`, le RStudio support est ajouté par défaut pour tous les nouveaux profils utilisateur créés après que vous ayez ajouté le support pour RStudio on SageMaker AI. Pour désactiver l’accès à un nouveau profil utilisateur, vous devez définir le paramètre `AccessStatus` de manière explicite sur `DISABLED` dans le cadre de l’appel d’API `CreateUserProfile`. Si le paramètre `AccessStatus` n’est pas spécifié dans le cadre de l’API `CreateUserProfile`, le statut d’accès par défaut est `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```
# Images personnalisées RStudio sans SageMaker IA
Une SageMaker image est un fichier qui identifie les packages linguistiques et les autres dépendances nécessaires à l'exécution RStudio sur Amazon SageMaker AI. SageMaker L'IA utilise ces images pour créer un environnement dans lequel vous courez RStudio. Amazon SageMaker AI fournit une RStudio image intégrée que vous pouvez utiliser. Si vous avez besoin de fonctionnalités différentes, vous pouvez apporter vos propres images personnalisées. Cette page fournit des informations sur les concepts clés relatifs à l'utilisation d'images personnalisées avec une RStudio SageMaker IA. Le processus pour utiliser votre propre image avec l' SageMaker IA RStudio se déroule en trois étapes :
1. Générez une image personnalisée à partir d’un fichier Docker et transférez-la dans un référentiel dans Amazon Elastic Container Registry (Amazon ECR).
1. Créez une SageMaker image qui pointe vers une image de conteneur dans Amazon ECR et attachez-la à votre domaine Amazon SageMaker AI.
1. Lancez une nouvelle session RStudio avec votre image personnalisée.
Vous pouvez créer des images et des versions d'images, et associer des versions d'images à votre domaine à l'aide du panneau de configuration SageMaker AI [AWS SDK pour Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html), du et du [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/). Vous pouvez également créer des images et des versions d'images à l'aide de la console SageMaker AI, même si vous n'êtes pas encore intégré à un domaine.
Les rubriques suivantes montrent comment intégrer votre propre image à l' SageMaker IA RStudio en créant, en joignant et en lançant une image personnalisée.
## Terminologie clé
La section suivante définit les termes clés permettant d'utiliser votre propre image avec RStudio l' SageMaker IA.
+ **Fichier Docker :** un fichier Docker est un fichier qui identifie les packages de langue et les autres dépendances de votre image Docker.
+ **Image Docker :** l’image Docker est un fichier Docker intégré. Cette image est enregistrée dans Amazon ECR et sert de base à l'image SageMaker AI.
+ **SageMaker image :** une SageMaker image est un support pour un ensemble de versions d' SageMaker images basées sur des images Docker.
+ **Version image :** une version image d'une SageMaker image représente une image Docker compatible RStudio et stockée dans un référentiel Amazon ECR. Chaque version d’image est inaltérable. Ces versions d'image peuvent être associées à un domaine et utilisées avec RStudio une SageMaker IA.
# Exécuter les opérations prérequises
Vous devez remplir les conditions préalables suivantes avant d'importer votre propre image pour l'utiliser RStudio sur Amazon SageMaker AI.
+ Si vous possédez déjà un domaine créé avant le 7 avril 2022, vous devez supprimer votre RStudio ServerPro application et la recréer. RStudio Pour plus d'informations sur la suppression d'un serveur , consultez [Arrêter et mettre à jour Amazon SageMaker Studio Classic](studio-tasks-update-studio.md).
+ Installez l'application Docker. Pour obtenir des informations sur la configuration de Docker, consultez [Orientation et configuration](https://docs.docker.com/get-started/).
+ Créez une copie locale d'un Dockerfile RStudio compatible qui fonctionne avec l'IA. SageMaker Pour plus d'informations sur la création d'un exemple de RStudio fichier Docker, consultez [Utiliser une image personnalisée pour intégrer votre propre environnement de développement RStudio sur Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/use-a-custom-image-to-bring-your-own-development-environment-to-rstudio-on-amazon-sagemaker/).
+ Utilisez un rôle Gestion des identités et des accès AWS d'exécution auquel la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)politique est attachée. Si vous êtes intégré au domaine, vous pouvez obtenir le rôle dans la section **Résumé du domaine** du panneau de configuration SageMaker AI.
Ajoutez les autorisations d’accès au service Amazon Elastic Container Registry (Amazon ECR) à votre rôle d’exécution.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid": "VisualEditor0",
"Effect":"Allow",
"Action":[
"ecr:CreateRepository",
"ecr:BatchGetImage",
"ecr:CompleteLayerUpload",
"ecr:DescribeImages",
"ecr:DescribeRepositories",
"ecr:UploadLayerPart",
"ecr:ListImages",
"ecr:InitiateLayerUpload",
"ecr:BatchCheckLayerAvailability",
"ecr:PutImage"
],
"Resource": "*"
}
]
}
```
------
+ Installez et configurez AWS CLI avec la version suivante (ou supérieure). Pour plus d'informations sur l'installation du AWS CLI, voir [Installation ou mise à jour de la dernière version du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
```
AWS CLI v1 >= 1.23.6
AWS CLI v2 >= 2.6.2
```
# Spécifications RStudio d'image personnalisées
Dans ce guide, vous découvrirez les spécifications RStudio d'image personnalisées à utiliser lorsque vous apportez votre propre image. Vous devez satisfaire à deux ensembles d'exigences avec votre RStudio image personnalisée pour pouvoir l'utiliser avec Amazon SageMaker AI. Ces exigences sont imposées par RStudio PBC et la plateforme Amazon SageMaker Studio Classic. Si l’un de ces ensembles d’exigences n’est pas satisfait, votre image personnalisée ne fonctionnera pas correctement.
## RStudio Exigences PBC
RStudio Les exigences PBC sont décrites dans l'article [Utilisation d'images Docker avec RStudio RStudio Workbench/Server Pro, Launcher](https://support.rstudio.com/hc/en-us/articles/360019253393-Using-Docker-images-with-RStudio-Server-Pro-Launcher-and-Kubernetes) et Kubernetes. Suivez les instructions de cet article pour créer la base de votre RStudio image personnalisée.
Pour obtenir des instructions sur la façon d’installer plusieurs versions R dans votre image personnalisée, consultez [Installation de plusieurs versions de R sous Linux](https://support.rstudio.com/hc/en-us/articles/215488098).
## Exigences relatives à Amazon SageMaker Studio Classic
Amazon SageMaker Studio Classic impose les exigences d'installation suivantes pour votre RStudio image.
+ Vous devez utiliser une image de RStudio base d'au moins`2025.05.1+513.pro3`. Pour de plus amples informations, veuillez consulter [RStudio Versionnage](rstudio-version.md).
+ Vous pouvez installer les packages suivants :
```
yum install -y sudo \
openjdk-11-jdk \
libpng-dev \
&& yum clean all \
&& /opt/R/${R_VERSION}/bin/R -e "install.packages('reticulate', repos='https://packagemanager.rstudio.com/cran/__linux__/centos7/latest')" \
&& /opt/python/${PYTHON_VERSION}/bin/pip install --upgrade \
'boto3>1.0<2.0' \
'awscli>1.0<2.0' \
'sagemaker[local]<3'
```
+ Vous devez fournir des valeurs par défaut pour les valeurs d'environnement `RSTUDIO_CONNECT_URL` et `RSTUDIO_PACKAGE_MANAGER_URL`.
```
ENV RSTUDIO_CONNECT_URL "YOUR_CONNECT_URL"
ENV RSTUDIO_PACKAGE_MANAGER_URL "YOUR_PACKAGE_MANAGER_URL"
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE 1
```
Les spécifications générales suivantes s'appliquent à l'image représentée par une version d' RStudioimage.
**Exécution de l’image**
`ENTRYPOINT`et `CMD` les instructions sont remplacées afin que l'image soit exécutée en tant RSession qu'application.
**Arrêt de l’image**
L'API `DeleteApp` émet l'équivalent d'une commande `docker stop`. Les autres processus du conteneur ne recevront pas les SIGKILL/SIGTERM signaux.
**Système de fichiers**
Les répertoires `/opt/.sagemakerinternal` et `/opt/ml` sont réservés. Les données de ces répertoires peuvent ne pas être visibles lors de l'exécution.
**Données de l’utilisateur**
Chaque utilisateur d'un domaine SageMaker AI obtient un répertoire utilisateur sur un volume Amazon Elastic File System partagé dans l'image. L’emplacement du répertoire de l’utilisateur actuel sur le volume Amazon EFS est `/home/sagemaker-user`.
**Métadonnées**
Un fichier de métadonnées se trouve à l'emplacement suivant : `/opt/ml/metadata/resource-metadata.json`. Aucune variable d'environnement supplémentaire n'est ajoutée aux variables définies dans l'image. Pour de plus amples informations, veuillez consulter [Obtenir les métadonnées de l’application](notebooks-run-and-manage-metadata.md#notebooks-run-and-manage-metadata-app).
**GPU**
Sur une instance GPU, l’image est exécutée avec l’option `--gpus`. Seule la boîte à outils CUDA doit être incluse dans l'image et non les pilotes NVIDIA. Pour plus d’informations, consultez le [Guide de l’utilisateur NVIDIA](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/user-guide.html).
**Métriques et journalisation**
Les journaux du RSession processus sont envoyés CloudWatch à Amazon sur le compte du client. Le nom du groupe de journaux est `/aws/sagemaker/studio`. Le nom du flux de journaux est `$domainID/$userProfileName/RSession/$appName`.
**Taille de l’image**
La taille de l'image est limitée à 25 Go. Pour afficher la taille de votre image, exécutez `docker image ls`.
# Création d'une RStudio 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 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 rubrique décrit comment créer une RStudio image personnalisée à l'aide de la console SageMaker AI et du AWS CLI. Si vous utilisez le AWS CLI, vous devez exécuter les étapes depuis votre ordinateur local. Les étapes suivantes ne fonctionnent pas depuis Amazon SageMaker Studio Classic.
Lorsque vous créez une image, l' SageMaker IA crée également une version initiale de l'image. La version d’image représente une image de conteneur dans [Amazon Elastic Container Registry (ECR)](https://console.aws.amazon.com/ecr/). L'image du conteneur doit satisfaire aux exigences pour être utilisée RStudio. Pour de plus amples informations, veuillez consulter [Spécifications RStudio d'image personnalisées](rstudio-byoi-specs.md).
Pour plus d'informations sur le test local de votre image et la résolution des problèmes courants, consultez le [référentiel SageMaker Studio Custom Image Samples](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md).
**Topics**
+ [Ajouter une image de conteneur RStudio Docker SageMaker compatible avec l'IA à Amazon ECR](#rstudio-byoi-sdk-add-container-image)
+ [Création d'une SageMaker image à partir de la console](#rstudio-byoi-create-console)
+ [Créez une image à partir du AWS CLI](#rstudio-byoi-create-cli)
## Ajouter une image de conteneur RStudio Docker SageMaker compatible avec l'IA à Amazon ECR
Effectuez les opérations suivantes pour ajouter une image de conteneur Docker à Amazon ECR :
+ créer un référentiel Amazon ECR ;
+ Authentifiez-vous auprès d’Amazon ECR.
+ Créez une image RStudio Docker SageMaker compatible avec l'IA.
+ Transmettez l’image dans le référentiel Amazon ECR.
**Note**
Le référentiel Amazon ECR doit être identique Région AWS à celui de votre domaine.
**Pour créer et ajouter une image Docker à Amazon ECR**
1. Créez un référentiel Amazon ECR à l’aide de la AWS CLI. Pour créer le référentiel à l’aide de la console Amazon ECR, consultez [Création d’un référentiel](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html).
```
aws ecr create-repository \
--repository-name rstudio-custom \
--image-scanning-configuration scanOnPush=true
```
Réponse :
```
{
"repository": {
"repositoryArn": "arn:aws:ecr:us-east-2:acct-id:repository/rstudio-custom",
"registryId": "acct-id",
"repositoryName": "rstudio-custom",
"repositoryUri": "acct-id.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom",
...
}
}
```
1. Authentifiez-vous auprès d'Amazon ECR à l'aide de du référentiel URI renvoyé en réponse à la commande `create-repository`. Assurez-vous que l'application Docker est en cours d'exécution. Pour plus d'informations, consultez [Authentification de registre](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth).
```
aws ecr get-login-password | \
docker login --username AWS --password-stdin
```
Réponse :
```
Login Succeeded
```
1. Développez l’image Docker. Exécutez la commande suivante à partir du répertoire qui inclut votre fichier Docker.
```
docker build .
```
1. Étiquetez votre image créée à l'aide d'une étiquette unique.
```
docker tag ":"
```
1. Transmettez l'image de conteneur dans le référentiel Amazon ECR. Pour plus d'informations, reportez-vous à la section [ImagePush](https://docs.docker.com/engine/api/v1.40/#operation/ImagePush)et [Transmission d'une image](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html).
```
docker push :
```
Réponse :
```
The push refers to repository [.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom]
r: digest: size: 3066
```
## Création d'une SageMaker image à partir de la console
**Pour créer une image**
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 **Images**.
1. Sur la page **Images personnalisées**, choisissez **Create image (Créer une image)**.
1. Pour **Image source (Source de l'image)**, saisissez le chemin d'accès du registre à l'image du conteneur dans Amazon ECR. Le chemin d'accès est au format suivant :
` acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest] `
1. Sélectionnez **Suivant**.
1. Sous **Propriétés de l'image**, saisissez ce qui suit :
+ Nom de l'image – Le nom doit être unique pour votre compte dans la région Région AWS.
+ (Facultatif) Nom d'affichage de l'image – Le nom affiché dans l'interface utilisateur du domaine. Lorsqu’il n’est pas fourni, `Image name` est affiché.
+ (Facultatif) Description – Description de l'image.
+ Rôle IAM : le rôle doit être associé à la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)politique. Utilisez le menu déroulant pour choisir l’une des options suivantes :
+ Créer un rôle – Spécifiez tous les compartiments Amazon Simple Storage Service (Amazon S3) auxquels vous souhaitez que les utilisateurs de vos blocs-notes aient accès. Si vous ne souhaitez pas autoriser l’accès à d’autres compartiments, choisissez **None (Aucun)**.
SageMaker L'IA associe la `AmazonSageMakerFullAccess` politique au rôle. Le rôle permet aux utilisateurs de vos blocs-notes d’accéder aux compartiments S3 répertoriés en regard des coches.
+ Saisir un ARN de rôle IAM personnalisé : saisissez l’Amazon Resource Name (ARN) de votre rôle IAM.
+ Utiliser le rôle existant – Choisissez l'un de vos rôles existants dans la liste.
+ (Facultatif) Balises d’image : choisissez **Ajouter une nouvelle balise**. Vous pouvez ajouter jusqu’à 50 balises. Les balises sont consultables à l'aide de la console SageMaker AI ou de l'`Search`API SageMaker AI.
1. Sous **Type d'image**, sélectionnez RStudio image.
1. Sélectionnez **Soumettre**.
La nouvelle image s'affiche dans la fenêtre **Custom images (Images personnalisées)** et est brièvement mise en surbrillance. Une fois l'image créée avec succès, vous pouvez choisir le nom de l'image pour afficher ses propriétés ou choisir **Create version (Créer une version)** pour créer une autre version.
**Pour créer une autre version d'image**
1. Choisissez **Create version (Créer une version)** sur la même ligne que l’image.
1. Pour **Source de l’image**, saisissez le chemin d’accès du registre à l’image Amazon ECR. L'image ne doit pas être la même que celle utilisée dans une version précédente de l'image SageMaker AI.
Pour utiliser l'image personnalisée dans RStudio, vous devez l'associer à votre domaine. Pour de plus amples informations, veuillez consulter [Joindre une SageMaker image personnalisée](rstudio-byoi-attach.md).
## Créez une image à partir du AWS CLI
Cette section explique comment créer une SageMaker image Amazon personnalisée à l'aide du AWS CLI.
Pour créer une SageMaker image, procédez comme suit :
+ Créez un `Image`.
+ Créez un `ImageVersion`.
+ Créez un fichier de configuration.
+ Créez un `AppImageConfig`.
**Pour créer les entités SageMaker d'image**
1. Créez une SageMaker image. L'ARN de rôle doit disposer au moins de la police `AmazonSageMakerFullAccessPolicy` jointe.
```
aws sagemaker create-image \
--image-name rstudio-custom-image \
--role-arn arn:aws:iam:::role/service-role/
```
Réponse :
```
{
"ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image"
}
```
1. Créez une version SageMaker d'image à partir de l'image. Transmettez la valeur de balise unique que vous avez choisie lorsque vous avez envoyé l'image vers Amazon ECR.
```
aws sagemaker create-image-version \
--image-name rstudio-custom-image \
--base-image :
```
Réponse :
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1"
}
```
1. Vérifiez que la version de l'image a bien été créée.
```
aws sagemaker describe-image-version \
--image-name rstudio-custom-image \
--version 1
```
Réponse :
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-custom-image/1",
"ImageVersionStatus": "CREATED"
}
```
**Note**
Si la réponse est `"ImageVersionStatus": "CREATED_FAILED"`, la réponse inclut également la raison de l'échec. Un problème d’autorisations est une cause courante d’échec. Vous pouvez également consulter vos Amazon CloudWatch Logs. Le nom du groupe de journaux est `/aws/sagemaker/studio`. Le nom du flux de journaux est `$domainID/$userProfileName/KernelGateway/$appName`.
1. Créez un fichier de configuration nommé `app-image-config-input.json`. La configuration de l'image de l'application est utilisée pour configurer l'exécution d'une SageMaker image en tant qu'application Kernel Gateway.
```
{
"AppImageConfigName": "rstudio-custom-config"
}
```
1. Créez le AppImageConfig en utilisant le fichier que vous avez créé à l'étape précédente.
```
aws sagemaker create-app-image-config \
--cli-input-json file://app-image-config-input.json
```
Réponse :
```
{
"AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/r-image-config"
}
```
# 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 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.
Ce guide explique comment associer une RStudio image personnalisée à votre domaine Amazon SageMaker AI à l'aide de la console SageMaker AI ou du AWS Command Line Interface (AWS CLI).
Pour utiliser une SageMaker image personnalisée, vous devez associer une RStudio image personnalisée à votre domaine. Lorsque vous joignez une version d'image, elle apparaît dans le RStudio lanceur et est disponible dans la liste déroulante **Sélectionner une image**. Vous utilisez le menu déroulant pour modifier l'image utilisée par RStudio.
Le nombre de versions d'image pouvant être attachées est limité. Après avoir atteint la limite, vous devez d'abord détacher une version afin d'attacher une autre version de l'image.
**Topics**
+ [Attacher une version d’image à votre domaine à l’aide de la console](#rstudio-byoi-attach-console)
+ [Joignez une version d'image existante à votre domaine à l'aide du AWS CLI](#rstudio-byoi-attach-cli)
## Attacher une version d’image à votre domaine à l’aide de la console
Vous pouvez associer une version d' SageMaker image personnalisée à votre domaine à l'aide du panneau de configuration de la console SageMaker AI. Vous pouvez également créer une SageMaker image personnalisée et une version d'image, puis associer cette version à votre domaine.
**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. Sélectionnez le domaine souhaité.
1. Choisissez **Environnement**.
1. Sous **Images SageMaker Studio Classic personnalisées associées au domaine**, choisissez **Joindre une image**.
1. Pour **Source de l’image**, choisissez **Image existante** ou **Nouvelle image**.
Si vous sélectionnez **Image existante**, choisissez une image dans la boutique SageMaker d'images Amazon.
Si vous sélectionnez **Nouvelle image**, indiquez le chemin du registre Amazon ECR pour votre image Docker. Le chemin doit être situé dans le même Région AWS que le domaine. Le dépôt Amazon ECR doit se trouver sur le même compte que votre domaine, sinon les autorisations entre comptes pour l' SageMaker IA doivent être activées.
1. Choisissez une image existante dans la liste.
1. Choisissez une version de l'image dans la liste.
1. Choisissez **Suivant**.
1. Saisissez des 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 RStudio image personnalisée](rstudio-byoi-create.md).
1. (Facultatif) Ajoutez des balises pour l’image.
1. (Facultatif) Choisissez **Ajouter une nouvelle balise**, puis ajoutez une balise de configuration.
1. Pour **Type d'image**, sélectionnez **RStudioImage**.
1. 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 **Images personnalisées** et est brièvement mise en surbrillance.
## Joignez une version d'image existante à votre domaine à l'aide du AWS CLI
Deux méthodes sont présentées pour attacher la version de l'image à votre domaine à l'aide de AWS CLI. Dans la première méthode, vous créez un domaine avec la version attachée. Cette méthode est plus simple, mais vous devez spécifier les informations Amazon Virtual Private Cloud (Amazon VPC) et le rôle d’exécution requis pour créer le domaine.
Si vous avez déjà intégré le domaine, vous pouvez utiliser la deuxième méthode pour attacher la version de l’image à votre domaine actuel. Dans ce cas, il n’est pas nécessaire de spécifier les informations d’Amazon VPC et le rôle d’exécution. Après avoir joint la version, supprimez toutes les applications de votre domaine et relancez-les RStudio.
### Joindre l' SageMaker image à un nouveau domaine
Pour utiliser cette méthode, vous devez spécifier un rôle d'exécution auquel la [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)politique est attachée.
Procédez comme suit pour créer le domaine et joindre l'image SageMaker AI 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
```
Réponse :
```
vpc-xxxxxxxx
```
1. Obtenez votre sous-réseau par défaut IDs à l'aide de l'ID VPC de l'étape précédente.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values= \
--query "Subnets[*].SubnetId" --output json
```
Réponse :
```
[
"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. Votre rôle d'exécution doit satisfaire aux exigences de [Exécuter les opérations prérequises](rstudio-byoi-prerequisites.md).
```
{
"DomainName": "domain-with-custom-r-image",
"VpcId": "",
"SubnetIds": [
""
],
"DomainSettings": {
"RStudioServerProDomainSettings": {
"DomainExecutionRoleArn": ""
}
},
"DefaultUserSettings": {
"ExecutionRole": "",
"RSessionAppSettings": {
"CustomImages": [
{
"AppImageConfigName": "rstudio-custom-config",
"ImageName": "rstudio-custom-image"
}
]
}
},
"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
```
Réponse :
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
"Url": "https://domain-id.studio.region.sagemaker.aws/..."
}
```
### Joindre l' SageMaker image à un domaine existant
Cette méthode suppose que vous avez déjà intégré le domaine. Pour de plus amples informations, veuillez consulter [Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md).
**Note**
Vous devez supprimer toutes les applications de votre domaine avant de mettre à jour le domaine avec la nouvelle version d’image. Pour plus d’informations sur la suppression de ces applications, consultez [Supprimer un domaine Amazon SageMaker AI](gs-studio-delete-domain.md).
Suivez les étapes ci-dessous pour ajouter l' SageMaker image à votre domaine actuel.
+ Obtenez le vôtre `DomainID` depuis la console 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. Sélectionnez le domaine souhaité.
1. Choisissez **Paramètres du domaine**.
1. Sous **Paramètres généraux**, recherchez l’**ID de domaine**. 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
```
Réponse :
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Enregistrez la section `DefaultUserSettings` de la réponse dans un fichier nommé `update-domain-input.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": {
"RSessionAppSettings": {
"CustomImages": [
{
"ImageName": "rstudio-custom-image",
"AppImageConfigName": "rstudio-custom-config"
}
]
}
}
}
```
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://update-domain-input.json
```
Réponse :
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}
```
1. Supprimez l'application `RStudioServerPro`. Vous devez redémarrer l'application `RStudioServerPro` partagée de domaine pour que l'interface utilisateur du RStudio lanceur prenne en compte les dernières modifications.
```
aws sagemaker delete-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
1. Créez une nouvelle application `RStudioServerPro`. Vous devez créer cette application à l’aide de AWS CLI.
```
aws sagemaker create-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
# Lancez une SageMaker image personnalisée dans RStudio
Vous pouvez utiliser votre image personnalisée lorsque vous lancez une RStudio application depuis la console. Une fois que vous avez créé votre SageMaker image personnalisée et que vous l'avez attachée à votre domaine, l'image apparaît dans la boîte de dialogue du sélecteur d'images du RStudio lanceur. Pour lancer une nouvelle RStudio application, suivez les étapes décrites [Lancer RSessions depuis le RStudio lanceur](rstudio-launcher.md) et sélectionnez votre image personnalisée comme indiqué dans l'image suivante.
![\[Capture d'écran du RStudio lanceur avec liste déroulante d'images.\]](http://docs.aws.amazon.com/fr_fr/sagemaker/latest/dg/images/rstudio-launcher-custom.png)
# Nettoyage des ressources d’image
Ce guide explique comment nettoyer les ressources RStudio d'image que vous avez créées dans les sections précédentes. Pour supprimer une image, effectuez les étapes suivantes à l'aide de la console SageMaker AI ou du AWS CLI, comme indiqué dans ce guide.
+ Détachez l'image et les versions d'image de votre domaine Amazon SageMaker AI.
+ Supprimez l’image, la version de l’image et la configuration de l’image de l’application.
Une fois ces étapes terminées, vous pouvez supprimer l'image du conteneur et le référentiel d'Amazon ECR. Pour plus d’informations sur la suppression de l’image du conteneur et du référentiel, consultez [Suppression d’un référentiel](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-delete.html).
## Nettoyez les ressources de la console SageMaker AI
Lorsque vous détachez une image d’un domaine, toutes les versions de l’image sont détachées. Lorsqu’une image est détachée, tous les utilisateurs du domaine perdent l’accès aux versions de l’image.
**Pour détacher une image**
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. Sélectionnez le domaine souhaité.
1. Choisissez **Environnement**.
1. Sous **Images personnalisées attachées au domaine**, choisissez l’image, puis sélectionnez **Détacher**.
1. (Facultatif) Pour supprimer l'image et toutes les versions d' SageMaker AI, sélectionnez **Supprimer également les images sélectionnées...** . Cela ne supprime pas les images associées d’Amazon ECR.
1. Choisissez **Détacher**.
## Nettoyez les ressources du AWS CLI
**Pour nettoyer des ressources**
1. Détachez les versions d’image et l’image de votre domaine en transmettant une liste d’images personnalisée vide au domaine. Ouvrez le fichier `update-domain-input.json` que vous avez créé dans [Joindre l' SageMaker image à votre domaine actuel](studio-byoi-attach.md#studio-byoi-sdk-attach-current-domain).
1. Supprimez les images personnalisées `RSessionAppSettings`, puis enregistrez le fichier. Ne pas modifier les images personnalisées `KernelGatewayAppSettings`.
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
},
"RSessionAppSettings": {
"CustomImages": [
],
"DefaultResourceSpec": {
}
...
}
}
}
```
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://update-domain-input.json
```
Réponse :
```
{
"DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}
```
1. Supprimez la configuration de l'image de l'application.
```
aws sagemaker delete-app-image-config \
--app-image-config-name rstudio-image-config
```
1. Supprimez l' SageMaker image, ce qui supprime également toutes les versions de l'image. Les images de conteneur dans Amazon ECR qui sont représentées par les versions d’image ne sont pas supprimées.
```
aws sagemaker delete-image \
--image-name rstudio-image
```
# Créez un utilisateur à utiliser RStudio
**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.
Une fois que votre domaine Amazon SageMaker AI RStudio activé est en cours d'exécution, vous pouvez ajouter des profils utilisateur (UserProfiles) au domaine. Les rubriques suivantes montrent comment créer des profils utilisateur autorisés et comment RStudio mettre à jour un profil utilisateur existant. Pour savoir comment supprimer une RStudio application ou un domaine UserProfile, suivez les étapes décrites dans [Supprimer un domaine Amazon SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/gs-studio-delete-domain.html).
**Note**
La limite du nombre total de UserProfiles dans un domaine Amazon SageMaker AI est de 60.
Il existe deux types d’utilisateurs :
+ Non autorisé : cet utilisateur ne peut pas accéder à l' RStudio application.
+ Autorisé : cet utilisateur peut accéder à l' RStudio application et utiliser l'un des postes de RStudio licence. Par défaut, un nouvel utilisateur est créé `Authorized` si le domaine est activé pour RStudio.
La modification du statut d’autorisation d’un utilisateur n’est valide que de `Unauthorized` à `Authorized`. Si un utilisateur est autorisé, il peut bénéficier de l'un des niveaux d'accès suivants RStudio.
+ RStudio Utilisateur : il s'agit d'un RStudio utilisateur standard auquel il peut accéder RStudio.
+ RStudio Administrateur : l'administrateur de votre domaine Amazon SageMaker AI a la possibilité de créer des utilisateurs, d'ajouter des utilisateurs existants et de mettre à jour les autorisations des utilisateurs existants. Les administrateurs peuvent également accéder au tableau de bord RStudio administratif. Toutefois, cet administrateur n'est pas en mesure de mettre à jour les paramètres gérés par Amazon SageMaker AI.
## Méthodes de création d’un utilisateur
Les rubriques suivantes expliquent comment créer un utilisateur dans votre domaine Amazon SageMaker AI RStudio activé.
**Créer une console utilisateur**
Pour créer un utilisateur dans votre domaine Amazon SageMaker AI RStudio activé depuis la console, suivez les étapes décrites dans[Ajouter des profils utilisateur](domain-user-profile-add.md).
**Créer une CLI utilisateur**
La commande suivante montre comment ajouter des utilisateurs à un domaine Amazon SageMaker AI avec l'authentification IAM. Un utilisateur peut appartenir au groupe d’utilisateurs `R_STUDIO_USER` ou `R_STUDIO_ADMIN`.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=}
```
La commande suivante montre comment ajouter des utilisateurs à un domaine Amazon SageMaker AI avec authentification à l'aide d'IAM Identity Center. Un utilisateur peut appartenir au groupe d’utilisateurs `R_STUDIO_USER` ou `R_STUDIO_ADMIN`.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=} \
--single-sign-on-user-identifier UserName \
--single-sign-on-user-value
```
# Connectez-vous en RStudio tant qu'autre utilisateur
La rubrique suivante explique comment se connecter à Amazon SageMaker AI RStudio en tant qu'autre utilisateur.
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. Sélectionnez le domaine contenant le profil utilisateur.
1. Sélectionnez un nom d’utilisateur dans la liste des utilisateurs. Une nouvelle page s’ouvre avec les détails sur le profil utilisateur et les applications en cours d’exécution.
1. Sélectionnez **Lancer**.
1. Dans le menu déroulant, sélectionnez cette option **RStudio**pour lancer une RStudio instance.
# Mettre fin aux sessions d’un autre utilisateur
La rubrique suivante explique comment mettre fin aux sessions d'un autre utilisateur RStudio sur Amazon SageMaker AI.
1. Dans la liste des applications en cours d’exécution, repérez l’appli que vous souhaitez supprimer.
1. Cliquez sur le bouton **Delete app** (Supprimer l’appli) correspondant à l’appli que vous supprimez.
# Utiliser le tableau de bord RStudio administratif
Cette rubrique explique comment accéder au tableau de bord RStudio administratif et comment l'utiliser. Grâce au tableau de bord RStudio administratif, les administrateurs peuvent gérer les utilisateurs et consulter RSessions les informations relatives à l'utilisation des instances RStudio du serveur et à Amazon CloudWatch Logs.
## Lancez le tableau de bord RStudio administratif
L'`R_STUDIO_ADMIN`autorisation permet à l'utilisateur d'accéder au tableau de bord RStudio administratif. Un `R_STUDIO_ADMIN` utilisateur peut accéder au tableau de bord RStudio administratif `admin` en `workspaces` remplaçant manuellement par dans son RStudio URL. Voici comment modifier l'URL pour accéder au tableau de bord RStudio administratif.
Par exemple, l' RStudio URL suivante :
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//workspaces
```
Peut être convertie comme suit :
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//admin
```
## Onglet Dashboard (Tableau de bord)
Cet onglet donne un aperçu de l'utilisation de votre instance de RStudio serveur, ainsi que des informations sur le nombre d'instances actives RSessions.
## Onglet Sessions
Cet onglet fournit des informations sur les actifs RSessions, tels que l'utilisateur qui les a lancés RSessions, la RSessions durée de leur exécution et leur utilisation des ressources.
## Onglet Users (Utilisateurs)
Cet onglet fournit des informations sur les utilisateurs RStudio autorisés du domaine, telles que l'heure à laquelle le dernier RSession a été lancé et leur utilisation des ressources.
## Onglet Stats (Statistiques)
Cet onglet fournit des informations sur l'utilisation de votre instance de RStudio serveur.
## Onglet Logs (Journaux)
Cet onglet affiche Amazon CloudWatch Logs pour l'instance RStudio du serveur. Pour plus d'informations sur la journalisation des événements avec Amazon CloudWatch Logs, consultez [Qu'est-ce qu'Amazon CloudWatch Logs ?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) .
# Arrêter RStudio
**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.
Pour arrêter et redémarrer votre Posit Workbench et l' RStudioServerPro application associée, vous devez d'abord arrêter tous vos appareils existants. RSessions Vous pouvez arrêter les applications RSession Gateway de l'intérieur RStudio. Vous pouvez ensuite arrêter l' RStudioServerPro application à l'aide du AWS CLI. Une fois l' RStudioServerPro application arrêtée, vous devez la rouvrir RStudio via la console SageMaker AI.
Toutes les informations de bloc-notes non enregistrées sont perdues au cours du processus. Les données utilisateur du volume Amazon EFS ne sont pas concernées.
**Note**
Si vous utilisez une image personnalisée avec RStudio, assurez-vous que votre image docker utilise une RStudio version compatible avec la version de Posit Workbench utilisée par SageMaker AI après le redémarrage de votre application. RStudio ServerPro
Les rubriques suivantes montrent comment arrêter la RSession passerelle et les RStudio ServerPro applications, puis les redémarrer.
## Suspendez votre RSessions
Effectuez la procédure suivante pour suspendre tous vos RSessions.
1. Dans le RStudio lanceur, identifiez ceux RSession que vous souhaitez suspendre.
1. Sélectionnez **Suspend** (Suspendre) pour la session.
1. Répétez cette opération pour tous RSessions.
## Supprimez votre RSessions
Effectuez la procédure suivante pour arrêter tous vos RSessions.
1. Dans le RStudio lanceur, identifiez RSession ce que vous souhaitez supprimer.
1. Sélectionnez **Quit** (Quitter) pour la session. Cela ouvre une nouvelle fenêtre **Quit Session** (Quitter la session).
1. Dans la fenêtre **Quit Session** (Quitter la session), sélectionnez **Force Quit** (Forcer à quitter) pour mettre fin à tous les processus enfants de la session.
1. Sélectionnez **Quit Session** (Quitter la session) pour confirmer la suppression de la session.
1. Répétez cette opération pour tous RSessions.
## Supprimer votre RStudio ServerPro application
Exécutez les commandes suivantes depuis le AWS CLI pour supprimer et redémarrer votre RStudio ServerPro application.
1. Supprimez l' RStudioServerPro application en utilisant votre identifiant de domaine actuel.
```
aws sagemaker delete-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Recréez l' RStudioServerPro application.
```
aws sagemaker create-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
# Facturation et coût
Pour suivre les coûts associés à votre RStudio environnement, vous pouvez utiliser le AWS Billing and Cost Management service.AWS Billing and Cost Management fournit des outils utiles pour vous aider à recueillir des informations relatives à vos coûts et à votre utilisation, à analyser vos facteurs de coûts et les tendances d'utilisation, et à prendre des mesures pour budgétiser vos dépenses. Pour plus d’informations, consultez [Qu’est-ce qu’ AWS Billing and Cost Management ?](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) Ce qui suit décrit les composants requis pour fonctionner RStudio sur Amazon SageMaker AI et comment chaque composant est pris en compte dans la facturation de votre RStudio instance.
+ RStudio Licence —Vous devez acheter une RStudio licence. L'utilisation de votre RStudio licence avec Amazon SageMaker AI est gratuite. Pour plus d'informations sur votre RStudio licence, consultez[Obtenir une RStudio licence](rstudio-license.md).
+ RSession - Il s'agit RStudio de sessions de travail lancées par les utilisateurs finaux. Vous êtes débité pendant RSession le fonctionnement.
+ RStudio Serveur - Un serveur mutualisé gère tous les RSessions. Vous pouvez choisir le type d'instance sur lequel exécuter le RStudio serveur et payer les coûts associés. L'instance par défaut, « système », est gratuite, mais vous pouvez choisir de payer pour des niveaux supérieurs. Pour plus d'informations sur les types d'instances disponibles pour votre RStudio serveur, consultez[RStudioServerPro type d'instance](rstudio-select-instance.md).
**Suivi de la facturation au niveau de l'utilisateur**
Pour suivre la facturation au niveau de l'utilisateur à l'aide des balises de répartition des coûts, consultez [Utilisation des balises de répartition des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
# Diagnostiquer les problèmes et obtenir une assistance
Les sections suivantes décrivent comment diagnostiquer les problèmes liés RStudio à Amazon SageMaker AI. Pour obtenir de l'aide RStudio sur Amazon SageMaker AI, contactez l'assistance Amazon SageMaker AI. Pour obtenir de l'aide concernant l'achat RStudio d'une licence ou la modification du nombre de postes de licence, contactez [sales@rstudio.com](mailto:sales@rstudio.com).
## Mise à niveau de votre version
Si vous recevez un avertissement indiquant qu'il existe une incompatibilité de version entre vos RStudio ServerPro applications RSession et celles de vos applications, vous devez mettre à jour la version de votre RStudio ServerPro application. Pour de plus amples informations, veuillez consulter [RStudio Versionnage](rstudio-version.md).
## Afficher les métriques et les journaux
Vous pouvez surveiller les performances de votre flux de travail lorsque vous l'utilisez RStudio sur Amazon SageMaker AI. Consultez les journaux de données et les informations sur les métriques à l'aide du tableau de bord RStudio administratif ou d'Amazon CloudWatch.
### Consultez vos RStudio journaux depuis le tableau de bord RStudio administratif
Vous pouvez consulter les statistiques et les journaux directement depuis le tableau de bord RStudio administratif.
1. Connectez-vous à votre **domaine Amazon SageMaker AI**.
1. Accédez au tableau de bord RStudio administratif en suivant les étapes décrites dans[Utiliser le tableau de bord RStudio administratif](rstudio-admin.md).
1. Sélectionnez l'onglet **Logs** (Journaux).
### Afficher vos RStudio journaux depuis Amazon CloudWatch Logs
Amazon CloudWatch surveille vos AWS ressources et les applications que vous utilisez AWS en temps réel. Vous pouvez utiliser Amazon CloudWatch pour collecter et suivre les métriques, qui sont des variables que vous pouvez mesurer pour vos ressources et vos applications. Pour garantir que vos RStudio applications disposent d'autorisations pour Amazon CloudWatch, vous devez inclure les autorisations décrites dans[Présentation du domaine Amazon SageMaker AI](gs-studio-onboard.md). Vous n'avez aucune configuration à effectuer pour collecter les Amazon CloudWatch Logs.
Les étapes suivantes montrent comment afficher Amazon CloudWatch Logs pour votre RSession.
Ces journaux se trouvent dans le flux de `/aws/sagemaker/studio` journaux depuis la AWS CloudWatch console.
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Sélectionnez `Logs` à gauche. Dans le menu déroulant, sélectionnez `Log groups`.
1. Depuis la page `Log groups`, recherchez `aws/sagemaker/studio`. Sélectionnez le groupe de journaux.
1. Depuis la page `aws/sagemaker/studio` `Log group`, accédez à l'onglet `Log streams`.
1. Pour trouver les journaux de votre domaine, recherchez `Log streams` en utilisant le format suivant :
```
/domain-shared/rstudioserverpro/default
```