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 « Vous pouvez ajouter des informations personnelles sur vous-même dans votre bio, comme les lieux où vous avez travaillé, les projets auxquels vous avez contribué ou vos domaines intérêts que d’autres personnes pourraient aimer connaître. » 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 la façon de s’authentifier auprès de GitHub Enterprise Server avec chacune de ces méthodes, consultez « À propos de l’authentification auprès de GitHub ».
| Méthode | Description | Cas d’utilisation |
|---|---|---|
| Accédez à GitHub.com | Si vous n’avez pas besoin d’utiliser des fichiers localement, GitHub Enterprise Server vous permet d’effectuer la plupart des actions liées à Git directement dans le navigateur, de la création et la duplication de dépôts à la modification de fichiers, en passant par l’ouverture de demandes de tirage. | Cette méthode est utile si vous souhaitez une interface visuelle et devez effectuer des modifications rapides et simples ne nécessitant pas de travail localement. |
| GitHub Desktop | GitHub Desktop étend et simplifie votre workflow GitHub.com, à l’aide d’une interface visuelle au lieu de commandes de texte sur la ligne de commande. Pour savoir plus en détail comment bien démarrer avec GitHub Desktop, consultez « Bien démarrer avec GitHub Desktop ». | Cette méthode est optimale si vous devez ou voulez travailler avec des fichiers localement, mais préférez recourir à une interface visuelle pour utiliser Git et interagir avec GitHub Enterprise Server. |
| IDE ou editeur de texte | Vous pouvez définir un éditeur de texte par défaut, comme Visual Studio Code, pour ouvrir et modifier vos fichiers avec Git, utiliser des extensions et afficher la structure du projet. Pour plus d’informations, consultez « Association d’éditeurs de texte à Git ». | Cela est pratique si vous travaillez avec des fichiers et projets plus complexes, et disposer de tout au même endroit, car les éditeurs de texte ou les IDE vous permettent souvent d’accéder directement à la ligne de commande dans l’éditeur. |
| Ligne de commande, avec ou sans GitHub CLI | Pour contrôler et personnaliser au plus précis la manière dont vous utilisez Git et interagissez avec GitHub Enterprise Server, vous pouvez utiliser la ligne de commande. Pour plus d’informations sur l’utilisation des commandes Git, consultez « Aide-mémoire Git ». GitHub CLI est un outil en ligne de commande séparé que vous pouvez installer, qui apporte des demandes de tirage, des problèmes, des GitHub Actions et d’autres fonctionnalités de GitHub à votre terminal pour vous permettre d’accomplir tout votre travail au même endroit. Pour plus d’informations, consultez « À propos de GitHub CLI ». | Cela est très pratique si vous travaillez déjà à partir de la ligne de commande, ce qui vous permet d’éviter de changer de contexte, ou si vous êtes plus à l’aise avec la ligne de commande. |
| GitHub Enterprise Server API | GitHub a une API REST et une API GraphQL que vous pouvez utiliser pour interagir avec GitHub Enterprise Server. Pour plus d’informations, consultez « À propos des API GitHub ». | L’API GitHub Enterprise Server est particulièrement utile si vous voulez automatiser des tâches courantes, sauvegarder vos données ou créer des intégrations qui étendent 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 tableaux de projet 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 l’importateur GitHub, 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 tableaux de projet 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 problèmes et tableaux de projet GitHub
Vous pouvez utiliser des problèmes GitHub pour organiser votre travail avec des problèmes et des demandes de tirage, et gérer votre workflow avec des tableaux de projet. Pour plus d’informations, consultez « À propos des problèmes » et « À propos des project boards ».
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 ».
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 « À propos des API GitHub ».
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 « Présentation de GitHub Packages ».
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.
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 ».