À 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 Créer un référentiel.
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 | Pour récupérer les modifications d’une branche et les appliquer à une autre. |
| Demande de tirage | Une demande de fusion des modifications d’une branche vers une autre. |
| Remote | Un référentiel stocké sur GitHub Enterprise Cloud 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 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 des tableaux de projet pour organiser et hiérarchiser vos problèmes et demandes de tirage. Pour plus d’informations, consultez « À propos des projects (classic) ».
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 référentiel en choisissant la visibilité d’un référentiel : 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 référentiel interne.
- Les dépôts 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 ».
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 ».
Remarque : Vous ne pouvez créer des dépôts 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.
À moins que votre entreprise utilise Enterprise Managed Users, les membres de l’entreprise peuvent dupliquer les dépôts internes appartenant à une organisation de l’entreprise. Le référentiel dupliqué appartiendra au compte personnel du membre et la visibilité de la duplication (fork) sera privée. Si un utilisateur est supprimé de toutes les organisations appartenant à l’entreprise, les duplications des référentiels internes de cet utilisateur sont automatiquement supprimées.
Remarque : Les Comptes d’utilisateur managés ne peuvent pas dupliquer les dépôts internes. Pour plus d’informations, consultez « À propos d’Enterprise Managed Users ».
É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.