Création d’un espace partagé - Amazon SageMaker AI
Ajout de la prise en charge des espaces partagés à un domaine existantCréation d’un espace partagé

Création d’un espace partagé

Important

Les politiques IAM personnalisées qui autorisent Amazon SageMaker Studio ou Amazon SageMaker Studio Classic à créer des ressources Amazon SageMaker doivent également accorder des autorisations pour ajouter des balises à ces ressources. L’autorisation d’ajouter des balises aux ressources est requise, car Studio et Studio Classic balisent automatiquement toutes les ressources qu’ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n’autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour plus d’informations, consultez Octroi d’autorisations pour baliser les ressources SageMaker AI.

Les Politiques gérées par AWS pour Amazon SageMaker AI qui autorisent la création de ressources SageMaker incluent déjà des autorisations permettant d’ajouter des balises lors de la création de ces ressources.

La rubrique suivante illustre comment créer un espace partagé dans un domaine Amazon SageMaker AI existant. Si vous avez créé votre domaine sans prendre en charge les espaces partagés, vous devez ajouter la prise en charge des espaces partagés à votre domaine existant avant de pouvoir créer un espace partagé.

Ajout de la prise en charge des espaces partagés à un domaine existant

Vous pouvez utiliser la console SageMaker AI ou l’AWS CLI pour ajouter la prise en charge des espaces partagés à un domaine existant. Si le domaine utilise un accès réseau VPC only, vous ne pouvez ajouter la prise en charge des espaces partagés qu’à l’aide de l’AWS CLI.

console

Suivez la procédure ci-dessous pour ajouter la prise en charge des espaces partagés Studio Classic à un domaine existant depuis la console SageMaker AI.

  1. Ouvrez la console Amazon SageMaker AI à l’adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Domaines.

  4. Dans la liste des domaines, sélectionnez le domaine pour lequel vous souhaitez ouvrir la page Paramètres du domaine.

  5. Sur la page Détails du domaine, choisissez l’onglet Paramètres du domaine.

  6. Choisissez Modifier.

  7. Pour Rôle d’exécution par défaut pour l’espace, définissez un rôle IAM qui est utilisé par défaut pour tous les espaces partagés créés dans le domaine.

  8. Choisissez Suivant.

  9. Choisissez Suivant.

  10. Choisissez Suivant.

  11. Sélectionnez Soumettre.

AWS CLI

Studio Classic

Exécutez la commande suivante à partir du terminal de votre machine locale pour ajouter des paramètres d’espace partagé par défaut à un domaine depuis l’AWS CLI. Si vous ajoutez les paramètres d’espace partagé par défaut à un domaine au sein d’un réseau Amazon VPC, vous devez également inclure une liste de groupes de sécurité. Les espaces partagés Studio Classic ne prennent en charge que l’utilisation des ARN d’images JupyterLab 3. Pour plus d’informations, consultez Gestion des versions de JupyterLab dans Amazon SageMaker Studio Classic.

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn=sagemaker-image-arn}},SecurityGroups=[security-groups]"

Utilisez la commande suivante pour vérifier que les paramètres d’espace partagé par défaut ont été mis à jour. 


aws --region region \
sagemaker describe-domain \
--domain-id domain-id
JupyterLab

Exécutez la commande suivante à partir du terminal de votre machine locale pour ajouter des paramètres d’espace partagé par défaut à un domaine depuis l’AWS CLI. Si vous ajoutez les paramètres d’espace partagé par défaut à un domaine au sein d’un réseau Amazon VPC, vous devez également inclure une liste de groupes de sécurité. Les espaces partagés Studio Classic ne prennent en charge que l’utilisation des ARN d’images JupyterLab 4. Pour plus d’informations, consultez Gestion des versions de JupyterLab dans Amazon SageMaker Studio Classic.

# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn", JupyterLabAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"

# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn, SecurityGroups=[security-groups]"

Utilisez la commande suivante pour vérifier que les paramètres d’espace partagé par défaut ont été mis à jour. 


aws --region region \
sagemaker describe-domain \
--domain-id domain-id

Création d’un espace partagé

Les sections suivantes montrent comment créer un espace partagé à partir de la console Amazon SageMaker AI, d’Amazon SageMaker Studio ou de l’AWS CLI.

Utilisez les procédures suivantes pour créer un espace partagé dans un domaine à partir de Studio.

Studio Classic

  1. Accédez à Studio en suivant les étapes décrites dans Lancement d’Amazon SageMaker Studio.

  2. Dans l’interface utilisateur de Studio, recherchez le volet des applications sur le côté gauche.

  3. Dans le volet des applications, sélectionnez Studio Classic.

  4. Choisissez Créer un espace Studio Classic.

  5. Dans la fenêtre contextuelle, saisissez un nom pour l’espace.

  6. Choisissez Créer un espace.

JupyterLab

  1. Accédez à Studio en suivant les étapes décrites dans Lancement d’Amazon SageMaker Studio.

  2. Dans l’interface utilisateur de Studio, recherchez le volet des applications sur le côté gauche.

  3. Dans le volet des applications, sélectionnez JupyterLab.

  4. Choisissez Créer un espace JupyterLab.

  5. Dans la fenêtre contextuelle, saisissez un nom pour l’espace.

  6. Choisissez Créer un espace.

Suivez la procédure ci-dessous pour créer un espace partagé dans un domaine à partir de la console SageMaker AI.

  1. Ouvrez la console Amazon SageMaker AI à l’adresse https://console.aws.amazon.com/sagemaker/.

  2. Dans le panneau de navigation de gauche, choisissez Configurations d’administrateur.

  3. Sous Configurations d’administrateur, choisissez Domaines.

  4. Dans la liste des domaines, sélectionnez le domaine pour lequel vous souhaitez créer un espace partagé.

  5. Sur la page Détails du domaine, choisissez l’onglet Gestion de l’espace.

  6. Choisissez Créer.

  7. Entrez un nom pour votre espace partagé. Les noms des espaces partagés au sein d’un domaine doivent être uniques. Le rôle d’exécution pour l’espace partagé est défini sur le rôle d’exécution IAM du domaine.

Cette section vous montre comment créer un espace partagé depuis l'AWS CLI.

Vous ne pouvez pas définir le rôle d'exécution d'un espace partagé lors de sa création ou de sa mise à jour. Le paramètre DefaultDomainExecRole ne peut être défini que lors de la création ou de la mise à jour du domaine. Les espaces partagés prennent en charge uniquement l’utilisation des ARN d’images JupyterLab 3. Pour plus d’informations, consultez Gestion des versions de JupyterLab dans Amazon SageMaker Studio Classic.

Pour créer un espace partagé depuis l’AWS CLI, exécutez l’une des commandes suivantes à partir du terminal de votre ordinateur local.

Studio Classic

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--space-settings '{
  "JupyterServerAppSettings": {
    "DefaultResourceSpec": {
      "SageMakerImageArn": "sagemaker-image-arn",
      "InstanceType": "system"
    }
  }
}'
JupyterLab

aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--ownership-settings "{\"OwnerUserProfileName\": \"user-profile-name\"}" \
--space-sharing-settings "{\"SharingType\": \"Shared\"}" \
--space-settings "{\"AppType\": \"JupyterLab\"}"