Qu’est-ce que Github, comment l’utiliser, comment créer un projet, gérer et configurer

Qu’est-ce que GitHub, pourquoi est-il nécessaire et comment utiliser GitHub, comment commencer à utiliser le service – un guide pour les débutants.
GitHub est l’un des services les plus populaires pour l’hébergement de référentiels open source. Le site vous permet de publier des projets personnalisés et de suivre les modifications apportées à chaque itération. Les autres utilisateurs de GitHub peuvent consulter le code utilisateur et suggérer leurs propres modifications. Cette définition ne fournit qu’une brève compréhension. Cependant, la fonctionnalité du service ne se limite pas à cela. Dans cet article de revue, nous examinerons Github plus en détail.

Qu’est-ce que GitHub et comment démarrer – Guide du débutant

GitHub est un portail en ligne où les développeurs et les programmeurs peuvent télécharger le code qu’ils créent et travailler ensemble pour l’améliorer. La caractéristique de GitHub est son système de contrôle de version robuste. Le contrôle de version permet aux programmeurs de personnaliser le logiciel sans compromettre le logiciel lui-même. Les modifications proposées peuvent facilement être fusionnées dans une version complète, mais seulement après que toutes les modifications ont été examinées et approuvées.

Git et GitHub – quelle est la différence, première connaissance de Git et GitHub

Qu’est-ce que Git ?

Réponse : Un système de contrôle de version rapide et évolutif . Git est un système de contrôle de révision distribué gratuit et open source conçu pour être rapide et efficace pour tout projet, du petit au très grand.

Qu’est-ce que GitHub ?

Réponse : un puissant service cloud pour gérer les développements privés et les projets open source.

Quelle est la principale différence ?

Git est un logiciel à part entière dans la catégorie des systèmes de contrôle de version, qui est installé sur l’ordinateur personnel de l’utilisateur. Git vous permet d’apporter des modifications au code via la ligne de commande (Microsoft PowerShell), et GitHub offre la possibilité de stocker des projets en accès public.

Faits intéressants sur Github

1. Le nombre maximum d’utilisateurs sur le site l’année dernière (selon les statistiques du 24 juillet 2021) était de 45 millions de personnes.
2. En 2018, Microsoft a acquis GitHub pour 7,5 milliards de dollars.
3. Il existe un référentiel git open source sur Github. N’importe qui peut y apporter des modifications. Le projet est disponible sur le lien – https://github.com/git/git?ref=stackshare

Fonctionnalités de Github

1. Capacité à s’intégrer aux plateformes et services les plus populaires – Amazon, Google Cloud et Code Climate.
2. Prise en charge de plus de 200 langages de programmation.
3. Haut niveau de consolidation et « solidarité de guilde ». Lorsqu’un utilisateur publie son projet sur GitHub, le reste de la communauté de programmation peut télécharger et évaluer le travail, la qualité du code et son degré de sophistication. Les utilisateurs tiers peuvent avertir le propriétaire du projet d’éventuels problèmes, conflits de variables, etc.

Fonctionnement de GitHub, fonctionnalités

Trois des fonctionnalités les plus importantes de Github sont la création de branches, les demandes d’extraction et la fusion. Il vaut la peine de considérer chaque fonction séparément.

Bifurquer

Le forkage d’un projet crée une copie (fork) qui permet à l’utilisateur d’expérimenter librement sans affecter le projet d’origine. Créer des forks et des pull requests : https://youtu.be/nT8KGYVurIU

Demandes d’extraction

Une demande d’extraction est publiée par le développeur une fois qu’il a fini de travailler sur la correction/modification du code. Parallèlement, le maître d’ouvrage lui-même peut revoir les modifications apportées et poser d’éventuelles questions complémentaires.

Fusion

Une fois que le propriétaire a approuvé la demande d’extraction, il fusionne la demande d’extraction et applique les modifications du projet dérivé au code source.

Guide – comment démarrer dans Github à partir de zéro

Ce guide est parfait pour tous les débutants qui commencent tout juste à apprendre Git et Github. Les étapes suivantes vous aideront à créer un système optimal pour travailler avec ce logiciel. Vous apprendrez à apporter des modifications à la base de code, à ouvrir une demande d’extraction (créer une demande d’extraction) et à fusionner du code dans la branche principale. Alors, commençons.

