View a markdown version of this page

Tutoriel : Débuter avec les fichiers S3 - Amazon Simple Storage Service
Commencer à utiliser les fichiers S3 à l'aide de la AWS consoleCommencer à utiliser les fichiers S3 à l'aide de la AWS CLI

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.

Tutoriel : Débuter avec les fichiers S3

Dans ce didacticiel, vous allez créer un système de fichiers S3 et le monter sur une instance EC2. Vous testez ensuite les opérations de base sur les fichiers. Vous pouvez utiliser la console S3 ou la AWS CLI pour démarrer avec S3 Files.

Commencer à utiliser les fichiers S3 à l'aide de la AWS console

Le flux de travail S3 Files sur la console S3 comprend les étapes suivantes :

  • Créez votre système de fichiers S3

  • Montez le système de fichiers sur votre instance EC2 et exécutez les opérations du système de fichiers

Conditions préalables

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

Étape 1 : Création de votre système de fichiers S3

  • Ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

  • Dans la barre de navigation en haut de la page, vérifiez que vous vous trouvez dans la AWS région où se trouvent votre instance EC2 et votre compartiment S3.

  • Dans le volet de navigation de gauche, choisissez Compartiments à usage général.

  • Sélectionnez le bucket pour lequel vous souhaitez créer un système de fichiers.

  • Choisissez l'onglet Systèmes de fichiers.

  • Choisissez Create file system (Créer un système de fichiers).

  • Vérifiez et confirmez votre VPC. Pour ce didacticiel, utilisez votre VPC par défaut.

  • Choisissez Créer.

Lorsque vous créez un système de fichiers à l'aide de la console de AWS gestion, S3 Files crée automatiquement une cible de montage dans chaque zone de disponibilité de votre VPC par défaut et un point d'accès pour le système de fichiers. Cette opération peut prendre quelques minutes. Votre système de fichiers sera disponible pour l'étape suivante une fois que toutes les ressources auront été créées.

Étape 2 : monter le système de fichiers sur votre instance EC2

  • Sur la page Présentation du système de fichiers, choisissez Attacher sous Attacher à une instance EC2. Cela ouvrira une nouvelle page pour monter votre système de fichiers sur une instance EC2.

  • Sélectionnez l'instance EC2 de votre choix dans la liste déroulante Instances EC2 disponibles.

  • Entrez un chemin sur votre instance EC2 où vous souhaitez monter le système de fichiers. Par exemple, /mnt/s3files/.

  • Assurez-vous d'avoir correctement Groupes de sécurité configuré votre instance EC2 et la cible de montage pour permettre au trafic requis de circuler.

  • Assurez-vous de disposer du rôle IAM approprié avec les autorisations requises associées à votre instance EC2 afin qu'elle puisse interagir avec votre système de fichiers S3 et votre compartiment S3. Pour de plus amples informations, veuillez consulter Rôle IAM pour associer votre système de fichiers aux AWS ressources de calcul. Pour ce didacticiel, vous pouvez envisager d'accorder un accès complet au client en ajoutant la politique gérée AmazonS3FilesClientFullAccess au rôle IAM de l'instance EC2.

  • Suivez les instructions de pièce jointe affichées sur la page pour ouvrir CloudShell, monter votre système de fichiers et exécuter les opérations de base du système de fichiers.

Commencer à utiliser les fichiers S3 à l'aide de la AWS CLI

Le flux de travail S3 Files sur la AWS CLI comprend les étapes suivantes :

  1. Créez votre système de fichiers .

  2. Créez des cibles de montage pour votre système de fichiers.

  3. Montez le système de fichiers sur votre instance EC2 à l'aide d'une cible de montage.

  4. Testez les opérations sur les fichiers, telles que le listage d'un répertoire, l'écriture de texte dans un fichier, la lecture d'un fichier et la copie d'un fichier. Vérifiez ensuite que vos modifications sont reflétées dans votre compartiment S3.

Conditions préalables

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

Étape 1 : Création de votre système de fichiers S3

