Skip to main content

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

Ajout d’un fichier à un référentiel 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 référentiel ». Pour ajouter des fichiers supérieurs à 100 Mio, vous devez utiliser Stockage Fichiers volumineux Git. Pour plus d’informations, consultez « À propos des fichiers volumineux sur GitHub ».

Vous pouvez charger simultanément plusieurs fichiers dans GitHub.

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 « Commit et revue des changements apportés à votre projet dans 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 ».

Note

Les ensembles de règles de poussée sont en version bêta et peuvent être modifiés.

Votre référentiel peut être sécurisé par la protection Push. Avec la protection push, GitHub bloquera le téléchargement d'un fichier vers le référentiel si le fichier contient un secret pris en charge, tel qu'un jeton. Vous devez supprimer le secret du fichier avant de tenter de télé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 ».

Note

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

  1. Dans GitHub.com, accédez à la page principale du dépôt.

  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’une validation 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 demande de tirage ».

    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 un fichier existant dans un dépôt sur GitHub.com en utilisant la ligne de commande.

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

Avertissement : N’appliquez jamais git add, commit ni push sur des informations sensibles, par exemple des mots de passe ou des clés d'API, à un dépôt 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 référentiel.

  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