Création et organisation de référentiels sur GHES
Les dépôts sur GitHub Enterprise Server existent dans une hiérarchie d’entreprise structurée qui reflète la propriété organisationnelle, le contrôle d’accès et les exigences de gouvernance. Bien que le concept de référentiel de base soit identique à GitHub.com, la façon dont les référentiels sont créés et gérés est souvent plus délibéré et contrôlé.
Dans cette unité, vous allez apprendre
Organisation des référentiels au sein des entreprises et des organisations
Comment la gouvernance affecte la création et la propriété du dépôt
Pourquoi la normalisation est courante dans les environnements GHES
Structure d’entreprise et d’organisation
Dans GHES, les référentiels se trouvent à l’intérieur des organisations, qui à leur tour sont régis par un compte d’entreprise. Cette hiérarchie permet aux organisations d’appliquer des stratégies cohérentes sur un grand nombre de référentiels tout en déléguant la gestion quotidienne à des équipes spécifiques.
Les entreprises utilisent généralement des organisations pour représenter des produits, des services ou des unités commerciales. Les autorisations d’accès, les paramètres de visibilité et les stratégies héritées sont appliquées au niveau de l’organisation, ce qui signifie que le comportement du référentiel est souvent mis en forme avant l’écriture d’une seule ligne de code.
Du point de vue du développeur, cette structure signifie que les dépôts sont rarement des espaces « personnels ». Ils sont des ressources partagées détenues par des équipes et régies par des normes à l’échelle de l’entreprise.
Création de référentiels dans des environnements régis
Dans de nombreux déploiements GHES, la création de référentiels n’est pas ouverte à tous les utilisateurs. Les organisations peuvent restreindre la création de référentiels aux propriétaires d’organisations ou à des rôles spécifiques, ce qui garantit que les nouveaux référentiels s’alignent sur les normes internes dès le début.
Lorsque des référentiels sont créés, ils héritent souvent de paramètres prédéfinis tels que les branches par défaut, les règles de protection des branches, la configuration du suivi des problèmes et les hooks d’automatisation. Les conventions d’affectation de noms peuvent être appliquées pour faciliter l’identification et la gestion des référentiels à grande échelle.
Ces contrôles réduisent les incohérences et aident les entreprises à maintenir la visibilité et la conformité entre des centaines ou des milliers de dépôts. Pour les développeurs, cela signifie que la création d’un dépôt est souvent une action coordonnée plutôt qu’un choix individuel. Si vous ne pouvez pas créer un référentiel directement, utilisez le chemin de requête établi de votre organisation plutôt que de créer des solutions de contournement ou dupliquer du code dans des emplacements non gouvernementaux.
Rôles, propriété et cycle de vie du référentiel
Les environnements gérés par l’entreprise séparent souvent les responsabilités. Les développeurs contribuent au code, mais les propriétaires de l’organisation ou les administrateurs de référentiel peuvent contrôler la création, la visibilité et la configuration de stratégie du référentiel. Cela garantit que les référentiels sont créés avec les paramètres de propriété, de modèle d’accès et de base appropriés à partir du premier jour.
La gouvernance des référentiels inclut également des contrôles de cycle de vie. Dans certains cas, les référentiels peuvent être verrouillés pour empêcher d’autres modifications ou restaurés après la suppression accidentelle. Comprendre que les référentiels sont des ressources managées plutôt que des espaces de travail personnels, permet aux équipes de planifier les modifications, de demander l’accès via les canaux appropriés et d’éviter les conflits avec les contrôles d’entreprise.
Modèles de référentiel et normalisation
Pour renforcer la cohérence, de nombreuses organisations s’appuient sur des modèles de référentiel. Les modèles fournissent un point de départ qui inclut la documentation requise, les fichiers de configuration et les flux de travail par défaut. En utilisant des modèles, les équipes évitent les tâches de configuration répétitives et garantissent que chaque référentiel répond aux exigences de base pour la sécurité, la documentation et l’automatisation.
Avant de créer un référentiel sur GHES, les développeurs doivent vérifier si des modèles approuvés existent et suivre les instructions de l’organisation. L’utilisation du modèle approprié est souvent le chemin le plus rapide pour commencer.
Étape par étape : vérifiez que vous êtes dans le référentiel approprié et que vous comprenez ses normes
Si vous rejoignez un projet existant, commencez par vérifier que vous travaillez dans l’organisation et le référentiel appropriés, et identifiez les normes que le référentiel vous attend à suivre.
Dans l’interface utilisateur web GHES, accédez à l’organisation et au référentiel que vous prévoyez d’utiliser.
Vérifiez que le nom et la description du référentiel correspondent au projet sur lequel vous avez l’intention de travailler.
Vérifiez la branche par défaut (généralement principale) et indiquez si le référentiel semble être actif.
Passez en revue les fichiers de normalisation courants s’ils existent :
- README (ce qu'est le dépôt et comment l'exécuter)
- Gestion des contributions (processus de contribution et attentes en matière d'évaluation)
- CODEOWNERS (qui doivent passer en revue les modifications apportées à des chemins spécifiques)
- SÉCURITÉ (processus de création de rapports de sécurité)
Si vous utilisez GitHub CLI, vous pouvez confirmer les détails du référentiel de base à partir de la ligne de commande :
gh repo view ORG/REPO --hostname github.company.com
Si vous ne pouvez pas accéder au référentiel, confirmez l’appartenance de votre organisation et les autorisations de référentiel avant de résoudre les problèmes liés aux paramètres git ou de branche.
Principaux points à prendre : sur GHES, les référentiels sont des ressources régies, de sorte que la compréhension de la structure d’entreprise, la suite de contrôles de création et l’utilisation de modèles approuvés vous aident à commencer à travailler de manière conforme et durable.
Maintenant que vous comprenez où les référentiels sont hébergés et comment ils sont créés dans des environnements régis, vous êtes prêt à examiner la façon dont le travail circule à travers les branches de ces référentiels.