Ce guide vous guide tout au long de la configuration de votre GitHub compte et de la prise en main GitHubdes fonctionnalités de collaboration et de communauté.
Partie 1 : Configuration de votre GitHub compte
Les premières étapes à suivre GitHub sont d’accéder à votre compte, de configurer l’authentification à deux facteurs et d’afficher votre profil.
Chaque personne qui utilise GitHub possède son propre compte personnel, qui peut faire partie de plusieurs organisations et équipes. Votre compte personnel est votre identité votre instance GitHub Enterprise Server et vous représente en tant qu’individu.
1. Accès à votre compte
L’administrateur de votre GitHub Enterprise Server instance vous informe de la façon d’authentifier et d’accéder à votre compte. Le processus varie en fonction du mode d’authentification configuré pour l’instance.
2. Configuration de l’authentification à 2 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 ».
Si vous le souhaitez, une fois que vous avez configuré 2FA, ajoutez une clé d’accès à votre compte pour activer une connexion sécurisée sans mot de passe. Consultez « Gestion de vos clés d'accès ».
3. Affichage de votre GitHub profil et graphique de contribution
Votre GitHub profil indique aux personnes l’histoire de votre travail par le biais des référentiels et des gists que vous avez épinglés, les appartenances à l’organisation que vous avez choisies pour publiciser, les contributions que vous avez apportées et les 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 des outils et des processus de GitHub
Pour optimiser l’utilisation GitHub, vous devez configurer Git. Git est responsable de tout ce qui est GitHublié à Git et qui se passe localement sur votre ordinateur. Pour collaborer efficacement sur GitHub, vous rédigerez vos issues et pull requests en utilisant le GitHub Flavored Markdown de GitHub.
1. Apprentissage de Git
GitHubL’approche collaborative du développement repose sur la publication des commits de votre dépôt local sur GitHub afin que d’autres personnes puissent les consulter, les récupérer et les mettre à jour à l’aide de Git. Pour plus d’informations sur Git, consultez le guide Manuel Git. Pour plus d’informations sur l’utilisation de Git, GitHubconsultez flux de GitHub.
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 est fourni avec Git. Il n’est donc pas nécessaire d’installer Git séparément. Pour plus d’informations, consultez « Bien démarrer avec GitHub Desktop ».
Une fois Git installé, vous pouvez vous connecter aux dépôts GitHub depuis votre ordinateur local, qu’il s’agisse de votre propre dépôt ou du fork d’un autre utilisateur. Lorsque vous vous connectez, depuis Git, à un référentiel sur votre instance GitHub Enterprise Server, vous devez vous authentifier auprès de GitHub en utilisant HTTPS ou SSH. Pour plus d’informations, consultez « À propos des référentiels distants ».
3. Choix de l’interaction avec GitHub
Tout le monde a son propre flux de travail unique pour interagir avec GitHub; les interfaces et les méthodes que vous utilisez dépendent de vos préférences et de ce qui fonctionne le mieux pour 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. Écrire sur GitHub
Pour rendre votre communication claire et bien structurée dans les tickets et les pull requests, vous pouvez utiliser le GitHub GitHub Flavored Markdown pour le formatage, qui associe une syntaxe facile à lire et à écrire à quelques fonctionnalités spécifiques. Pour plus d’informations, consultez « À propos de l’écriture et de la mise en forme sur GitHub ».
Vous pouvez apprendre GitHub Flavored Markdown avec le cours Communiquer à l’aide du cours Markdown sur GitHub Skills.
5. Recherche sur GitHub
Notre recherche intégrée vous permet de trouver ce que vous recherchez parmi les nombreux référentiels, utilisateurs et lignes de code sur GitHub. Vous pouvez effectuer une recherche dans l’ensemble de GitHub ou limiter votre recherche à un référentiel ou à une organisation spécifique. Pour plus d’informations sur les types de recherches que vous pouvez effectuer GitHub, 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 des fichiers sur GitHub
Avec GitHub, vous pouvez créer, modifier, déplacer et supprimer des fichiers dans votre référentiel ou tout référentiel 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
Autant de personnes que nécessaire peuvent travailler ensemble dans des dépôts sur GitHub. Vous pouvez configurer des paramètres, créer des projets et gérer vos notifications pour encourager une collaboration efficace.
1. Utilisation des référentiels
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 depuis GitHub vers votre ordinateur local afin de faciliter l’ajout ou la suppression de fichiers, la résolution des conflits de fusion ou la création de commits complexes. Le clonage d’un référentiel extrait une copie complète de toutes les données de référentiel qui GitHub ont à ce stade dans le temps, y compris toutes les versions de chaque fichier et dossier pour le projet. Pour plus d’informations, consultez « Clonage d’un dépôt ».
Duplication d’un dépôt
Un fork est une copie d’un dépôt que vous gérez, où les modifications que vous apportez ne affecteront pas le dépôt d’origine, sauf si vous soumettez une pull request au propriétaire du projet. Le plus souvent, les forks sont utilisés soit pour proposer des changements 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 « Travail avec les forks ».
2. Importation de vos projets
Si vous avez des projets existants que vous souhaitez migrer vers GitHub, vous pouvez importer des projets à l’aide de GitHub Importer, de la ligne de commande ou d’outils de migration externes. 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 utilisateurs à l’aide des problèmes de votre dépôt, des demandes de tirage (pull requests) et projets. 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 « Inviter des collaborateurs à un référentiel 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 des fonctionnalités de votre référentiel ».
5. Configuration de votre projet pour des contributions saines
En ajoutant des fichiers tels que des instructions de contribution, un code de conduite et des ressources de support à votre dépôt, vous pouvez créer un environnement où il est plus facile pour les collaborateurs d’apporter des contributions significatives et utiles. Pour plus d’informations, consultez « Configuration de votre projet pour des contributions saines ».
6. Utilisation GitHub Issues et Projects
Vous pouvez utiliser GitHub Issues pour organiser votre travail avec des tickets et des pull requests, et pour gérer votre flux de travail avec Projects. Pour plus d’informations, consultez « À propos des problèmes » et « À propos des Projects ».
7. Gestion des notifications
Les notifications fournissent des mises à jour sur l’activité sur GitHub laquelle vous avez souscrit ou 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 « Qu’est-ce que GitHub Pages ? ».
9. Utilisation de GitHub Discussions
Vous pouvez activer GitHub Discussions pour votre dépôt afin de favoriser la création d’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
Vous pouvez utiliser les outils de GitHub Marketplace, l'API GitHub et les fonctionnalités existantes GitHub pour personnaliser et automatiser votre travail.
1. Utilisation de l’API GitHub
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 ».
2. 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 ».
3. 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 ».
Partie 5 : Développer en toute sécurité sur GitHub
GitHub dispose d’une variété de fonctionnalités de sécurité qui permettent de sécuriser le code et les secrets dans les référentiels. Certaines fonctionnalités sont disponibles pour tous les dépôts, tandis que d’autres sont uniquement disponibles pour les dépôts publics et les dépôts dotés d’une licence GitHub Code Security ou GitHub Secret Protection. Pour une vue d'ensemble des dispositifs de sécurité, voir fonctionnalités de sécurité 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 référentiels publics et pour les référentiels privés appartenant à des organisations disposant de licences pour les fonctionnalités, 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 référentiels, consultez Guide de démarrage rapide pour sécuriser votre référentiel.
Partie 6 : Participer à 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 les guides de l’Open Source.
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 vous connecter avec des développeurs du monde entier pour poser des questions et y répondre, apprendre et interagir directement avec le personnel de GitHub. Pour commencer la conversation, consultez GitHub Community Support.
3. Lecture à propos de GitHubGitHub Docs
Vous pouvez lire la documentation correspondant au produit GitHub que vous utilisez actuellement. 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 d’apprentissage Git et GitHub ».