

Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).

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.

# Gestion des fichiers de code source sur Amazon CodeCatalyst
<a name="source-files"></a>

Sur Amazon CodeCatalyst, 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 source et de la succursale où le fichier est stocké. Vous pouvez organiser les fichiers de votre référentiel à l'aide d'une structure de répertoires. CodeCatalystsuit automatiquement toutes les modifications apportées à un fichier. Vous pouvez stocker différentes versions d'un fichier dans différentes branches du référentiel.

Pour ajouter ou modifier plusieurs fichiers dans un référentiel source, vous pouvez utiliser un client Git, un environnement de développement ou un environnement de développement intégré (IDE). Pour ajouter ou modifier un seul fichier, vous pouvez utiliser la CodeCatalyst console. 

**Topics**
+ [Création ou ajout d'un fichier](source-files-create.md)
+ [Affichage d'un fichier](source-files-view.md)
+ [Afficher l'historique des modifications apportées à un fichier](source-files-view-history.md)
+ [Modification d'un fichier](source-files-edit.md)
+ [Modification du nom ou suppression d'un fichier](source-files-delete.md)

# Création ou ajout d'un fichier
<a name="source-files-create"></a>

Pour créer et ajouter des fichiers à un référentiel source, vous pouvez utiliser la CodeCatalyst console Amazon, un environnement de développement intégré (IDE) connecté ou un client Git. La CodeCatalyst console inclut un éditeur de code pour créer des fichiers. Cet éditeur est un moyen pratique de créer ou de modifier un fichier simple, tel qu'un fichier README.md, dans une branche d'un référentiel. Lorsque vous travaillez sur plusieurs fichiers, pensez à [créer un environnement de développement](devenvironment-create.md).

**Pour créer un environnement de développement à partir d'un référentiel source**

1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Dans le volet de navigation, choisissez **Code**, puis sélectionnez **Référentiels sources**.

1. Choisissez le référentiel source dans lequel vous souhaitez travailler sur le code.

1. Choisissez **Create Dev Environment**.

1. Choisissez un IDE compatible dans le menu déroulant. Pour plus d’informations, consultez [Environnements de développement intégrés pris en charge pour les environnements de développement](devenvironment-create.md#devenvironment-supported-ide).

1. Effectuez l’une des actions suivantes :
   + Choisissez **Travailler dans une branche existante**, puis choisissez une branche dans le menu déroulant **Branche existante**.
   + Choisissez **Travailler dans une nouvelle branche**, entrez un nom de branche dans le champ **Nom** de la branche et choisissez une branche à partir de laquelle créer la nouvelle branche dans le menu déroulant **Créer une branche depuis**.

1. Ajoutez éventuellement un nom pour l'environnement de développement ou modifiez sa configuration.

1. Choisissez **Créer**.

**Pour créer un fichier dans la CodeCatalyst console**

1. Accédez au projet dans lequel vous souhaitez créer un fichier. Pour plus d'informations sur la manière d'accéder à un référentiel, consultez[Affichage d’un référentiel source](source-repositories-view.md). 

1. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, puis **Référentiels sources**.

   Choisissez le référentiel dans lequel vous souhaitez créer le fichier. 

1. (Facultatif) Choisissez la branche dans laquelle vous souhaitez créer le fichier, si vous souhaitez créer le fichier dans une branche différente de la branche par défaut.

1. Choisissez **Créer un fichier**. 

1. Entrez le nom du fichier dans **Nom du fichier**. Ajoutez le contenu du fichier dans l'éditeur. 
**Astuce**  
Si vous souhaitez créer le fichier dans un sous-dossier ou un sous-répertoire à la racine de la branche, incluez cette structure dans le nom du fichier.

   Lorsque vous êtes satisfait de vos modifications, choisissez **Commit**.

1. Dans **Nom du fichier**, vérifiez le nom du fichier et apportez-y les modifications souhaitées. Choisissez éventuellement la branche dans laquelle vous souhaitez créer le fichier dans la liste des branches disponibles dans **Branch**. Dans le **message de validation**, entrez éventuellement une description brève mais informative de la raison pour laquelle vous avez effectué cette modification. Cela sera affiché sous forme d'informations de validation de base pour le commit qui ajoute le fichier au référentiel source.

1. Choisissez **Commit** pour valider et transférer le fichier vers le référentiel source.

Vous pouvez également ajouter des fichiers à un référentiel source en le clonant sur votre ordinateur local et en utilisant un client Git ou un environnement de développement intégré (IDE) connecté pour transférer vos fichiers et modifications. 

**Note**  
Si vous souhaitez ajouter un sous-module Git, vous devez utiliser un client Git ou un environnement de développement et exécuter la **git submodule add** commande. Vous ne pouvez pas ajouter ou afficher des sous-modules Git dans la CodeCatalyst console, ni visualiser les différences entre les sous-modules Git dans les pull requests. Pour plus d'informations sur les sous-modules Git, consultez la [documentation Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).<a name="source-files-add-git"></a>

**Pour ajouter un fichier à l'aide d'un client Git ou d'un environnement de développement intégré (IDE) connecté**

1. Clonez votre dépôt source sur votre ordinateur local. Pour de plus amples informations, veuillez consulter [Clonage d’un référentiel source](source-repositories-clone.md).

1. Créez des fichiers dans votre dépôt local ou copiez-les dans votre dépôt local.

1. Créez et envoyez un commit en effectuant l'une des opérations suivantes :
   + Si vous utilisez un client Git, sur le terminal ou sur la ligne de commande, exécutez la **git add** commande en spécifiant les noms des fichiers que vous souhaitez ajouter. Sinon, pour ajouter tous les fichiers ajoutés ou modifiés, exécutez la **git add** commande suivie d'un point simple ou double pour indiquer si vous souhaitez inclure toutes les modifications au niveau du répertoire actuel (point unique) ou toutes les modifications dans le répertoire actuel et tous les sous-répertoires (point double). Pour valider les modifications, exécutez la **git commit -m** commande et fournissez un message de validation. Pour transférer vos modifications dans le référentiel source CodeCatalyst, exécutez**git push**. Pour plus d'informations sur les commandes Git, consultez votre documentation Git et[Commandes Git pour les branches](source-branches-git.md).
   + Si vous utilisez un environnement de développement ou un IDE, créez des fichiers et ajoutez-y des fichiers, puis validez et appliquez vos modifications. Pour plus d'informations, consultez [Écrivez et modifiez du code avec les environnements de développement dans CodeCatalystÉcrire et modifier du code avec les environnements de développement](devenvironment.md) ou consultez la documentation de votre IDE.

# Affichage d'un fichier
<a name="source-files-view"></a>

Vous pouvez consulter les fichiers de votre référentiel source dans la CodeCatalyst console Amazon. Vous pouvez consulter les fichiers dans la branche par défaut et dans toutes les autres branches. Le contenu du fichier peut varier en fonction de la branche que vous choisissez d'afficher.

**Pour afficher des fichiers dans la CodeCatalyst console**

1. Accédez au projet dans lequel vous souhaitez afficher les fichiers. Pour de plus amples informations, veuillez consulter [Affichage d’un référentiel source](source-repositories-view.md). 

1. 

   Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, puis **Référentiels sources**.

   Choisissez le référentiel dans lequel vous souhaitez afficher les fichiers.

1. Une liste de fichiers et de dossiers s'affiche pour la branche par défaut. Les fichiers sont indiqués par une icône en forme de papier, tandis que les dossiers sont indiqués par une icône de dossier. 

1. Effectuez l’une des actions suivantes :
   + Pour afficher les fichiers et les dossiers d'une autre branche, sélectionnez-la dans la liste des branches. 
   + Pour développer un dossier, sélectionnez-le dans la liste.

1. Pour afficher le contenu d'un fichier spécifique, sélectionnez-le dans la liste. Le contenu du fichier sera affiché dans la branche. Pour afficher le contenu du fichier dans une autre branche, choisissez la branche souhaitée dans le sélecteur de branche.
**Astuce**  
Lorsque vous consultez le contenu d'un fichier, vous pouvez sélectionner des fichiers supplémentaires à afficher dans **Afficher les fichiers**. Pour modifier un fichier, choisissez **Modifier**.

Vous pouvez afficher plusieurs fichiers dans la console. Vous pouvez également afficher les fichiers que vous avez clonés sur votre ordinateur local à l'aide d'un client Git ou d'un environnement de développement intégré (IDE). Pour plus d'informations, consultez la documentation de votre client Git ou de votre IDE.

**Note**  
Vous ne pouvez pas afficher les sous-modules Git dans la CodeCatalyst console. Pour plus d'informations sur les sous-modules Git, consultez la [documentation Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).

# Afficher l'historique des modifications apportées à un fichier
<a name="source-files-view-history"></a>

Vous pouvez consulter l'historique des modifications apportées à un fichier dans votre référentiel source dans la CodeCatalyst console Amazon. Cela peut vous aider à comprendre les modifications apportées au fichier par les différents validations effectuées sur la branche où vous choisissez de consulter l'historique du fichier. Par exemple, si vous consultez l'historique des modifications apportées au **readme.md** fichier dans la **main** branche du référentiel source, vous verrez une liste des validations incluant les modifications apportées à ce fichier dans cette branche. 

**Note**  
Vous ne pouvez pas consulter l'historique d'un fichier dans un référentiel lié dans la CodeCatalyst console.<a name="source-files-view-file-history-console"></a>

# Pour consulter l'historique d'un fichier dans la CodeCatalyst console
<a name="source-files-view-file-history-console"></a>

1. Accédez au projet dans lequel vous souhaitez consulter l'historique d'un fichier. Pour de plus amples informations, veuillez consulter [Affichage d’un référentiel source](source-repositories-view.md). 

1. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, puis **Référentiels sources**.

1. Choisissez le référentiel dans lequel vous souhaitez consulter l'historique d'un fichier. Choisissez la branche dans laquelle vous souhaitez afficher l'historique du fichier, puis sélectionnez le fichier dans la liste. Choisissez **Afficher l’historique**. 

1. Consultez la liste des validations qui ont inclus des modifications apportées à ce fichier dans la branche spécifiée. Pour afficher le détail des modifications incluses dans un commit particulier, choisissez le message de validation correspondant à ce commit dans la liste. Les différences entre ce commit et son commit parent sont affichées.

1. Pour consulter l'historique des modifications apportées au fichier dans une autre branche, utilisez le sélecteur de branche pour modifier les vues de cette branche, sélectionnez le fichier dans la liste des fichiers, puis choisissez **Afficher l'historique**.

**Note**  
Vous ne pouvez pas consulter l'historique des modifications apportées aux sous-modules Git dans la CodeCatalyst console. Pour plus d'informations sur les sous-modules Git, consultez la [documentation Git](https://git-scm.com/book/en/v2/Git-Tools-Submodules).

# Modification d'un fichier
<a name="source-files-edit"></a>

Vous pouvez modifier des fichiers individuels dans la CodeCatalyst console Amazon. Pour modifier plusieurs fichiers à la fois, créez un environnement de développement ou clonez le référentiel et apportez vos modifications à l'aide d'un client Git ou d'un environnement de développement intégré (IDE). Pour plus d’informations, consultez [Écrivez et modifiez du code avec les environnements de développement dans CodeCatalystÉcrire et modifier du code avec les environnements de développement](devenvironment.md) ou [Clonage d’un référentiel source](source-repositories-clone.md).

**Pour modifier un fichier dans la CodeCatalyst console**

1. Accédez au projet dans lequel vous souhaitez modifier un fichier. Pour plus d'informations sur la manière d'accéder à un référentiel, consultez[Affichage d’un référentiel source](source-repositories-view.md). 

1. Choisissez le référentiel dans lequel vous souhaitez modifier le fichier. Choisissez **Afficher les branches**, puis choisissez la branche dans laquelle vous souhaitez travailler. Choisissez le fichier dans la liste des fichiers et dossiers de cette branche. 

   Le contenu du fichier s'affiche.

1. Choisissez **Modifier**.

1. Dans l'éditeur, modifiez le contenu du fichier, puis choisissez **Commit**. Facultativement, dans la **section Valider les modifications**, ajoutez des informations supplémentaires sur la modification dans le **message de validation**. Lorsque vous êtes satisfait de vos modifications, choisissez **Commit**.

# Modification du nom ou suppression d'un fichier
<a name="source-files-delete"></a>

Vous pouvez renommer ou supprimer des fichiers dans un environnement de développement, localement sur votre ordinateur ou dans un environnement de développement intégré (IDE). Une fois que vous avez renommé ou supprimé les fichiers, validez et transférez ces modifications dans le référentiel source. Vous ne pouvez pas renommer ou supprimer des fichiers dans la CodeCatalyst console Amazon. 