

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.

# Utilisation de fichiers dans des AWS CodeCommit référentiels
<a name="files"></a>

Dans CodeCommit, un fichier est une information autonome dont la version est contrôlée et qui est accessible à vous et aux autres utilisateurs du référentiel et de la branche où le fichier est stocké. Vous pouvez organiser vos fichiers de référentiel à l'aide d'une structure de répertoires, comme vous le feriez sur un ordinateur. Contrairement à votre ordinateur, il suit CodeCommit automatiquement toutes les modifications apportées à un fichier. Vous pouvez comparer les versions d'un fichier et stocker les différentes versions d'un fichier dans différentes branches du référentiel.

Pour ajouter un ou modifier un fichier dans un référentiel, vous pouvez utiliser un client Git. Vous pouvez également utiliser la CodeCommit console AWS CLI, le ou l' CodeCommit API.

![\[Vue de la création d'un fichier dans la CodeCommit console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-create-file.png)


Pour plus d'informations sur l'utilisation d'autres aspects de votre référentiel dans CodeCommit[Utilisation des référentiels](repositories.md), voir[Utilisation des demandes d'extraction](pull-requests.md),[Utilisation de branches](branches.md),[Travailler avec des commits](commits.md), et[Utilisation des préférences de l'utilisateur](user-preferences.md). 

**Topics**
+ [Parcourir les fichiers d'un AWS CodeCommit référentiel](how-to-browse.md)
+ [Création ou ajout d'un fichier dans un AWS CodeCommit référentiel](how-to-create-file.md)
+ [Modifier le contenu d'un fichier dans un AWS CodeCommit référentiel](how-to-edit-file.md)

# Parcourir les fichiers d'un AWS CodeCommit référentiel
<a name="how-to-browse"></a>

Une fois connecté à un CodeCommit dépôt, vous pouvez le cloner dans un dépôt local ou utiliser la CodeCommit console pour parcourir son contenu. Cette rubrique décrit comment utiliser la CodeCommit console pour parcourir le contenu d'un CodeCommit référentiel.

**Note**  
Pour CodeCommit les utilisateurs actifs, le code de navigation depuis la CodeCommit console est gratuit. Pour obtenir des informations sur les conditions dans lesquelles des frais supplémentaires peuvent s'appliquer, consultez [Tarification](https://aws.amazon.com/codecommit/pricing/).

![\[Affichage du contenu d'un fichier dans la CodeCommit console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-code-browse-file.png)


## Parcourir un CodeCommit référentiel
<a name="how-to-browse-console"></a>

Vous pouvez utiliser la CodeCommit console pour consulter les fichiers contenus dans un référentiel ou pour lire rapidement le contenu d'un fichier. 

**Pour parcourir le contenu d'un référentiel**

1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Sur la page **Référentiels**, dans la liste des référentiels, sélectionnez le référentiel que vous souhaitez parcourir. 

1.  Dans la vue **Code**, parcourez le contenu de la branche par défaut pour votre référentiel. 

   Pour modifier la vue afin d'accéder à une autre branche ou balise, cliquez sur le bouton de sélection de vue. Choisissez un nom de branche ou de balise dans la liste déroulante, ou dans la zone de filtre, saisissez le nom de la branche ou de la balise, puis sélectionnez-le dans la liste.

1. Effectuez l’une des actions suivantes :
   + Pour afficher le contenu d'un répertoire, sélectionnez ce dernier dans la liste. Vous pouvez choisir tout répertoire dans la liste de navigation pour revenir à la vue de ce répertoire. Vous pouvez également utiliser la flèche vers le haut en haut de la liste de répertoires.
   + Pour afficher le contenu d'un fichier, sélectionnez ce dernier dans la liste. Si la taille du fichier dépasse la limite d'objet de validation, celui-ci ne peut pas être affiché dans la console et doit être consulté dans un dépôt local à la place. Pour de plus amples informations, veuillez consulter [Quotas](limits.md). Pour quitter la vue de fichier, dans la barre de navigation du code, sélectionnez le répertoire que vous souhaitez afficher.
**Note**  
 Les fichiers binaires ne sont pas tous visibles dans la console. Si vous choisissez un fichier binaire et qu'il est potentiellement consultable, un message d'avertissement apparaît, vous demandant de confirmer que vous souhaitez afficher le contenu. Pour afficher le fichier, choisissez **Afficher le contenu du fichier**. Si vous ne souhaitez pas afficher le fichier, dans la barre de navigation du code, sélectionnez le répertoire que vous souhaitez afficher.  
Si vous choisissez un fichier Markdown (.md), utilisez les boutons **Markdown affiché** et **Source Markdown** pour basculer entre les vues de rendu et de syntaxe. Pour plus d'informations, consultez la section [Utilisation de Markdown dans la console.](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)

# Création ou ajout d'un fichier dans un AWS CodeCommit référentiel
<a name="how-to-create-file"></a>

Vous pouvez utiliser la CodeCommit console ou un client Git pour ajouter un fichier dans un dépôt. AWS CLI Vous pouvez charger un fichier à partir de votre ordinateur local dans le référentiel, ou vous pouvez utiliser l'éditeur de code dans la console pour créer le fichier. L'éditeur constitue un moyen simple et rapide d'ajouter un fichier simple, tel qu'un fichier readme.md, dans une branche d'un référentiel. 

![\[Vue du téléchargement d'un fichier dans la console CodeCommit\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-commit-first-file.png)


**Topics**
+ [Création ou téléchargement d'un fichier (console)](#how-to-create-file-console)
+ [Ajouter un fichier (AWS CLI)](#how-to-create-file-cli)
+ [Ajouter un fichier (Git)](#how-to-create-file-git)

## Création ou téléchargement d'un fichier (console)
<a name="how-to-create-file-console"></a>

Vous pouvez utiliser la CodeCommit console pour créer un fichier et l'ajouter à une branche d'un CodeCommit référentiel. Dans le cadre de la création du fichier, vous pouvez fournir votre nom d'utilisateur et une adresse e-mail. Vous pouvez également ajouter un message de validation pour informer les autres utilisateurs sur la personne qui a ajouté le fichier et ses motivations. Vous pouvez également télécharger un fichier directement à partir de votre ordinateur local vers une branche d'un référentiel.

**Pour ajouter un fichier dans un référentiel**

1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Dans **Repositories** (Référentiels), choisissez le référentiel dans lequel vous souhaitez ajouter un fichier.

1. Dans la vue **Code**, choisissez la branche dans laquelle vous souhaitez ajouter le fichier. Par défaut, le contenu de la branche par défaut s'affiche lorsque vous ouvrez la vue **Code**. 

   Pour afficher la vue d'une autre branche, choisissez le bouton de sélection de vue. Choisissez un nom de branche dans la liste déroulante ou, dans la zone de filtre, saisissez le nom de la branche, puis sélectionnez-la dans la liste.

1. Choisissez **Add file** (Ajouter un fichier), puis choisissez l'une des options suivantes :
   +  Pour utiliser l'éditeur de code pour créer le contenu d'un fichier et l'ajouter dans le référentiel, choisissez **Create file (Créer un fichier)**.
   + Pour charger un fichier à partir de votre ordinateur local dans le référentiel, choisissez **Upload file (Charger le fichier)**.

1. Fournissez des informations aux autres utilisateurs sur la personne qui a ajouté ce fichier dans le référentiel et ses motivations. 
   + Dans **Nom de l'auteur**, saisissez votre nom. Ce nom est utilisé à la fois comme nom de l'auteur et comme nom du validateur dans les informations de validation. CodeCommit utilise par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console comme nom d'auteur.
   + Dans **Adresse e-mail**, entrez une adresse e-mail afin que les autres utilisateurs du référentiel puissent vous contacter à propos de cette modification. 
   + Dans **Message de validation**, saisissez une brève description. Cette étape est facultative, mais vivement recommandée. Dans le cas contraire, un message de validation par défaut est utilisé.

1. Effectuez l’une des actions suivantes :
   + Si vous chargez un fichier, choisissez le fichier à partir de votre ordinateur local.
   + Si vous créez un fichier, saisissez le contenu que vous souhaitez ajouter dans l'éditeur de code et nommez le fichier.

1. Choisissez **Valider les modifications**.

## Ajouter un fichier (AWS CLI)
<a name="how-to-create-file-cli"></a>

Vous pouvez utiliser la **put-file** commande AWS CLI et pour ajouter un fichier dans un CodeCommit référentiel. Vous pouvez également utiliser la commande **put-file** pour ajouter un répertoire ou une structure de dossiers pour le fichier.

**Note**  
Pour utiliser AWS CLI des commandes avec CodeCommit, installez le AWS CLI. Pour de plus amples informations, veuillez consulter [Référence des commandes en ligne](cmd-ref.md). 

**Pour ajouter un fichier dans un référentiel**

1. Sur votre ordinateur local, créez le fichier que vous souhaitez ajouter dans le référentiel CodeCommit.

1. Depuis le terminal ou la ligne de commande, exécutez la commande **put-file**, en spécifiant :
   + Le référentiel dans lequel vous souhaitez ajouter le fichier.
   + La branche dans laquelle vous souhaitez ajouter le fichier.
   + L'ID de validation complet de la validation la plus récente effectuée dans cette branche, également connue sous le nom de validation de tête.
   + L'emplacement local du fichier. La syntaxe utilisée pour cet emplacement varie en fonction de votre système d'exploitation local.
   + Le nom du fichier que vous souhaitez ajouter, y compris le chemin où le fichier mis à jour est stocké dans le référentiel, le cas échéant.
   + Le nom d'utilisateur et l'adresse e-mail que vous voulez associer à ce fichier.
   + Un message de validation qui explique pourquoi vous avez ajouté ce fichier.

   Le nom d'utilisateur, l'adresse e-mail et le message de validation sont facultatifs mais aident les autres utilisateurs à savoir qui a effectué la modification et pourquoi. Si vous ne fournissez pas de nom d'utilisateur, utilisez CodeCommit par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console comme nom d'auteur.

   Par exemple, pour ajouter un fichier nommé *ExampleSolution.py* dans un référentiel nommé *MyDemoRepo* dans une branche nommée *feature-randomizationfeature* dont le dernier commit a l'ID *4c925148EXAMPLE* :

   ```
   aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I added a third randomization routine."
   ```
**Note**  
Lorsque vous ajoutez des fichiers binaires, veillez à utiliser `fileb://` pour spécifier l'emplacement local du fichier.

   Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   ```
   {
      "blobId": "2eb4af3bEXAMPLE",
      "commitId": "317f8570EXAMPLE",
      "treeId": "347a3408EXAMPLE"
   }
   ```

## Ajouter un fichier (Git)
<a name="how-to-create-file-git"></a>

Vous pouvez ajouter des fichiers dans un dépôt local et transférer vos modifications vers un CodeCommit référentiel. Pour de plus amples informations, veuillez consulter [Commencer à utiliser Git et AWS CodeCommit](getting-started.md).

# Modifier le contenu d'un fichier dans un AWS CodeCommit référentiel
<a name="how-to-edit-file"></a>

Vous pouvez utiliser la CodeCommit console ou un client Git pour modifier le contenu d'un fichier dans un CodeCommit référentiel. AWS CLI

![\[Vue de la modification d'un fichier dans la CodeCommit console\]](http://docs.aws.amazon.com/fr_fr/codecommit/latest/userguide/images/codecommit-edit-file.png)


**Topics**
+ [Modifier un fichier (console)](#how-to-edit-file-console)
+ [Modifier ou supprimer un fichier (AWS CLI)](#how-to-edit-file-cli)
+ [Modifier un fichier (Git)](#how-to-edit-file-git)

## Modifier un fichier (console)
<a name="how-to-edit-file-console"></a>

Vous pouvez utiliser la CodeCommit console pour modifier un fichier qui a été ajouté à une branche d'un CodeCommit référentiel. Dans le cadre de la modification du fichier, vous pouvez fournir votre nom d'utilisateur et une adresse e-mail. Vous pouvez également ajouter un message de validation pour informer les autres utilisateurs sur la personne qui a effectué la modification et ses motivations.

**Pour modifier un fichier dans un référentiel**

1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Dans **Repositories** (Référentiels), choisissez le référentiel dans lequel vous souhaitez modifier un fichier. 

1. Dans la vue **Code**, choisissez la branche dans laquelle vous souhaitez modifier le fichier. Par défaut, le contenu de la branche par défaut s'affiche lorsque vous ouvrez la vue **Code**. 

   Pour afficher la vue d'une autre branche, choisissez le bouton de sélection de vue. Choisissez un nom de branche dans la liste déroulante ou, dans la zone de filtre, saisissez le nom de la branche, puis sélectionnez-la dans la liste.

1. Parcourez le contenu de la branche et choisissez le fichier que vous souhaitez modifier. Dans la vue de fichier, choisissez **Modifier**.
**Note**  
Si vous choisissez un fichier binaire, un message d'avertissement s'affiche vous demandant de confirmer que vous souhaitez en afficher le contenu. Vous ne devez pas utiliser la CodeCommit console pour modifier des fichiers binaires.

1. Modifiez le fichier et fournissez des informations aux autres utilisateurs sur la personne qui a effectué cette modification et ses motivations. 
   + Dans **Nom de l'auteur**, saisissez votre nom. Ce nom est utilisé à la fois comme nom de l'auteur et comme nom du validateur dans les informations de validation. CodeCommit utilise par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console comme nom d'auteur.
   + Dans **Adresse e-mail**, entrez une adresse e-mail afin que les autres utilisateurs du référentiel puissent vous contacter à propos de cette modification. 
   + Dans **Message de validation**, saisissez une brève description des modifications que vous avez apportées.

1. Choisissez **Valider les modifications** pour enregistrer vos modifications dans le fichier et valider les modifications dans le référentiel.

## Modifier ou supprimer un fichier (AWS CLI)
<a name="how-to-edit-file-cli"></a>

Vous pouvez utiliser la **put-file** commande AWS CLI et pour apporter des modifications à un fichier d'un CodeCommit référentiel. Vous pouvez également utiliser la commande **put-file** pour ajouter un répertoire ou une structure de dossiers pour le fichier modifié, si vous souhaitez stocker le fichier modifié dans un emplacement différent de l'original. Si vous souhaitez supprimer entièrement un fichier, vous pouvez utiliser la commande **delete-file**.

**Note**  
Pour utiliser AWS CLI des commandes avec CodeCommit, installez le AWS CLI. Pour de plus amples informations, veuillez consulter [Référence des commandes en ligne](cmd-ref.md). 

**Pour modifier un fichier dans un référentiel**

1. À l'aide d'une copie locale du fichier, apportez les modifications que vous souhaitez ajouter au référentiel CodeCommit.

1. Depuis le terminal ou la ligne de commande, exécutez la commande **put-file**, en spécifiant :
   + Le référentiel dans lequel vous souhaitez ajouter le fichier modifié.
   + La branche dans laquelle vous souhaitez ajouter le fichier modifié.
   + L'ID de validation complet de la validation la plus récente effectuée dans cette branche, également connue sous le nom de validation de tête.
   + L'emplacement local du fichier.
   + Le nom du fichier mis à jour que vous souhaitez ajouter, y compris le chemin où le fichier mis à jour est stocké dans le référentiel, le cas échéant.
   + Le nom d'utilisateur et l'adresse e-mail que vous voulez associer à cette modification de fichier.
   + Un message de validation qui explique la modification que vous avez effectuée.

   Le nom d'utilisateur, l'adresse e-mail et le message de validation sont facultatifs mais aident les autres utilisateurs à savoir qui a effectué la modification et pourquoi. Si vous ne fournissez pas de nom d'utilisateur, utilisez CodeCommit par défaut votre nom d'utilisateur IAM ou une dérivation de votre identifiant de connexion à la console.

   Par exemple, pour ajouter des modifications apportées à un fichier nommé *ExampleSolution.py* dans un référentiel nommé *MyDemoRepo* dans une branche *feature-randomizationfeature* dont le dernier commit a l'*4c925148EXAMPLE*ID :

   ```
   aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I fixed the bug Mary found."
   ```
**Note**  
Si vous souhaitez ajouter un fichier binaire modifié, veillez à utiliser `--file-content` avec la notation `fileb://MyDirectory/MyFile.raw`.

   Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

   ```
   {
      "blobId": "2eb4af3bEXAMPLE",
      "commitId": "317f8570EXAMPLE",
      "treeId": "347a3408EXAMPLE"
   }
   ```

Pour supprimer un fichier, utilisez la commande **delete-file**. Par exemple, pour supprimer un fichier nommé *README.md* dans une branche *main* portant le plus récent ID de validation ou *c5709475EXAMPLE* dans un référentiel nommé *MyDemoRepo* :

```
aws codecommit delete-file --repository-name MyDemoRepo --branch-name main --file-path README.md --parent-commit-id c5709475EXAMPLE
```

Si elle aboutit, cette commande renvoie une sortie similaire à ce qui suit :

```
{
  "blobId":"559b44fEXAMPLE",
  "commitId":"353cf655EXAMPLE",
  "filePath":"README.md",
  "treeId":"6bc824cEXAMPLE"
}
```

## Modifier un fichier (Git)
<a name="how-to-edit-file-git"></a>

Vous pouvez modifier des fichiers dans un dépôt local et transférer vos modifications vers un CodeCommit référentiel. Pour de plus amples informations, veuillez consulter [Commencer à utiliser Git et AWS CodeCommit](getting-started.md).