Étape 0Installez Git et créez un compte GitHub

1. Allez sur le site officiel de Git : https://git-scm.com/downloads
2. Cliquez sur le lien pour télécharger la version de bureau de Git pour Windows et attendez que le téléchargement soit terminé.
3. Extrayez et exécutez le programme d’installation de Git en double-cliquant sur le fichier Git.exe.
4. Autorisez l’application à apporter des modifications au PC en cliquant sur le bouton « Oui » dans la boîte de dialogue « Contrôle de compte d’utilisateur » qui s’ouvre.
5. Démarrez le processus d’installation de Git. Lisez le document principal de la licence publique GNU et cliquez sur Suivant.
6. Spécifiez un emplacement pour installer le programme ou laissez les valeurs par défaut. Le programme vous demandera de créer un dossier de menu Démarrer. Passer cet article.
7. Sélectionnez l’éditeur de texte que vous souhaitez utiliser avec Git. Dans la fenêtre déroulante, sélectionnez Notepad ++ (ou tout autre éditeur de texte avec lequel vous avez déjà travaillé) et cliquez sur « Suivant ».
8. Spécifiez un nom pour la nouvelle branche de projet. La valeur par défaut est « maître ». Il est recommandé de laisser ce paramètre par défaut.
9. Dans les options permettant de choisir PATH, client SSH, certificats de serveur, fins de ligne et terminal, laissez tout tel quel et cliquez sur le bouton « Suivant ».
10. Laissez tous les paramètres par défaut et commencez à installer le programme.
11. Une fois l’installation terminée, cochez les cases pour afficher les notes de version et démarrer Git Bash. Fermez la fenêtre du programme d’installation.

Vous pouvez enregistrer un compte sur Github en utilisant le lien suivant : https://github.com/join. Pour ce faire, vous devez saisir les données d’enregistrement de base requises à l’avenir pour vérifier le compte.

Étape 1 : Lancez Git et créez le premier dépôt local

Git a deux modes d’utilisation – bash (Git Bash) et interface utilisateur graphique (Git GUI). Pour démarrer Git Bash, ouvrez le menu Démarrer – Windows, tapez git bash et appuyez sur Entrée (ou double-clic gauche sur le raccourci du programme). Pour lancer l’interface graphique Git, ouvrez le menu Démarrer – Windows, tapez git gui et appuyez sur Entrée. Dans notre cas, nous utiliserons Git Bash.
La création d’un nouveau projet dans Git Bash implique l’utilisation de commandes spéciales pour initialiser un nouveau référentiel. Vous devez d’abord ouvrir un terminal Bash en cliquant avec le bouton droit sur le bureau, puis dans le menu déroulant Git Bash ici. Dans une fenêtre de terminal sur votre machine locale, créez un nouveau répertoire de test (dossier) en tapant ce qui suit :
getrekt:Desktop getrekt $ cd ~/Desktop
getrekt:Desktop getrekt $ mkdir
monprojet getrekt:Desktop getrekt $ cd monprojet/
La commande mkdir crée un nouveau dossier de projet local. Créez notre premier dépôt Github : https://youtu.be/yHCUc6cmhcc

Étape 2. Créer un nouveau fichier dans le référentiel

Dans le dossier du projet, ajoutez un nouveau fichier texte à l’aide de la commande touch. De manière standard, la commande créera un fichier texte vide qui aura l’extension .txt.

Attention! Git enregistre/gère uniquement les modifications apportées aux fichiers qu’il suit. Après avoir créé un nouveau fichier, l’utilisateur peut suivre son état à l’aide de la commande git status. La console donnera une liste des fichiers présents dans le référentiel.

Dès que vous ajoutez un fichier au dossier contenant le référentiel git, le programme remarquera le changement à l’intérieur du projet. Cependant, le suivi automatique ne sera pas activé, vous devez utiliser une commande spéciale pour cela – git add.
getrekt:monprojet getrekt $ touch getrekt.txt
getrekt:monprojet getrekt $ ls
getrekt.txt

Étape 3 : Ajouter le fichier à l’environnement de staging de suivi

