Configuration de votre stockage Amazon S3

Lorsque vous configurez votre application SageMaker Canvas, l'emplacement de stockage par défaut pour les artefacts du modèle, les ensembles de données et les autres données d'application est un compartiment Amazon S3 créé par Canvas. Ce compartiment Amazon S3 par défaut suit le modèle de dénomination s3://sagemaker-{Region}-{your-account-id} et se trouve dans la même région que votre application Canvas.

Cependant, vous pouvez personnaliser l'emplacement de stockage et spécifier votre propre compartiment Amazon S3 pour y stocker les données de l'application Canvas. Vous pouvez utiliser votre propre compartiment Amazon S3 pour stocker les données d'application pour l'une des raisons suivantes :

• Votre organisation dispose de conventions de dénomination internes pour les compartiments Amazon S3.

• Vous souhaitez activer l'accès intercompte aux artefacts de modèle ou à d'autres données Canvas.

• Vous devez respecter les directives de sécurité internes, telles que la restriction des utilisateurs à certains compartiments Amazon S3 ou à certains artefacts de modèle.

• Vous souhaitez améliorer la visibilité et l'accès aux journaux produits par Canvas, indépendamment de la AWS console ou de SageMaker Studio Classic.

En spécifiant votre propre compartiment Amazon S3, vous pouvez mieux contrôler votre propre stockage et être en conformité avec votre organisation.

Pour commencer, vous pouvez soit créer un nouveau SageMaker domaine ou un nouveau profil utilisateur, soit mettre à jour un domaine ou un profil utilisateur existant. Notez que les paramètres du profil utilisateur remplacent les paramètres au niveau du domaine. Par exemple, vous pouvez utiliser la configuration de compartiment par défaut au niveau du domaine, mais vous pouvez spécifier un compartiment Amazon S3 personnalisé pour un utilisateur individuel. Après avoir spécifié votre propre compartiment Amazon S3 pour le domaine ou le profil utilisateur, Canvas crée un sous-dossier appelé Canvas/<UserProfileName> sous l'entrée Amazon S3 URI et enregistre tous les artefacts générés dans l'application Canvas dans ce sous-dossier.

Important

Si vous mettez à jour un domaine ou un profil utilisateur existant, vous n'avez plus accès à vos artefacts Canvas depuis l'emplacement précédent. Vos fichiers se trouvent toujours dans l'ancien emplacement Amazon S3, mais vous ne pouvez plus les consulter à partir de Canvas. La nouvelle configuration prendra effet la prochaine fois que vous vous connecterez à l'application.

Pour plus d'informations sur l'octroi d'un accès intercompte à votre compartiment Amazon S3, consultez Octroi d'autorisations d'objets entre comptes dans le Guide de l'utilisateur Amazon S3.

Les sections suivantes expliquent comment spécifier un compartiment Amazon S3 personnalisé pour votre configuration de stockage Canvas. Si vous configurez un nouveau SageMaker domaine (ou un nouvel utilisateur dans un domaine), utilisez le Nouvelle méthode de configuration de domaine ou leNouvelle méthode de configuration de profil utilisateur. Si vous possédez déjà un profil utilisateur Canvas et que vous souhaitez mettre à jour la configuration de stockage du profil, utilisez la Méthode utilisateur existante.

Avant de commencer

Si vous spécifiez un Amazon S3 URI à partir d'un autre AWS compte, ou si vous utilisez un compartiment chiffré avec AWS KMS, vous devez configurer les autorisations avant de continuer. Vous devez accorder AWS IAM des autorisations pour que Canvas puisse télécharger et charger des objets depuis et vers votre bucket. Pour plus d'informations sur l'octroi des autorisations requises, consultez Octroi d'autorisations pour le stockage Amazon S3 entre comptes.

En outre, le dossier Amazon S3 final URI pour le dossier de formation de votre emplacement de stockage Canvas doit comporter 128 caractères ou moins. L'Amazon S3 final URI comprend le chemin s3://<your-bucket-name>/<folder-name>/ de votre compartiment et le chemin que Canvas ajoute à votre compartiment :Canvas/<user-profile-name>/Training. Voici par exemple un chemin acceptable de moins de 128 caractères : s3://<my-bucket>/<machine-learning>/Canvas/<user-1>/Training.

Nouvelle méthode de configuration de domaine

Si vous configurez un nouveau domaine et une nouvelle application Canvas, utilisez cette section pour configurer l'emplacement de stockage au niveau du domaine. Cette configuration s'applique à tous les nouveaux utilisateurs que vous créez dans le domaine, sauf si vous spécifiez un emplacement de stockage différent pour les profils utilisateur individuels.

Lorsque vous effectuez une configuration standard pour votre domaine, sur la page Étape 3 : Configuration des applications - Facultatif, suivez la procédure suivante pour la section Canvas :

1. Pour Configuration du stockage Canvas, procédez comme suit :

   1. Sélectionnez Système géré si vous souhaitez définir l'emplacement du SageMaker compartiment par défaut qui suit le modèles3://sagemaker-{Region}-{your-account-id}.

   2. Sélectionnez S3 personnalisé pour spécifier votre propre compartiment Amazon S3 comme emplacement de stockage. Entrez ensuite l'Amazon S3URI.

   3. (Facultatif) Pour la clé de chiffrement, spécifiez une KMS clé pour chiffrer les artefacts Canvas stockés à l'emplacement spécifié.

