À 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 votre instance GitHub Enterprise Server, 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 référentiel stocké sur GitHub Enterprise Server et non 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 la branche clonée ou dupliquée 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 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 ».
Chaque personne et organisation peut posséder des référentiels illimités et inviter un nombre illimité de collaborateurs à tous les référentiels.
À 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, vous pouvez également choisir de rendre le dépôt interne.
- Si votre instance GitHub Enterprise Server n’est pas en mode privé ou derrière un pare-feu, les dépôts publics sont accessibles à tout le monde sur Internet. Dans le cas contraire, les dépôts publics sont accessibles à tous les utilisateurs utilisant votre instance GitHub Enterprise Server, y compris les collaborateurs externes.
- 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 ».
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
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, même avec le mode privé désactivé. Pour plus d’informations sur innersource, consultez le livre blanc de GitHub « Introduction à innersource ».
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 , qui ne sont pas membres d’une organisation, 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 ».
Remarque : un utilisateur doit faire partie d’une organisation pour être membre de l’entreprise et avoir accès aux référentiels internes. Si un utilisateur sur votre instance GitHub Enterprise Server n’est membre d’aucune organisation, il n’aura pas accès aux dépôts internes.
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.