Ce guide vous explique comment mettre en place, configurer et gérer votre instance GitHub Enterprise Server en tant qu’administrateur d’entreprise.
GitHub fournit deux façons de déployer GitHub Enterprise.
- GitHub Enterprise Cloud
- GitHub Enterprise Server
GitHub héberge GitHub Enterprise Cloud. Vous pouvez déployer et héberger GitHub Enterprise Server dans votre propre centre de données ou un fournisseur de cloud pris en charge.
Pour plus d’informations sur GitHub Enterprise Server, consultez À propos de GitHub Enterprise Server.
Partie 1 : Installation GitHub Enterprise Server
Pour commencer, vous devez créer votre compte d’entreprise, installer l’instance, utiliser la Console de gestion configuration initiale, configurer votre instance et gérer la facturation.
1. Créer votre compte d’entreprise
Avant d’installerGitHub Enterprise Server, vous pouvez créer un compte d’entreprise en GitHub.com contactant GitHubl’équipe ventes. Un compte d’entreprise sur GitHub.com est utile pour la facturation et pour les fonctionnalités partagées avec GitHub.com via GitHub Connect. Pour plus d’informations, consultez « Comptes d’entreprise ».
2. Installer GitHub Enterprise Server
Pour commencer, vous devez installer l'appliance sur la plate-forme de virtualisation de votre choix. Pour plus d’informations, consultez « Configuration d’une instance GitHub Enterprise Server ».
3. Utilisation de Console de gestion
Vous utiliserez Console de gestion pour suivre la procédure de configuration initiale lors du premier lancement de votre instance GitHub Enterprise Server. Vous pouvez également utiliser l’option Console de gestion pour gérer les paramètres d’instance tels que la licence, le domaine, l’authentification et TLS. Pour plus d’informations, consultez « Géstion de votre instance à partir de l’IU WEB. ».
4. Configuration de votre instance GitHub Enterprise Server
En plus du Console de gestion, vous pouvez utiliser le tableau de bord d’administration du site et le shell d’administration (SSH) pour gérer votre instance GitHub Enterprise Server. Par exemple, vous pouvez configurer des applications et des limites de débit, afficher des rapports et utiliser des utilitaires en ligne de commande. Pour plus d’informations, consultez « Configuration de GitHub Entreprise ».
Vous pouvez utiliser les paramètres réseau par défaut utilisés par GitHub Enterprise Server le biais du protocole DHCP (Dynamic Host Configuration Protocol) ou configurer les paramètres réseau à l’aide de la console de machine virtuelle. Vous pouvez aussi configurer un serveur proxy ou des règles de pare-feu. Pour plus d’informations, consultez « Configuration des paramètres réseau ».
5. Configurer la haute disponibilité
Vous pouvez configurer votre instance GitHub Enterprise Server la haute disponibilité pour réduire l’impact des défaillances matérielles et des pannes réseau. Pour plus d’informations, consultez « Configuration de la haute disponibilité ».
6. Configurer une instance de préproduction
Vous pouvez configurer une instance intermédiaire pour tester les modifications, planifier la récupération d’urgence et tester les mises à jour avant de les appliquer.votre instance GitHub Enterprise Server Pour plus d’informations, consultez « Configuration d’une instance de préproduction ».
7. Définir les sauvegardes et la reprise d’activité après sinistre
Pour protéger vos données de production, vous pouvez configurer des sauvegardes automatisées avec votre instance GitHub Enterprise ServerGitHub Enterprise Server Backup Utilities. Pour plus d’informations, consultez « Configurer les sauvegardes sur votre instance à l’aide des Utilitaires de sauvegarde ».
8. Gérer la facturation pour votre entreprise
La facturation de toutes les organisations et GitHub Enterprise Server instances connectées à votre compte d’entreprise est agrégée en une seule facture pour tous vos services payants GitHub.com . Les propriétaires d’entreprise et les gestionnaires de facturation peuvent voir et gérer les paramètres de facturation définis pour les comptes d’entreprise. Pour plus d’informations, consultez « Facturation pour GitHub Entreprise ».
Partie 2 : Organisation et gestion de votre équipe
En tant que propriétaire ou administrateur d’entreprise, vous pouvez gérer les paramètres aux niveaux utilisateur, dépôt, équipe et organisation. Vous pouvez gérer les membres de votre entreprise, créer et gérer des organisations, définir des stratégies pour la gestion des dépôts ainsi que créer et gérer des équipes.
1. Gestion des membres de votre instance GitHub Enterprise Server
Vous pouvez gérer les paramètres et l’activité d’audit pour les membres de votre instance GitHub Enterprise Server. Vous pouvez promouvoir un membre d’entreprise au rang d’administrateur de site, gérer des utilisateurs dormants, afficher le journal d’audit pour l’activité utilisateur et personnaliser les messages que les membres de l’entreprise verront. Pour plus d’informations, consultez « Gestion des utilisateurs dans votre entreprise ».
2. Créer des organisations
Vous pouvez créer des organisations dans votre instance GitHub Enterprise Server pour refléter la structure de votre entreprise ou groupe. Pour plus d’informations, consultez « Création d’une organisation à partir de zéro ».
3. Ajouter des membres à des organisations
Vous pouvez ajouter des membres à des organisations dans votre instance GitHub Enterprise Server tant que vous êtes propriétaire d’une organisation dans les organisations que vous souhaitez gérer. Vous pouvez également configurer la visibilité de l’appartenance à une organisation. Pour plus d’informations, consultez « Ajout de personnes à votre organisation » et « Configuration de la visibilité de l’appartenance à une organisation ».
4. Créer des équipes
Les équipes sont des groupes de membres d’une organisation qui peuvent recevoir des autorisations d’accès à des dépôts spécifiques en tant que groupe. Vous pouvez créer des équipes individuelles ou plusieurs niveaux d’équipes imbriquées dans chacune de vos organisations. Pour plus d’informations, consultez « Créer une équipe d’organisation » et « Ajout de membres d’une organisation à une équipe ».
5. Définir des niveaux d’autorisation pour les organisations et les dépôts
Nous vous recommandons de donner à un nombre limité de membres dans chaque organisation un rôle de propriétaire d’organisation, qui fournit un accès administratif complet pour cette organisation. Pour plus d’informations, consultez « Rôles dans une organisation ».
Pour les organisations où vous disposez d’autorisations d’administrateur, vous pouvez également personnaliser l’accès à chaque dépôt avec des niveaux d’autorisation précis. Pour plus d’informations, consultez « Rôles de dépôt pour une organisation ».
6. Appliquer des stratégies de gestion des dépôts
En tant que propriétaire d’entreprise, vous pouvez définir des stratégies de gestion de référentiel pour toutes les organisations dans votre instance GitHub Enterprise Server ou autoriser la définition séparée de stratégies dans chaque organisation. Pour plus d’informations, consultez « Application de stratégies de gestion des dépôts dans votre entreprise ».
7. Création d’un fichier README pour l’entreprise
Pour aider les gens à comprendre la situation de votre entreprise, vous devriez créer un LISEZMOI. Par exemple, vous pouvez utiliser un LISEZMOI pour aider les membres à découvrir différentes organisations de l’entreprise, à partager des liens vers des ressources importantes ou à communiquer des informations sur les paramètres et les stratégies de votre entreprise. Pour plus d’informations, consultez Création d'un README pour une entreprise.
Partie 3 : Construction en toute sécurité
Pour renforcer la sécurité, vous pouvez configurer l’authentification pour les membres d’entreprise votre instance GitHub Enterprise Server, utiliser les outils et la journalisation d’audit pour rester en conformité, configurer des fonctionnalités de sécurité et d’analyse pour vos organisations, et éventuellement activer des GitHub Advanced Security fonctionnalités.
1. Authentifier les membres de l’entreprise
Vous pouvez utiliser GitHub Enterprise Serverla méthode d’authentification intégrée, ou choisir entre un fournisseur d’authentification externe, tel que CAS, LDAP ou SAML, pour intégrer vos comptes existants et gérer de manière centralisée l’accès utilisateur à votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Notions de base de la gestion des identités et des accès ».
Vous pouvez également exiger une authentification à 2 facteurs pour chacune de vos organisations. Pour plus d’informations, consultez « Exiger l’authentification à 2 facteurs pour une organisation ».
2. Maintenir la conformité
Vous pouvez implémenter les vérifications d’état requises et commiter ces vérifications afin de respecter les normes de conformité de votre organisation et d’automatiser les workflows de conformité. Vous pouvez également utiliser le journal d’audit de votre organisation pour examiner les actions effectuées par votre équipe. Pour plus d’informations, consultez « Application d’une stratégie avec des hooks de pré-réception » et « Journal d’audit pour une entreprise ».
3. Configurer les fonctionnalités de sécurité pour vos organisations
Pour sécuriser les organisations de votre instance GitHub Enterprise Server , vous pouvez utiliser diverses fonctionnalités de sécurité, notamment les stratégies de GitHub sécurité, les graphiques de dépendances, l’analyse des secrets et les mises à jour de la sécurité et des versions de Dependabot. Pour plus d’informations, consultez Configuration des fonctionnalités de sécurité dans votre organisation.
4. Activation des GitHub Advanced Security fonctionnalités
Vous pouvez mettre à niveau votre GitHub Enterprise Server licence pour inclure GitHub Code Security ou GitHub Secret Protection. La mise à niveau fournira des fonctionnalités supplémentaires qui aideront les utilisateurs à trouver et à corriger les problèmes de sécurité dans leur code, comme l’analyse du code et des secrets. Pour plus d’informations, consultez « Activer les produits GitHub Advanced Security pour votre entreprise ».
Partie 4 : Personnalisation et automatisation du travail de votre entreprise GitHub
Vous pouvez personnaliser et automatiser le travail au sein des organisations de votre entreprise avec GitHub et OAuth apps, l’API GitHub Enterprise Server, GitHub Actions, GitHub Packages et GitHub Pages.
1. Construction GitHub Apps et OAuth apps
Vous pouvez créer des intégrations avec l’APIGitHub Enterprise Server, par GitHub AppsOAuth apps exemple, pour une utilisation dans les organisations de votre entreprise afin de compléter et d’étendre vos flux de travail. Pour plus d’informations, consultez « À propos de la création d’applications GitHub ».
2. Utilisation de l’API GitHub Enterprise Server
Il existe deux versions stables de l’API GitHub : l’API REST et l’API GraphQL. Vous pouvez utiliser les API de GitHub pour automatiser des tâches courantes, sauvegarder vos données, ou , créer des intégrations qui étendent les fonctionnalités de GitHub. Pour plus d’informations, consultez « Comparaison de l'API REST de GitHub et de l'API GraphQL ».
3. Bâtiment GitHub Actions
Avec GitHub Actions, vous pouvez automatiser et personnaliser le flux de travail de développement de votre entreprise sur GitHub. Vous pouvez créer vos propres actions, utiliser et personnaliser des actions partagées par la communauté GitHub. Pour plus d’informations, consultez « Écriture de workflows ».
Pour plus d’informations sur l’activation et la configuration GitHub Actions sur GitHub Enterprise Server, consultez Prise en main de GitHub Actions pour GitHub Enterprise Server.
4. Publication et gestion GitHub Packages
GitHub Packages est un service d’hébergement de package logiciel qui vous permet d’héberger vos packages logiciels en privé ou publiquement, ainsi que d’utiliser des packages en tant que dépendances dans vos projets. Pour plus d’informations, consultez « Introduction aux packages GitHub ».
Pour plus d’informations sur l’activation et la configuration GitHub Packages pour votre instance GitHub Enterprise Server, consultez Prise en main des packages GitHub pour votre entreprise.
5. Utilisation de GitHub Pages
GitHub Pages est un service d’hébergement de site statique qui prend des fichiers HTML, CSS et JavaScript directement à partir d’un dépôt et publie un site web. Vous pouvez activer ou désactiver GitHub Pages pour les membres de votre entreprise au niveau de l’organisation. Pour plus d’informations, consultez « Configuration de pages GitHub pour votre entreprise » et « Qu’est-ce que GitHub Pages ? ».
Partie 5 : Connexion avec d’autres GitHub ressources
Vous pouvez utiliser GitHub Connect pour partager des ressources.
Si vous êtes le propriétaire d’une GitHub Enterprise Server instance et d’un compte d’entreprise ou d’une GitHub Enterprise Cloud organisation, vous pouvez activer GitHub Connect. GitHub Connect vous permet de partager des flux de travail et des fonctionnalités spécifiques entre votre instance GitHub Enterprise Server et GitHub Enterprise Cloud, par exemple, la recherche unifiée et les contributions. Pour plus d’informations, consultez « Activation de GitHub Connect pour GitHub.com ».
Partie 6 : Utilisation des ressources d’apprentissage et d’assistance de GitHub
Vos membres d’entreprise peuvent en savoir plus sur Git et GitHub avec nos ressources d’apprentissage, et vous pouvez obtenir le support dont vous avez besoin lors de la configuration et de la gestion votre instance GitHub Enterprise Server avec GitHub le support d’entreprise.
1. Lecture de GitHub Enterprise Server sur GitHub Docs
Vous pouvez lire la documentation qui reflète les fonctionnalités disponibles avec GitHub Enterprise Server. Pour plus d’informations, consultez « À propos des versions de GitHub Docs ».
Pour savoir comment votre entreprise peut utiliser GitHub le plus efficacement possible, consultez Meilleures pratiques pour organiser le travail dans votre entreprise.
2. Apprentissage avec GitHub Skills
Les membres de votre entreprise peuvent acquérir de nouvelles compétences en menant à bien des projets amusants et réalistes dans leur propre dépôt GitHub avec GitHub Skills. Chaque cours consiste en une leçon pratique créée par la communauté GitHub et enseignée par un bot convivial.
Pour plus d’informations, consultez « Ressources d’apprentissage Git et GitHub ».
3. Utilisation du GitHub support d’entreprise
GitHub Enterprise inclut l’accès à Support GitHub Enterprise. Support GitHub Enterprise peut vous aider à résoudre les problèmes. Vous pouvez également choisir de souscrire au Support Premium de GitHub pour bénéficier de fonctionnalités supplémentaires. Pour plus d’informations, consultez À propos du support GitHub.