Connectez-vous à votre instance EC2. Exécutez la create-file-system commande pour créer un système de fichiers.

aws s3files create-file-system --region aws-region --bucket bucket-arn --role-arn iam-role

Remplacez les valeurs suivantes par les valeurs souhaitées :

  • aws-region: La AWS région de votre compartiment. Par exemple, us-east-1.

  • bucket-arn: l'ARN de votre compartiment S3.

  • iam-role: ARN du rôle IAM que S3 Files suppose de lire et d'écrire dans votre compartiment S3. Assurez-vous d'avoir ajouté les autorisations appropriées à ce rôle IAM. Pour de plus amples informations, veuillez consulter Rôle IAM pour accéder à votre bucket depuis le système de fichiers.

Après avoir créé le système de fichiers avec succès, S3 Files renvoie la description du système de fichiers au format JSON. Notez l'ID du système de fichiers pour l'étape suivante.

Étape 2 : créer des cibles de montage

Une cible de montage fournit un accès réseau à votre système de fichiers dans votre VPC au sein d'une seule zone de disponibilité. Vous avez besoin d'une cible de montage pour accéder à votre système de fichiers à partir de ressources informatiques. Vous pouvez créer un maximum d'une cible de montage par zone de disponibilité. Nous vous recommandons de créer une cible de montage dans chaque zone de disponibilité dans laquelle vous opérez.

Exécutez la create-mount-target commande suivante pour créer une cible de montage pour votre système de fichiers. Vous devez vous assurer qu'il subnet-id se trouve dans le même VPC que votre instance EC2. Vous devez créer votre cible de montage dans la même zone de disponibilité que votre instance EC2.

aws s3files create-mount-target --region aws-region --file-system-id file-system-id --subnet-id subnet-id

file-system-idVoici l'ID du système de fichiers que vous avez reçu en réponse à la create-file-system commande. La création des cibles de montage peut prendre jusqu'à 5 minutes.

Étape 3 : monter le système de fichiers sur votre instance EC2

Avant de monter votre système de fichiers, assurez-vous d'avoir correctement Groupes de sécurité configuré votre ressource de calcul et la cible de montage pour permettre au trafic requis de circuler. Pour plus de détails sur les groupes de sécurité, consultez le guide de l'utilisateur du VPC.

Exécutez les commandes suivantes pour monter votre système de fichiers :

  • Créez un répertoire /mnt/s3files que vous utiliserez comme point de Montage du système de fichiers à l’aide de la commande suivante :

    sudo mkdir /mnt/s3files

  • Montez le système de fichiers :

    sudo mount -t s3files file-system-id:/ /mnt/s3files

Si vous n'avez pas l'identifiant de votre système de fichiers, vous pouvez le trouver en exécutant la commande suivante :

aws s3files get-file-system --region aws-region --file-system-id file-system-id

Étape 4 : Tester les opérations sur les fichiers

Testez les opérations de base sur les fichiers sur votre système de fichiers monté comme suit :

  • Accédez au répertoire que vous avez monté :

    cd /mnt/s3files

  • Vous pouvez répertorier le contenu de votre répertoire pour vérifier que le contenu de votre compartiment source ou de votre préfixe a été importé. La synchronisation s'effectue généralement en quelques secondes, mais peut prendre plus de temps, en particulier pour le premier fichier. Si votre compartiment est vide, la commande ci-dessous renverra également un résultat vide.

    ls

  • Vous pouvez également tester d'autres opérations sur les fichiers :

    • Créez un fichier :

      echo "Hello, S3 Files!" > test.txt

    • Lisez le fichier :

      cat test.txt

    • Créez un répertoire :

      mkdir test-directory

    • Copiez le fichier dans le répertoire :

      cp /mnt/s3files/test.txt /mnt/s3files/test-directory/

Vous pouvez ensuite accéder à votre compartiment S3 et vérifier que le répertoire est test-directory reflété dans votre compartiment. Notez que la synchronisation des modifications vers votre compartiment S3 peut prendre environ 1 minute.