Ajoutez le fichier à l’environnement de staging avec la commande git add.
getrekt:monprojet git add . Avec cette commande, le programme lancera le suivi automatique de tous les fichiers qui seront créés dans le dossier du projet. Vous pouvez vérifier si la commande fonctionne avec git status. Voici à quoi ressemblent les journaux sur la ligne de commande Git Bash après avoir tapé git status :
getrekt : getrekt getrekt$ git status
Sur le maître de branche
Initial commit
Modifications à valider :
(utilisez « git rm –cached … » pour désinstaller)
Nouveau fichier ajouté
Nouveau nom de fichier : getrekt.txt
nouveau fichier : getrekt.txt Commentaire du journal : Le fichier n’a pas encore été validé, mais est sur le point d’être ajouté.

Étape 4Créer un commit

Commit est un point de contrôle de tout référentiel. En termes simples, un package de modifications qui stocke des informations sur les fichiers ajoutés, modifiés ou supprimés qui stockent un certain code.
getrekt:myproject getrekt $ git commit -m « MES PREMIERS COMMIT GUYS! »
[master (root-commit) b345d9a] MON PREMIER COMMIT !
1 fichier modifié, 1 insertion (+)
mode de création 100644 getrekt.txt

La commande pour créer un commit est git commit -m « Commit Name ».

Attention! Le message à la fin de la commande doit être significatif et compréhensible pour les autres développeurs de projet. Ne nommez pas vos commits comme « asdfadsf » ou « foobar ». Sinon, personne ne comprendra rien, et vous devrez passer beaucoup de temps à les supprimer.

Étape 5. Créer une nouvelle branche nouvelle branche

La nouvelle branche est une branche à part entière du projet, qui consiste en un ensemble complet de commits. Représente une version distincte du produit, mais dans le système de contrôle de version. Les branches permettent à l’utilisateur de se déplacer entre les « états » d’un projet.

Dans la documentation officielle de git, la description des branches est : « La branche dans Git et Github est un pointeur mobile vers l’un des commits du référentiel. »

Par exemple, si un utilisateur souhaitait ajouter une nouvelle page à son site Web, il pourrait créer une nouvelle branche uniquement pour cette page particulière sans affecter le corps principal du projet. Dès qu’il en a terminé, il peut fusionner les modifications de sa branche dans la branche principale. Dans le cas d’une nouvelle branche, Git garde une trace de quel commit est issu de la branche.
Après avoir exécuté la commande, vous pouvez taper git branch dans la console pour confirmer la création de la branche :
getrekt:myproject getrekt $ git branch
master
* my-new-branch Le nom my-new-branch avec un astérisque indique dans quelle branche l’utilisateur est actuellement activé.

Remarque : Par défaut, la toute première branche de chaque dépôt git est nommée « master » (et est généralement utilisée comme master dans un projet). Dans le cadre de la lutte contre le racisme, certains développeurs ont commencé à utiliser des noms alternatifs pour la branche par défaut, comme « primaire ». Cependant, le plus souvent, les utilisateurs peuvent voir « maître » ou des noms similaires utilisés pour s’y référer.

Il convient de garder à l’esprit que presque tous les dépôts ont une branche principale qui peut être considérée comme la version officielle du projet. S’il s’agit d’un site Web, la branche est la version que les utilisateurs voient. S’il s’agit d’une application, la branche principale est la version que les utilisateurs installent sur leur ordinateur ou appareil mobile. C’est ainsi que fonctionne le versioning traditionnel des produits Git et Github. Le site officiel contient une documentation plus détaillée sur l’utilisation de différents noms de branche par défaut. Les informations sont disponibles sur Github à
l’adresse https://github.com/github/renaming En cas de retour à une branche de projet et de création de plusieurs commits, la nouvelle branche ne sera pas suivie par le système de contrôle de version jusqu’à ce que l’utilisateur écrive un suivi automatique .

Étape 6Créer un nouveau référentiel GitHub

Cette étape n’est pas nécessaire si vous souhaitez uniquement suivre votre code localement. Mais si vous travaillez en équipe et acceptez les modifications d’autres programmeurs, vous pouvez utiliser les capacités actuelles de GitHub pour modifier conjointement le code du projet. Pour créer un nouveau référentiel sur GitHub, vous devez vous connecter au système et accéder à la page principale du site. Depuis le menu principal, cliquez sur le bouton « New Repository », qui se trouve sous le signe « + » à côté de la photo de profil dans le coin supérieur droit de la barre de navigation : Après avoir cliqué sur le bouton, GitHub demandera au propriétaire du projet pour nommer le référentiel et fournir une courte description :
Ensuite, cliquez sur le bouton « Créer un référentiel » pour confirmer la création d’un nouveau projet. Une boîte de dialogue apparaîtra demandant à l’utilisateur s’il souhaite créer un référentiel à partir de zéro ou en ajouter un existant créé localement. Dans le second cas, vous devez télécharger le dossier du projet sur Github.

