À propos des dépôts
Un référentiel est l’élément le plus simple de GitHub. Il s’agit d’un endroit où vous pouvez stocker votre code, vos fichiers et l’historique de révision de chaque fichier. Les référentiels peuvent avoir plusieurs collaborateurs, et peuvent être publics, internes ou privés.
Pour créer un référentiel, allez sur https://github.com/new. Pour les instructions, consultez Guide de démarrage rapide pour les dépôts.
Terminologie du référentiel
Avant de démarrer avec les référentiels, découvrez ces termes importants.
| Terme | Définition |
|---|---|
| Branche | Une version parallèle de votre code contenue dans le référentiel, mais qui n’affecte pas la branche primaire ou principale. |
| Cloner | Pour télécharger une copie complète des données d’un référentiel à partir de GitHub.com, y compris toutes les versions de chaque fichier et dossier. |
| Duplication (fork) | Un nouveau référentiel qui partage le code et les paramètres de visibilité avec le référentiel « en amont » d’origine. |
| Fusionner (Merge) | Pour récupérer les modifications d’une branche et les appliquer à une autre. |
| Demande de tirage (pull request) | Une demande de fusion des modifications d’une branche vers une autre. |
| Remote | Un dépôt stocké sur GitHub, pas sur votre ordinateur. |
| En amont | La branche sur un référentiel d’origine qui a été dupliquée ou clonée. La branche correspondante sur le dépôt cloné ou forké est appelée « en aval ». |
À propos de la propriété du référentiel
Vous pouvez posséder des référentiels individuellement ou partager la propriété des référentiels avec d’autres personnes d’une organisation.
Dans les deux cas, l’accès aux référentiels est géré par des autorisations. Pour plus d’informations, consultez « Niveaux d’autorisation pour un référentiel de compte personnel » et « Rôles de dépôt pour une organisation ».
Présentation la collaboration
Vous pouvez utiliser des référentiels pour gérer votre travail et collaborer avec d’autres personnes.
- Vous pouvez utiliser des problèmes pour collecter des commentaires d’utilisateurs, signaler des bogues logiciels et organiser les tâches que vous souhaitez accomplir. Pour plus d’informations, consultez À propos des problèmes.
- Vous pouvez utiliser GitHub Discussions pour poser des questions et y répondre, partager des informations, faire des annonces et participer à des conversations sur un projet. Pour plus d’informations, consultez « À propos des discussions ».
- Vous pouvez utiliser des demandes de tirage pour proposer des modifications d’un référentiel. Pour plus d’informations, consultez « À propos des demandes de tirage (pull requests) ».
- Vous pouvez utiliser Projects pour organiser et classer par ordre de priorité vos problèmes et demandes de tirage (pull request). Pour plus d’informations, consultez « À propos des Projects ».
Avec GitHub Free pour les comptes personnels et les organisations, vous pouvez travailler avec un nombre illimité de collaborateurs sur un nombre illimité de dépôts publics avec un ensemble complet de fonctionnalités ou sur un nombre illimité de dépôts privés avec un ensemble limité de fonctionnalités. Pour obtenir des outils avancés pour les dépôts privés, vous pouvez effectuer une mise à niveau vers GitHub Pro, GitHub Team ou GitHub Enterprise Cloud. Pour plus d’informations, consultez Plans de GitHub.
À propos de la visibilité du référentiel
Vous pouvez restreindre les utilisateurs ayant accès à un dépôt en choisissant la visibilité d’un dépôt : public, interne ou privé.
Lorsque vous créez un dépôt, vous pouvez choisir de le rendre public ou privé. Si vous créez le dépôt dans une organisation appartenant à un compte d’entreprise, vous pouvez également choisir de rendre le dépôt interne.
- Si votre compte n'est pas un compte d’utilisateur managé, vous pouvez créer des référentiels publics. Les référentiels publics sont accessibles à tous sur Internet.
- Les dépôts privés ne sont accessibles que par vous, les personnes avec lesquelles vous partagez explicitement l’accès et, pour les référentiels d’organisation, certains membres de l’organisation.
- Les référentiels internes sont accessibles à tous les membres de l’entreprise. Pour plus d’informations, consultez À propos des référentiels internes.
Considérations relatives à la sécurité pour la visibilité du référentiel
Les référentiels publics exposent votre codebase à tous, ce qui augmente le risque que des attaquants exploitent des vulnérabilités ou accèdent à des informations sensibles. Vous pouvez atténuer ces risques en activant les fonctionnalités de sécurité GitHub telles que Dependabot, secret scanning, la protection d’envoi (push) et code scanning pour le référentiel. De plus, vous devez ajouter une stratégie de sécurité (un fichier SECURITY.md) à votre référentiel, qui décrit comment les vulnérabilités doivent être signalées, afin de garantir que les menaces potentielles sont traitées efficacement.
Bien que les référentiels privés limitent l’accès aux utilisateurs autorisés, il est toujours essentiel d’implémenter des contrôles d’accès renforcés, une authentification multifacteur et des audits réguliers pour atténuer les risques.
Pour plus d’informations, consultez « Démarrage rapide pour la sécurisation de votre dépôt ».
Les propriétaires d’organisation ont toujours accès à chaque référentiel créé dans une organisation. Pour plus d’informations, consultez « Rôles de dépôt pour une organisation ».
Les personnes disposant d’autorisations d’administrateur pour un référentiel peuvent modifier la visibilité d’un référentiel existant. Pour plus d’informations, consultez « Définition de la visibilité du dépôt ».
À propos des dépôts internes
Si votre organisation appartient à un compte d’entreprise, vous pouvez utiliser des dépôts internes pour pratiquer l’« innersource » dans votre entreprise. Les membres de votre entreprise peuvent collaborer avec des méthodologies open source sans partager publiquement les informations propriétaires. Pour plus d’informations sur innersource, consultez le livre blanc de GitHub Introduction à innersource.
Note
Vous ne pouvez créer des référentiels internes que si vous utilisez GitHub Enterprise Cloud avec un compte d’entreprise. Un compte d’entreprise est un type de compte distinct qui autorise un point central de gestion pour plusieurs organisations. Pour plus d’informations, consultez « Types de comptes GitHub ».
Tous les membres de l’entreprise disposent d’autorisations de lecture sur le référentiel interne, mais les référentiels internes ne sont pas visibles par les personnes en dehors de l’entreprise, y compris les collaborateurs hors des référentiels d’organisation. Pour plus d’informations, consultez « Rôles dans une entreprise » et « Rôles de dépôt pour une organisation ».
Les dépôts internes sont le paramètre par défaut pour tous les nouveaux dépôts créés dans une organisation appartenant à un compte d’entreprise.
Par défaut, les membres de l'entreprise peuvent créer un référentiel interne dans toute organisation où l'utilisateur peut créer des référentiels. Les propriétaires d’organisations peuvent également autoriser les utilisateurs à créer un fork appartenant à un compte d’utilisateur et à gérer la stratégie de duplication pour une organisation. Les propriétaires d’entreprise peuvent gérer la stratégie de duplication pour certaines ou toutes les organisations au sein d’une entreprise. Pour plus d’informations, consultez « Gestion de la stratégie de duplication pour votre organisation » et « Application de stratégies de gestion des dépôts dans votre entreprise ».
Étapes suivantes
Voici quelques ressources utiles pour aller plus loin avec les référentiels.
- Meilleures pratiques pour les référentiels : découvrez comment utiliser les référentiels le plus efficacement possible.
- Création d’un dépôt : créez un référentiel.
- Création et suppression de branches dans votre référentiel : découvrez comment créer et supprimer des branches dans votre référentiel.
- Création d’une demande de tirage : créez une demande de tirage (pull request) pour proposer et collaborer sur des modifications apportées à un référentiel.