Ajout d’un fichier à un référentiel

Vous pouvez charger et commiter un fichier existant dans un dépôt sur GitHub ou en utilisant la ligne de commande.

Platform navigation

Dans cet article

Ajout d’un fichier à un dépôt sur GitHub

Les fichiers que vous ajoutez à un référentiel via un navigateur sont limités à 25 Mio par fichier. Vous pouvez ajouter des fichiers plus volumineux, jusqu’à 100 Mio chacun, via la ligne de commande. Pour plus d’informations, consultez Ajout d’un fichier à un dépôt en utilisant la ligne de commande. Pour ajouter des fichiers supérieurs à 100 Mio, vous devez utiliser Stockage des fichiers volumineux Git. Pour plus d’informations, consultez « À propos des fichiers volumineux sur GitHub ».

Vous pouvez charger jusqu’à 100 fichiers vers GitHub en même temps.

Si un référentiel possède des branches protégées, vous ne pouvez pas modifier ou charger des fichiers dans la branche protégée à l’aide de GitHub. Vous pouvez utiliser GitHub Desktop pour déplacer vos modifications vers une nouvelle branche et les valider. Pour plus d’informations, consultez « À propos des branches protégées » et « Enregistrement et révision des changements dans votre projet sur GitHub Desktop ».

Il est possible que votre référentiel ait des règles de poussée activées. Les ensembles de règles de poussée peuvent bloquer la création d'un nouveau fichier dans le référentiel sur la base de certaines restrictions. Les règles de poussée s'appliquent à l'ensemble du réseau de fourches du référentiel. Cela signifie que toutes les règles de poussée configurées dans le référentiel racine s'appliqueront également à toutes les fourches du référentiel. Pour plus d’informations, consultez « À propos des ensembles de règles ».

Votre dépôt peut être sécurisé par la protection push. Avec la protection push, GitHub bloquera le chargement d’un fichier vers le dépôt si ce fichier contient un secret pris en charge, tel qu’un jeton. Vous devez supprimer le secret du fichier avant de tenter de charger à nouveau le fichier. Pour plus d’informations, consultez « Utilisation de la protection push dans l’interface utilisateur GitHub » et « Utilisation de la protection push dans l’interface utilisateur GitHub ».

Remarque

La protection Push pour les chargements de fichiers dans l’interface utilisateur web est actuellement en préversion publique et peut être amenée à changer.

Avertissement

Utilisez Git pour envoyer (push) des fichiers vers votre dépôt si vous devez appliquer la logique dans votre fichier .gitattributes. Par exemple, la conversion automatique des fins de ligne. Le chargement d’un fichier via l’interface web GitHub ignorera .gitattributes.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Au-dessus de la liste des fichiers, sélectionnez le menu déroulant Ajouter un fichier, puis cliquez sur Charger des fichiers. Vous pouvez également glisser-déposer des fichiers dans votre navigateur.

    Capture d’écran de la page principale du référentiel. Au-dessus de la liste des fichiers, un bouton, intitulé « Ajouter un fichier », est indiqué en orange foncé.

  3. Pour sélectionner les fichiers que vous souhaitez charger, faites glisser et déposez le fichier ou le dossier, ou cliquez sur choisissez vos fichiers.

  4. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d'un commit avec plusieurs auteurs ».

  5. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une pull request ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.

  6. Cliquez sur Proposer des modifications.

Ajout d’un fichier à un référentiel à l’aide de la ligne de commande

Vous pouvez charger et commiter un fichier existant dans un dépôt sur GitHub en utilisant la ligne de commande.

Conseil

Vous pouvez également ajouter un fichier existant à un dépôt à partir du site web GitHub.

Cette procédure suppose que vous avez déjà :

Avertissement

Ne jamais envoyer d'informations sensibles git add,commit oupush, par exemple des mots de passe ou des clés d'API, à un référentiel distant. Si vous avez déjà ajouté ces informations, consultez Suppression de données sensibles dans un dépôt.

  1. Sur votre ordinateur, déplacez le fichier que vous souhaitez charger vers GitHub dans le répertoire local créé lorsque vous avez cloné le dépôt.

  2. Ouvrez TerminalTerminalGit Bash.

  3. Remplacez le répertoire de travail actuel par votre dépôt local.

  4. Indexez le fichier pour commit dans votre dépôt local.

    $ git add .
# Adds the file to your local repository and stages it for commit. Pour désindexer un fichier, utilisez « git reset HEAD VOTRE-FICHIER ».

  5. Validez le fichier dont vous avez placé une copie intermédiaire dans votre dépôt local.

    $ git commit -m "Add existing file"
# Commits the tracked changes and prepares them to be pushed to a remote repository. Pour supprimer ce commit et modifier le fichier, utilisez « git reset --soft HEAD~1 », puis commitez et rajoutez le fichier.

  6. Poussez les modifications de votre référentiel local vers GitHub.com.

    $ git push origin YOUR_BRANCH
# Pushes the changes in your local repository up to the remote repository you specified as the origin

Pour aller plus loin