Attention! Le téléchargement d’un dépôt local peut également se faire à l’aide de la ligne de commande, et plus précisément des commandes git remote add origin github_url (crée un enregistrement d’une nouvelle connexion au dépôt distant), git push -u origin master (établit une connexion entre la branche dans où se trouve le développeur et la branche master sur un serveur distant).

Voici à quoi ressemblent les journaux sur la ligne de commande Git Bash :
getrekt:myproject getrekt $ git remote add origin https://github.com/cubeton/mynewrepository.git
getrekt:myproject getrekt $ git push -u origin master
Compter les objets : 3, fait.
Objets d’écriture : 100 % (3/3), 263 octets | 0 octet/s, terminé.
Total 3 (delta 0), réutilisé 0 (delta 0)
Vers https://github.com/cubeton/mynewrepository.git
* [nouvelle branche] maître -> maître Maître
de branche configuré pour suivre le maître de branche distant depuis l’origine.

Étape 7 : Pousser la branche du projet vers GitHub

Une nouvelle branche de projet et un nouveau référentiel ont été créés. Il reste à « pousser » la branche et à la transférer dans le nouveau dépôt Github. De cette façon, les membres tiers de la communauté pourront voir le code et y apporter des modifications. Si les révisions sont approuvées, le propriétaire du projet peut fusionner les modifications dans la version principale du projet. Pour pousser les modifications vers une nouvelle branche sur GitHub, vous devez entrer la commande git push sur la ligne de commande. GitHub créera automatiquement une branche dans le référentiel distant :
getrekt:myproject getrekt$ git push origin my-new-branch
Compter les objets : 3, terminé.
Compression delta utilisant jusqu’à 8 threads.
Compression d’objets : 100 % (2/2), terminé.
Ecriture d’objets : 100% (3/3), 313 octets | 0 octet/s, terminé.
Total 3 (delta 0), réutilisé 0 (delta 0)
Vers https://github.com/cubeton/mynewrepository.git
* [new branch] my-new-branch -> my-new-branch Après avoir actualisé la page GitHub, l’utilisateur verra la nouvelle branche qui a été poussée dans le dépôt.

en outre

Que signifie le mot origin dans la commande git push origin ? Lorsqu’un utilisateur clone un référentiel distant sur sa machine locale, git crée un alias standard pour celui-ci dans presque tous les cas, « origin », qui est essentiellement un raccourci pour l’URL du référentiel distant. Soumettre un projet à GitHub : https://youtu.be/zM6z57OtR2Q

Étape 8. Créer la première pull request

Une demande d’extraction (ou demande d’extraction) est un moyen d’alerter les propriétaires de référentiel qu’un développeur souhaite apporter des modifications au code. Voici à quoi ressemble la page avec la pull request ajoutée :
Voici à quoi ressemble l’interface de la section après avoir créé la pull request :

Étape 9Fusionner la pull request

Le bouton vert « Merge pull request » en bas crée une pull request. Après avoir cliqué dessus, les modifications apportées sont ajoutées à la branche principale du projet.

Attention! Supprimez la branche après la fusion. Un grand nombre d’entre eux peut entraîner une confusion dans le projet. Pour supprimer une branche, cliquez sur le bouton gris « Supprimer la branche » dans le coin inférieur droit.

Pour vérifier l’état actuel des commits, cliquez sur le lien « Commits » sur la toute première page du référentiel. Cliquer pour afficher la liste complète des commits dans cette branche. La capture d’écran montre exactement celui qui vient d’être créé.

Sur le côté droit se trouve le code de hachage de chaque commit. Le code de hachage est un identifiant unique qui peut être utilisé lors de la connexion d’API et de services tiers. Vous pouvez également faire référence à un commit spécifique par le numéro d’identification sur la version de bureau de Git Bash sur la ligne de commande.

