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 :
+ Vous avez terminé le[AWS configuration du compte et du calcul](s3-files-prereq-policies.md#s3-files-prereq-account-setup).
+ Vous êtes configuré avec Amazon EC2 et vous êtes habitué au lancement d'instances EC2. Pour plus d'informations, consultez [Démarrer avec Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) dans le *Guide de l'utilisateur Amazon EC2*. Pour ce didacticiel, utilisez le VPC par défaut pour votre instance EC2.
+ Vous avez une instance [Rôle IAM pour associer votre système de fichiers aux AWS ressources de calcul](s3-files-prereq-policies.md#s3-files-prereq-iam-compute-role) attachée à votre instance EC2 afin qu'elle puisse interagir avec votre système de fichiers S3 et votre compartiment S3.
### Étape 1 : Création de votre système de fichiers S3
+ Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](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é](s3-files-prereq-policies.md#s3-files-prereq-security-groups) 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](s3-files-prereq-policies.md#s3-files-prereq-iam-compute-role). 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 .
1. Créez des cibles de montage pour votre système de fichiers.
1. Montez le système de fichiers sur votre instance EC2 à l'aide d'une cible de montage.
1. 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 :
+ Vous avez installé et configuré la AWS CLI. Pour plus d’informations, consultez [Installation ou mise à jour vers la dernière version de l’interface AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
+ Vous avez rempli tous les prérequis décrits dans[Prérequis pour les fichiers S3](s3-files-prereq-policies.md).
+ Vous êtes configuré avec Amazon EC2 et vous êtes habitué au lancement d'instances EC2. Vous avez besoin d'un AWS compte, d'un utilisateur disposant d'un accès administratif, d'une paire de clés et d'un groupe de sécurité. Pour plus d'informations, consultez [Démarrer avec Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) dans le *Guide de l'utilisateur Amazon EC2*.
### Étape 1 : Création de votre système de fichiers S3
[Connectez-vous à votre instance EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect.html). 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](s3-files-prereq-policies.md#s3-files-prereq-iam-creation-role).
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-id}}Voici 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é](s3-files-prereq-policies.md#s3-files-prereq-security-groups) 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](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html).
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.