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 chaque 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 de plus de 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 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 bloque le chargement d’un fichier dans 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 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 GitHub web ignore .gitattributes.
-
Sur GitHub, accédez à la page principale du référentiel.
-
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.
-
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.
-
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 ».
-
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 ».
-
Cliquez sur Proposer des modifications.
Ajout d’un fichier à un référentiel à l’aide de la ligne de commande
Vous pouvez téléverser un fichier existant vers un dépôt sur GitHub à l’aide de la ligne de commande.
Conseil
Vous pouvez également ajouter un fichier existant à un dépôt à partir du GitHub site web.
Cette procédure suppose que vous avez déjà :
- Avoir créé un référentiel sur GitHub, ou avoir un référentiel existant appartenant à un autre utilisateur auquel vous souhaitez contribuer
- Cloné le référentiel localement sur votre ordinateur
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.
-
Sur votre ordinateur, déplacez le fichier vers lequel vous souhaitez effectuer le chargement GitHub dans le répertoire local créé lorsque vous avez cloné le référentiel.
-
Ouvrez TerminalTerminalGit Bash.
-
Remplacez le répertoire de travail actuel par votre dépôt local.
-
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 ». -
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. -
Poussez les modifications de votre référentiel local vers votre instance GitHub Enterprise Server.
$ git push origin YOUR_BRANCH # Pushes the changes in your local repository up to the remote repository you specified as the origin