Étape 10Annuler les modifications de Github sur la machine locale

Pour le moment, le référentiel du système Github est un peu différent de l’utilisateur sur l’ordinateur local. Par exemple, un commit qu’un utilisateur a fait sur sa propre branche et fusionné dans la branche master n’existe pas sur la machine locale. Pour synchroniser automatiquement différentes versions d’un projet, vous devez utiliser la commande git pull origin master (lorsque vous travaillez sur la branche master) ou git pull.
getrekt:myproject getrekt $ git pull origin master
remote : Comptage des objets : 1, terminé.
remote : Total 1 (delta 0), réutilisé 0 (delta 0), pack-reused 0
De https://github.com/cubeton/mynewrepository
* branch master -> FETCH_HEAD  
23242..232433berer3444 master -> origin/master
getrekt. txt | 1 +
1 fichier modifié, 1 insertion(+)Pour vérifier l’état actuel d’une commande, tapez git log sur la ligne de commande. Il listera tous les commits.
getrekt: myproject getrekt git log $
engager 32dgt472hf74yh7734hf747fh373hde7r3heduer73hfhf
Merge: 3fg4dd 34fg3u7j7
Auteur: Ethan Mtdes <getrekt@yandex.ru>
Date: le 11 septembre 2015 17:48:11 -0400
branche de fusion / cubeton / MonNouveauRéférentiel
la commettras 44hgfh7f74hdu9jt93hf9ifejffe
Auteur: Mtdes de Ethan <getrekt@yandex.ru>
a Date : ven 07 janvier 17:48:00 2021 -02 356
le commit 46thf9496hf9485hkf857tg9hfj8rh4j
la fusion : 33fh5d 3689gfh
Auteur : Mtdes of Ethan <getrekt@yandex.ru>
a Date : ven 07 janvier 17 :51:00 2021 -02356
46THF9496HF9485HKF857TG9HFJ8RH4J Le commit
la fusion: 33fh5d 3689GFH
Auteur: MTdes of Ethan <getrekt@yandex.ru> A
Date: ven Jan 07 17:55:00 2021 -02 356
Ajout de plus de texte sur mon fichier
Le commit 355904-43HG0FG959HFG0G95JJGDGDFGF57I86F
La fusion : 343fggdd 53efhgffddg
Auteur : Mtdes of Ethan < getrekt@yandex.ru>
Date : ven 07 janvier 17:58:00 2021 -02356
C’est mon premier commit ! Prêt! Désormais, l’utilisateur est familiarisé avec toutes sortes de travaux dans le système de contrôle de version. Tutoriel Git et GitHub pour les débutants sur la façon d’installer Git et de démarrer avec Github, les branches, les référentiels, les commits et d’autres concepts dans la pratique GitHub : https://youtu.be/zZBiln_2FhM

Fonctionnalités supplémentaires de Github et Git

Regardons d’autres « puces » utiles qui permettront au développeur de simplifier le travail sur le contrôle de version.

Cloner un référentiel sur une machine locale

Accédez à votre référentiel GitHub. Dans le coin supérieur droit au-dessus de la liste des fichiers, ouvrez le menu déroulant « Cloner ou télécharger ». Copiez l’URL de clonage HTTPS.
Revenez à la fenêtre Git Bash et entrez la commande :
git clone repository_url

repository_url – URL du projet actuel à cloner. Au lieu de cela, l’URL du référentiel est insérée.

Dans l’exemple ci-dessus, la commande clone le référentiel via HTTPS. Une autre option est le clonage avec des URL sur des clés SSH. Pour ce faire, vous devez générer une paire de clés SSH sous Windows et attribuer une clé publique au compte GitHub.

Recherche de référentiels distants

Après le clonage, une copie du référentiel de GitHub doit apparaître dans le répertoire de travail sur l’ordinateur. Le projet doit contenir un répertoire avec un nom et des fichiers principaux. Pour y basculer, vous devez écrire la commande suivante :
cd git_project

Remarque : Remplacez git_project par le nom réel du référentiel téléchargé ou spécifiez le contenu du répertoire actuel avec la commande ls. La deuxième méthode est utilisée dans les cas où l’utilisateur ne se souvient pas du nom du projet.

Version de bureau GitHub – qu’est-ce que GitHub Desktop, fonctionnalités principales, fonctionnalités et processus d’installation

