Ce guide vous accompagne tout au long de l’installation, de la configuration et de la gestion de votre instance GitHub Enterprise Server en tant qu’administrateur d’entreprise.
GitHub offre 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 chez un fournisseur de cloud pris en charge.
Pour plus d’informations sur GitHub Enterprise Server, consultez « À propos du serveur GitHub Enterprise ».
Partie 1 : Installation de GitHub Enterprise Server
Pour bien démarrer avec GitHub Enterprise Server, vous devez créer votre compte d’entreprise, installer l’instance, utiliser la Management Console pour la configuration initiale, configurer votre instance et gérer la facturation.
1. Créer votre compte d’entreprise
Avant d’installer GitHub Enterprise Server, vous pouvez créer un compte d’entreprise sur GitHub.com en contactant l’équipe des ventes de GitHub. 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 « À propos des comptes d'entreprise ».
2. Installer GitHub Enterprise Server
Pour bien démarrer avec GitHub Enterprise Server, vous devez installer l’appliance sur une plateforme de virtualisation de votre choix. Pour plus d’informations, consultez « Configuration d’une instance GitHub Enterprise Server ».
3. Utilisation de la Management Console
Vous utilisez la Management Console pour effectuer le processus de configuration initiale au premier lancement de votre instance GitHub Enterprise Server. Vous pouvez également utiliser la Management Console pour gérer les paramètres de l’instance comme 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 de la Management Console, 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 Enterprise ».
Vous pouvez conserver les paramètres réseau par défaut utilisés par GitHub Enterprise Server via le protocole DHCP (Dynamic Host Configuration Protocol) ou bien configurer les paramètres réseau dans 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 la haute disponibilité pour votre instance GitHub Enterprise Server afin de 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 de préproduction pour valider les modifications, planifier la reprise d’activité après sinistre 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 automatiques de votre instance GitHub Enterprise Server avec GitHub Enterprise Server Backup Utilities. Pour plus d’informations, consultez « Configuration des sauvegardes sur votre instance ».
8. Gérer la facturation pour votre entreprise
La facturation de toutes les organisations et instances de GitHub Enterprise Server connectées à votre compte d’entreprise est agrégée en une seule facture pour tous vos services GitHub.com payants. 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 « À propos de la facturation pour votre 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. Gérer les 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éation d’une équipe » 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 LISEZMOI 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 LISEZMOI pour une entreprise ».
Partie 3 : Génération en toute sécurité
Pour renforcer la sécurité de votre instance GitHub Enterprise Server, vous pouvez configurer l’authentification des membres de l’entreprise, utiliser des outils et les journaux d’audit pour maintenir la conformité, configurer des fonctionnalités de sécurité et d’analyse pour vos organisations et éventuellement activer GitHub Advanced Security.
1. Authentifier les membres de l’entreprise
Vous pouvez utiliser la méthode d’authentification intégrée de GitHub Enterprise Server, ou choisir un fournisseur d’authentification externe, par exemple CAS, LDAP ou SAML, pour intégrer vos comptes existants et gérer de manière centralisée les accès utilisateur à votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « À propos de la gestion de l'identité et de l'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 « À propos du journal d’audit de votre entreprise ».
3. Configurer les fonctionnalités de sécurité pour vos organisations
Pour assurer la sécurité des organisations de votre instance GitHub Enterprise Server, vous pouvez utiliser diverses fonctionnalités de sécurité GitHub, notamment les stratégies de sécurité, les graphiques de dépendance, l’analyse des secrets et les mises à jour de sécurité et de version Dependabot. Pour plus d’informations, consultez « Démarrage rapide pour la sécurisation de votre organisation ».
4. Activer les fonctionnalités de GitHub Advanced Security
Vous pouvez mettre à niveau votre licence GitHub Enterprise Server pour inclure GitHub Advanced Security. Cette licence donne accès à des fonctionnalités supplémentaires qui aident les utilisateurs à détecter et résoudre les problèmes de sécurité dans leur code, tels que l’analyse du code et des secrets. Pour plus d’informations, consultez « Activation de GitHub Advanced Security pour votre entreprise ».
Partie 4 : Personnalisation et automatisation du travail dans votre entreprise dans GitHub
Vous pouvez personnaliser et automatiser le travail dans les organisations de votre entreprise avec GitHub et OAuth apps, l’API GitHub Enterprise Server, GitHub Actions, GitHub Packages et GitHub Pages.
1. Créer avec GitHub Apps et OAuth apps
Vous pouvez créer des intégrations avec l’API GitHub Enterprise Server, comme GitHub Apps ou OAuth apps, en vue de les utiliser ensuite dans les organisations pour compléter et étendre vos workflows. Pour plus d’informations, consultez « À propos de la création d’applications GitHub ».
2. Utiliser l’API GitHub Enterprise Server
Il existe deux versions de l’API GitHub Enterprise Server : l’API REST et l’API GraphQL. Vous pouvez utiliser les API GitHub Enterprise Server pour automatiser les tâches courantes, sauvegarder vos données ou créer des intégrations qui étendent GitHub Enterprise Server. Pour plus d’informations, consultez « Comparaison de l’API REST de GitHub et de l’API GraphQL ».
3. Créer avec GitHub Actions
Avec GitHub Actions, vous pouvez automatiser et personnaliser le workflow de développement de votre instance GitHub Enterprise Server sur GitHub Enterprise Server. Vous pouvez créer vos propres actions, ainsi qu’utiliser et personnaliser des actions personnalisées partagées par la communauté GitHub. Pour plus d’informations, consultez « Écriture de workflows ».
Pour plus d’informations sur l’activation et la configuration de GitHub Actions sur GitHub Enterprise Server, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».
4. Publier et gérer des packages avec 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 de GitHub Packages pour votre instance GitHub Enterprise Server, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».
5. Utiliser 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 GitHub Pages pour votre entreprise » et « À propos de GitHub Pages ».
Partie 5 : Connexion à d’autres ressources GitHub
Vous pouvez utiliser GitHub Connect pour partager des ressources.
Si vous êtes propriétaire d’une instance de GitHub Enterprise Server et d’un compte d’entreprise ou d’organisation GitHub Enterprise Cloud, vous pouvez activer GitHub Connect. GitHub Connect vous permet de partager des workflows et fonctionnalités spécifiques entre votre instance GitHub Enterprise Server et GitHub Enterprise Cloud, par exemple une recherche unifiée et des contributions. Pour plus d’informations, consultez « Enabling GitHub Connect for GitHub.com ».
Partie 6 : Utilisation des ressources d’apprentissage et de support de GitHub
Les membres de votre entreprise peuvent utiliser nos ressources d’apprentissage pour en apprendre davantage sur Git et GitHub. Vous pouvez aussi contacter le Support GitHub Enterprise si vous avez besoin d’aide pour configurer et gérer votre instance GitHub Enterprise Server.
1. Consulter la documentation relative à GitHub Enterprise Server sur GitHub Docs
Vous pouvez consulter la documentation qui décrit 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 Enterprise Server le plus efficacement possible, consultez « Bonnes pratiques pour les entreprises ».
2. Apprendre 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 pédagogiques Git et GitHub ».
3. Faire appel au Support GitHub Enterprise
GitHub Enterprise Server inclut l’accès à Support GitHub Enterprise. Support GitHub Enterprise peut vous aider à résoudre les problèmes qui se présentent sur GitHub Enterprise Server. Vous pouvez également choisir de vous inscrire à GitHub Support Premium pour bénéficier de fonctionnalités supplémentaires. Pour plus d’informations, consultez « À propos du support GitHub ».