Ce guide vous accompagne tout au long de la configuration de votre compte GitHub et de la prise en main des fonctionnalités deGitHub Enterprise Server pour la collaboration et la communauté.
Partie 1 : Configuration de votre compte GitHub
Les premières étapes à suivre pour commencer à utiliser GitHub Enterprise Server sont d’accéder à votre compte, de configurer une authentification à deux facteurs et d’afficher votre profil.
Chaque personne qui utilise GitHub Enterprise Server possède son propre compte personnel, qui peut faire partie de plusieurs organisations et équipes. Votre compte personnel est votre identité sur votre instance GitHub Enterprise Server, et vous représente en tant qu’individu.
1. Accès à votre compte
L’administrateur de votre instance GitHub Enterprise Server vous informera de la façon de vous authentifier et d’accéder à votre compte. Le processus varie en fonction du mode d’authentification configuré pour l’instance.
2. Configuration d’une authentification à deux facteurs
Une authentification à deux facteurs, ou 2FA, est une couche supplémentaire de sécurité utilisée lors de la connexion à des sites web ou à des applications. Nous vous recommandons vivement de configurer 2FA pour la sécurité de votre compte. Pour plus d’informations, consultez « À propos de l’authentification à deux facteurs ».
3. Affichage de votre graphique de profil et de contribution GitHub
Votre profil GitHub raconte l’histoire de votre travail au travers des dépôts et gists que vous avez épinglés, des appartenances à des organisations que vous avez choisi de rendre publiques, des contributions que vous avez faites et des projets que vous avez créés. Pour plus d’informations, consultez « À propos de votre profil » et « Affichage des contributions sur votre profil ».
Partie 2 : Utilisation d’outils et de processus de GitHub Enterprise Server
Pour utiliser au mieux GitHub Enterprise Server, vous devez configurer Git. Git est responsable de tout ce qui est lié à GitHub qui se produit localement sur votre ordinateur. Pour collaborer efficacement sur GitHub Enterprise Server, vous allez écrire dans des problèmes et demandes de tirage en utilisant Markdown adapté à GitHub.
1. Apprentissage de Git
L’approche collaborative de GitHub du développement dépend de la publication de validations à partir de votre dépôt local sur GitHub Enterprise Server pour que d’autres personnes puissent afficher, extraire et mettre à jour à l’aide de Git. Pour plus d’informations sur Git, consultez le guide « Manuel Git ». Pour plus d’informations sur la façon dont Git est utilisé sur GitHub Enterprise Server, consultez « GitHub flow ».
2. Configuration de Git
Si vous envisagez d’utiliser Git localement sur votre ordinateur, que ce soit via la ligne de commande, un IDE ou un éditeur de texte, vous devez installer et configurer Git. Pour plus d’informations, consultez « Configurer Git ».
Si vous préférez utiliser une interface visuelle, vous pouvez télécharger et utiliser GitHub Desktop. GitHub Desktop étant empaqueté avec Git. Il n’est pas nécessaire d’installer Git séparément. Pour plus d’informations, consultez « Bien démarrer avec GitHub Desktop ».
Une fois que vous avez installé Git, vous pouvez vous connecter à des dépôts GitHub Enterprise Server à partir de votre ordinateur local, qu’il s’agisse de votre propre dépôt ou d’une duplication d’un autre utilisateur. Lorsque vous vous connectez à un dépôt sur votre instance GitHub Enterprise Server à partir de Git, vous devez vous authentifier auprès de GitHub Enterprise Server en utilisant le protocole HTTPS ou SSH. Pour plus d’informations, consultez « À propos des référentiels distants ».
3. Choix du mode d’interaction avec GitHub Enterprise Server
Toute personne disposant de son propre workflow unique pour interagir avec GitHub. Les interfaces et méthodes que vous utilisez dépendent de vos préférences et de ce qui répond le mieux à vos besoins.
Pour plus d’informations sur les différentes approches d’interaction avec GitHub, et une comparaison des outils que vous pouvez utiliser, consultez « Connexion à GitHub ».
4. Écriture sur GitHub Enterprise Server
Pour rendre votre communication claire et organisée dans des problèmes et demandes de tirage, vous pouvez utiliser un Markdown adapté à GitHub pour la mise en forme, qui combine une syntaxe facile à lire et à écrire avec certaines fonctionnalités personnalisées. Pour plus d’informations, consultez « À propos de l'écriture et de la mise en forme sur GitHub ».
Vous pouvez apprendre à utiliser le Markdown adapté à GitHub avec le cours « Communication à l’aide de Markdown » sur GitHub Skills.
5. Recherche sur GitHub Enterprise Server
Notre recherche intégrée vous permet de trouver ce que vous cherchez parmi les nombreux dépôts, utilisateurs et lignes de code sur GitHub Enterprise Server. Vous pouvez rechercher globalement dans tout GitHub Enterprise Server, ou limiter votre recherche à un dépôt ou une organisation spécifiques. Pour plus d’informations sur les types de recherches que vous pouvez faire sur GitHub Enterprise Server, consultez « À propos de la recherche sur GitHub ».
Notre syntaxe de recherche vous permet de construire des requêtes en utilisant des qualificateurs pour spécifier ce que vous souhaitez rechercher. Pour plus d’informations sur la syntaxe de recherche à utiliser dans la recherche, consultez « Recherche sur GitHub ».
6. Gestion de fichiers sur GitHub Enterprise Server
Avec GitHub Enterprise Server, vous pouvez créer, modifier, déplacer et supprimer des fichiers dans votre dépôt ou tout dépôt auquel vous avez accès en écriture. Vous pouvez également suivre l’historique des modifications dans un fichier ligne par ligne. Pour plus d’informations, consultez « Gestion des fichiers ».
Partie 3 : Collaboration sur GitHub Enterprise Server
Un nombre quelconque de personnes peuvent collaborer dans des dépôts sur GitHub Enterprise Server. Vous pouvez configurer des paramètres, créer des projets et gérer vos notifications pour encourager une collaboration efficace.
1. Utilisation des dépôts
Création d’un dépôt
Un dépôt est comme un dossier pour votre projet. Vous pouvez avoir n’importe quel nombre de dépôts publics et privés dans votre compte personnel. Un dépôt peut contenir des dossiers et fichiers, des images, des vidéos, des feuilles de calcul et des jeux de données, ainsi que l’historique des révisions de tous les fichiers qui s’y trouvent. Pour plus d’informations, consultez « À propos des dépôts ».
Lorsque vous créez un dépôt, vous devriez l’initialiser avec un fichier README afin d’informer les utilisateurs à propos de votre projet. Pour plus d’informations, consultez « Création d’un dépôt ».
Clonage d’un dépôt
Vous pouvez cloner un dépôt existant à partir de GitHub Enterprise Server sur votre ordinateur local pour faciliter l’ajout ou la suppression de fichiers, la correction de conflits de fusion ou des validations complexes. Le clonage d’un dépôt extrait une copie complète de toutes les données du dépôt dont GitHub dispose à ce stade, y compris toutes les versions de chaque fichier et dossier du projet. Pour plus d’informations, consultez « Clonage d’un dépôt ».
Duplication d’un dépôt
Une duplication est une copie d’un dépôt que vous gérez, où aucune des modifications que vous apportez n’affecte le dépôt d’origine, sauf si vous soumettez une demande de tirage au propriétaire du projet. Le plus souvent, des duplications sont utilisées soit pour proposer des modifications au projet de quelqu’un d’autre, soit pour utiliser le projet de quelqu’un d’autre comme point de départ pour votre propre idée. Pour plus d’informations, consultez « Utilisation des duplications ».
2. Importation de vos projets
Si vous avez des projets existants que vous souhaitez déplacer vers GitHub Enterprise Server, vous pouvez importer des projets à l’aide de GitHub Importer, de la ligne de commande ou d’outils de migration externe. Pour plus d’informations, consultez « Importation du code source ».
3. Gestion des collaborateurs et des autorisations
Vous pouvez collaborer sur votre projet avec d'autres personnes en utilisant les problèmes, demandes de tirage et projets (classiques) de votre dépôt. Vous pouvez inviter d’autres personnes à votre dépôt en tant que collaborateurs à partir de l’onglet Collaborateurs dans les paramètres du dépôt. Pour plus d’informations, consultez « Invitation de collaborateurs à un dépôt personnel ».
Vous êtes le propriétaire de tout dépôt que vous créez dans votre compte personnel et disposez d’un contrôle total du dépôt. Les collaborateurs ont un accès en écriture à votre dépôt, ce qui limite ce qu’ils sont autorisés à faire. Pour plus d’informations, consultez « Niveaux d’autorisation pour un référentiel de compte personnel ».
4. Gestion des paramètres du dépôt
En tant que propriétaire d’un dépôt, vous pouvez configurer plusieurs paramètres, dont la visibilité, les rubriques et l’aperçu sur les réseaux sociaux du dépôt. Pour plus d’informations, consultez « Gestion des paramètres et fonctionnalités de votre dépôt ».
5. Configuration de votre projet pour des contributions saines
En ajoutant des fichiers tels que des directives de contribution, un code de conduite et des ressources de support à votre dépôt, vous pouvez créer un environnement dans lequel il est plus facile pour les collaborateurs d'apporter des contributions utiles et significatives. Pour plus d’informations, consultez « Configuration de votre projet pour des contributions saines ».
6. Utilisation de GitHub Issues et Projects (beta)
Vous pouvez utiliser GitHub Issues pour organiser votre travail avec des problèmes et des demandes de tirage, ainsi que gérer votre flux de travail avec Projects (beta). Pour plus d’informations, consultez « À propos des problèmes » et « À propos des Projects (beta) ».
7. Gestion des notifications
Les notifications fournissent des mises à jour concernant l’activité sur GitHub à laquelle vous vous êtes abonné ou avez participé. Si vous n’êtes plus intéressé par une conversation, vous pouvez vous désabonner, annuler la surveillance ou personnaliser les types de notifications que vous recevrez à l’avenir. Pour plus d’informations, consultez « À propos des notifications ».
8. Utilisation de GitHub Pages
Vous pouvez utiliser GitHub Pages pour créer et héberger un site web directement à partir d'un dépôt sur votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « À propos de GitHub Pages ».
9. Utilisation de GitHub Discussions
Vous pouvez activer GitHub Discussions pour votre dépôt afin d’aider à construire une communauté autour de votre projet. Des gestionnaires de maintenance, contributeurs et visiteurs peuvent utiliser des discussions pour partager des annonces, poser des questions et y répondre, et participer à des conversations autour d’objectifs. Pour plus d’informations, consultez « À propos des discussions ».
Partie 4 : Personnalisation et automatisation de votre travail sur GitHub Enterprise Server
Vous pouvez utiliser des outils de GitHub Marketplace, l’API GitHub Enterprise Server, et des fonctionnalités GitHub Enterprise Server existantes pour personnaliser et automatiser votre travail.
1. Utilisation de 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 ».
2. Génération d’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 « Découvrir GitHub Actions ».
3. Publication et gestion de 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 ».
Partie 5 : Génération en toute sécurité sur GitHub Enterprise Server
GitHub Enterprise Server offre diverses fonctionnalités de sécurité qui permettent de sécuriser le code et les secrets dans les dépôts. Certaines fonctionnalités sont disponibles pour tous les dépôts, tandis que d’autres ne sont disponibles que pour des dépôts publics et des dépôts avec une licence GitHub Advanced Security. Pour une vue d’ensemble des fonctionnalités de sécurité de GitHub Enterprise Server, consultez « Fonctionnalités de sécurité de GitHub ».
1. Sécurisation de votre dépôt
En tant qu’administrateur de dépôt, vous pouvez sécuriser vos dépôts en configurant leurs paramètres de sécurité. Il s’agit notamment de la gestion de l’accès à votre dépôt, de la définition d’une stratégie de sécurité et de la gestion des dépendances. Pour les dépôts publics et pour les dépôts privés appartenant à des organisations où GitHub Advanced Security est activé, vous pouvez également configurer l’analyse du code et des secrets pour identifier automatiquement les vulnérabilités et vérifier que les jetons et les clés ne sont pas exposés.
Pour plus d’informations sur les étapes à suivre pour sécuriser vos dépôts, consultez « Sécurisation de votre dépôt ».
Partie 6 : Participation à la communauté de GitHub
Il existe de nombreuses façons de participer à la communauté GitHub. Vous pouvez contribuer à des projets open source, interagir avec des personnes dans GitHub Community Support, ou apprendre avec GitHub Skills.
1. Contribution à des projets open source
Contribuer à des projets open source sur GitHub peut être un moyen gratifiant d’apprendre, d’enseigner et d’acquérir de l’expérience en lien avec pratiquement toute compétence. Pour plus d’informations, consultez « Comment contribuer à l’Open Source » dans Open Source Guides.
Vous trouverez des recommandations personnalisées pour des projets et de bons problèmes de départ en fonction de vos contributions passées, étoiles et autres activités dans Explorer GitHub.
2. Interaction avec GitHub Community Support
Vous pouvez entrer en contact avec les développeurs du monde entier pour poser et répondre à des questions, apprendre et interagir directement avec l’équipe de GitHub Enterprise Server. Pour commencer la conversation, consultez « GitHub Community Support ».
3. Lecture à propos de GitHub Enterprise Server sur GitHub Docs
Vous pouvez lire la documentation qui reflète les fonctionnalités disponibles sur GitHub Enterprise Server. Pour plus d’informations, consultez « À propos des versions de GitHub Docs ».
4. Apprentissage avec GitHub Skills
Vous pouvez apprendre de nouvelles compétences en effectuant des projets amusants et réalistes dans votre 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 ».