GitHub Desktop est une application de bureau qui fournit une interaction basée sur l’interface graphique avec GitHub. Contrairement à Git, la version de bureau de GitHub vous permet d’exécuter les mêmes commandes à l’aide de l’interface utilisateur en cliquant sur des boutons, ce qui facilite grandement le travail avec les référentiels.

Comment installer

1. Suivez le lien – https://desktop.github.com/
2. Commencez à télécharger le package d’installation du programme.
3. Double-cliquez sur l’icône du fichier téléchargé et procédez à l’installation de Github Desktop.
4. Lancez le programme via le menu Démarrer.
5. Connectez-vous à GitHub en utilisant les détails de votre compte utilisateur.

Fonctionnalité principale

• Création, ajout et clonage de référentiels.
• Utilisation du programme pour gérer les onglets du projet.
• Apporter des modifications à une branche.
• Création de tickets, pull requests et commits.
• Possibilité d’accéder aux premières versions des nouveaux produits.

API Github

L’API Github REST est une interface qui permet aux développeurs d’accéder aux données, projets et référentiels Github, ainsi que d’envoyer des demandes de serveur. Le lien https://api.github.com/ contient toutes les URL auxquelles vous pouvez envoyer les requêtes GET les plus simples :
Le plus souvent, les développeurs créent des requêtes dans le langage de programmation Python au format JSON. Vous devez d’abord obtenir les informations de base sur le référentiel à partir du lien – https://api.github.com/user/repos Les informations de base sont entrées dans le fichier de configuration au format JSON. Il contient les principaux paramètres de l’utilisateur – avatar, lecteurs, nombre de référentiels, téléchargements, etc. Ces données sont ensuite transmises au serveur.

Gestion et configuration des projets Github Desktop

Après l’installation, l’enregistrement d’un compte et la configuration de l’application, l’utilisateur peut commencer à utiliser le programme GitHub.

Créer, ajouter et cloner un référentiel

Pour créer un nouveau référentiel, sélectionnez « Fichier » et cliquez sur le bouton « Créer un référentiel ». Pour ajouter un projet local, sélectionnez le menu « Fichier » et cliquez sur le bouton « Ajouter un référentiel local ». Pour le clonage, vous devez sélectionner le menu « Fichier » – « Clone repository ».

Créer une nouvelle branche

Pour créer une branche de projet distincte, ouvrez la section Branche actuelle et cliquez sur le bouton Nouvelle branche. L’utilisateur pourra voir la branche dans l’interface GitHub et faire une demande d’extraction pour suivre les modifications.

Sécurité

La version desktop et web de Github permet de configurer et d’augmenter le niveau de sécurité d’un compte utilisateur. Toutes les fonctionnalités sont disponibles dans la section « Paramètres de sécurité pour le stockage ». Cela vaut la peine d’être examiné plus en détail.

Paramètre de politique de sécurité

Sur la page principale de votre référentiel, cliquez sur :

• « Sécurité » – « Politique de sécurité » – « Démarrer la configuration ».
• Ajoutez des informations sur les versions prises en charge de votre projet et sur la manière de signaler d’éventuelles vulnérabilités.

Gestion des graphes de dépendance

Un graphique de dépendance est généré automatiquement pour tous les référentiels publics, mais il n’y a pas une telle fonctionnalité pour les référentiels privés. Le graphique identifie tous les flux de dépendance sortants et vous permet d’identifier les vulnérabilités du projet. Pour définir le graphique de dépendance, cliquez sur « Paramètres » – « Sécurité et analyse ». En face du graphique, cliquez sur « Activer » ou « Désactiver ».

Licences

La licence Github prévoit l’utilisation de deux principaux types de
licence :

1. La GPL est un type de licence qui permet à d’autres utilisateurs d’utiliser le travail de quelqu’un d’autre dans d’autres projets open source. Cependant, les sociétés commerciales ne peuvent pas le faire.
2. LGPL/Commons/MIT/Apache , etc. – l’utilisateur donne son code pour une utilisation gratuite. D’autres peuvent en tirer de l’argent.

Nous avons passé en revue les principales fonctionnalités du service cloud Github et le programme de travail avec les référentiels Git Bash . Étape par étape, nous avons expliqué comment créer un projet à part entière dans le système de contrôle de version.