2. Terminez la configuration du domaine et choisissez Soumettre.

Votre domaine est désormais configuré pour utiliser l'emplacement Amazon S3 que vous avez spécifié pour le stockage des applications SageMaker Canvas.

Nouvelle méthode de configuration de profil utilisateur

Si vous configurez un nouveau profil utilisateur dans votre domaine, utilisez cette section pour configurer l'emplacement de stockage de l'utilisateur. Cette configuration remplace la configuration au niveau du domaine.

Lorsque vous ajoutez un profil utilisateur à votre domaine, pour l'étape 2 : Configuration des applications, suivez la procédure suivante pour la section Canvas :

1. Pour Configuration du stockage Canvas, procédez comme suit :

   1. Sélectionnez Système géré si vous souhaitez définir l'emplacement du compartiment SageMaker créé par défaut selon le modèles3://sagemaker-{Region}-{your-account-id}.

   2. Sélectionnez S3 personnalisé pour spécifier votre propre compartiment Amazon S3 comme emplacement de stockage. Entrez ensuite l'Amazon S3URI.

   3. (Facultatif) Pour la clé de chiffrement, spécifiez une KMS clé pour chiffrer les artefacts Canvas stockés à l'emplacement spécifié.

2. Terminez la configuration du profil utilisateur et choisissez Soumettre.

Votre profil utilisateur est désormais configuré pour utiliser l'emplacement Amazon S3 que vous avez spécifié pour le stockage des applications SageMaker Canvas.

Méthode utilisateur existante

Si vous avez déjà un profil utilisateur Canvas et que vous souhaitez mettre à jour l'emplacement de stockage Amazon S3, vous pouvez modifier les paramètres du SageMaker domaine ou du profil utilisateur. Le changement prendra effet la prochaine fois que vous vous connecterez à l'application Canvas.

Note

Lorsque vous modifiez l'emplacement de stockage d'une application Canvas existante, vous perdez l'accès à vos artefacts Canvas à partir de l'emplacement de stockage précédent. Les artefacts sont toujours stockés dans l'ancien emplacement Amazon S3, mais vous ne pouvez plus les consulter à partir de Canvas.

N'oubliez pas que les paramètres du profil utilisateur remplacent les paramètres généraux du domaine. Vous pouvez donc mettre à jour l'emplacement de stockage Amazon S3 pour des profils utilisateur spécifiques sans le modifier pour tous les utilisateurs. Vous pouvez mettre à jour la configuration de stockage pour un domaine ou un utilisateur existant à l'aide des procédures suivantes.

Update an existing domain

Utilisez la procédure suivante pour mettre à jour la configuration de stockage d'un domaine.

1. Ouvrez la SageMaker console à 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, choisissez votre domaine.

5. Sur la page des détails du domaine, choisissez l'onglet Configurations de l'application.

6. Faites défiler la page jusqu'à la section Canvas et choisissez Modifier.

7. La page Modifier les paramètres du canevas s'ouvre. Pour la section de configuration du stockage Canvas, procédez comme suit :

   1. Sélectionnez Système géré si vous souhaitez définir l'emplacement du compartiment SageMaker créé par défaut selon le modèles3://sagemaker-{Region}-{your-account-id}.

   2. Sélectionnez S3 personnalisé pour spécifier votre propre compartiment Amazon S3 comme emplacement de stockage. Entrez ensuite l'Amazon S3URI.

   3. (Facultatif) Pour la clé de chiffrement, spécifiez une KMS clé pour chiffrer les artefacts Canvas stockés à l'emplacement spécifié.

8. Terminez toutes les autres modifications que vous souhaitez apporter au domaine, puis choisissez Soumettre pour enregistrer vos modifications.

Update an existing user profile

Procédez comme suit pour mettre à jour la configuration de stockage d'un profil utilisateur.

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

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

3. Sous Configurations d'administration, sélectionnez les domaines.

4. Dans la liste des domaines, choisissez votre domaine.

5. Dans la liste des utilisateurs du domaine, choisissez l'utilisateur dont vous souhaitez modifier la configuration.

6. Sur la page User Details (Détails de l'utilisateur), choisissez Edit (Modifier).

7. Dans le panneau de navigation, choisissez Paramètres de Canvas.

8. Pour Configuration du stockage Canvas, procédez comme suit :

   1. Sélectionnez Système géré si vous souhaitez définir l'emplacement du SageMaker compartiment par défaut qui suit le modèles3://sagemaker-{Region}-{your-account-id}.

   2. Sélectionnez S3 personnalisé pour spécifier votre propre compartiment Amazon S3 comme emplacement de stockage. Entrez ensuite l'Amazon S3URI.

   3. (Facultatif) Pour la clé de chiffrement, spécifiez une KMS clé pour chiffrer les artefacts Canvas stockés à l'emplacement spécifié.

9. Terminez toutes les autres modifications que vous souhaitez apporter au profil utilisateur, puis choisissez Soumettre pour enregistrer vos modifications.

L'emplacement de stockage de votre profil utilisateur Canvas doit maintenant être mis à jour. La prochaine fois que vous vous connecterez à l'application Canvas, vous recevrez une notification indiquant que l'emplacement de stockage a été mis à jour. Vous perdez l'accès à tous les artefacts que vous avez créés précédemment dans Canvas. Vous pouvez toujours accéder aux fichiers dans Amazon S3, mais vous ne pouvez plus les consulter dans Canvas.