Git est l'un des systèmes de contrôle de version les plus utilisés pour le développement de logiciels. Construit par Linus Torvalds en 2005, Git se concentre sur la vitesse, l'intégrité des données et la prise en charge des flux de travail distribués et non linéaires. Avec son utilisation répandue même pour les grandes entreprises, il est important d'apprendre à configurer et à utiliser facilement Git. Cette procédure utilisera Git Bash pour Windows et GitHub. Cependant, les commandes utilisées ici fonctionneront sur n'importe quelle plate-forme. Ce n'est pas censé être la fin de tout le guide, mais simplement vous permettre de commencer à utiliser Git. Il y a beaucoup plus de fonctions à explorer dans Git et un environnement de travail peut avoir des variables très différentes de celles qui doivent être utilisées avec GitHub.
Pas
Partie 1 sur 3: Configuration de votre compte
Étape 1. Configurez un compte Github
Visitez GitHub et créez un compte. Pour les besoins de ce tutoriel, un compte gratuit fonctionnera très bien.
Étape 2. Installez Git Bash
Pour commencer, vous devez d'abord télécharger et installer Git Bash pour Windows. Allez-y et faites-le maintenant en suivant ce lien: Git Bash.
Une fois installé, lancez Git Bash. Vous devriez voir un écran d'invite de commande noir. Git Bash utilise des commandes Unix pour fonctionner, il est donc important d'avoir une certaine connaissance d'Unix
Étape 3. Créez une clé SSH
Afin d'établir une connexion cryptée sécurisée entre votre compte GitHub et Git Bash sur votre ordinateur, vous devez générer et lier une clé SSH. Dans Git Bash, collez ce code mais remplacez-le dans l'e-mail que vous avez utilisé avec votre compte GitHub: ssh-keygen -t rsa -b 4096 -C "[email protected]"
Vous serez alors invité à indiquer où vous souhaitez enregistrer la clé. L'emplacement par défaut suffira, alors appuyez simplement sur ↵ Entrée. Ensuite, Git Bash vous demandera d'entrer et de confirmer une phrase secrète. Bien que vous n'ayez pas à en inclure un, il est fortement recommandé de le faire
Étape 4. Ajoutez votre clé SSH au ssh-agent
Cela autorisera votre ordinateur à utiliser cette clé SSH. Entrez la commande suivante pour démarrer l'agent SSH: eval "$(ssh-agent -s)" Ensuite, entrez dans ssh-add ~/.ssh/id_rsa pour ajouter votre clé créée.
Si votre clé a un nom différent de id_rsa ou si vous l'avez enregistrée dans un emplacement différent, assurez-vous de l'utiliser à la place
Étape 5. Ajoutez votre clé SSH à votre compte
Vous devrez maintenant configurer votre compte pour utiliser votre clé nouvellement créée. Copiez la clé ssh dans votre presse-papiers: clip < ~/.ssh/id_rsa.pub. Ensuite, dans le coin supérieur droit de n'importe quelle page GitHub, cliquez sur votre photo de profil, puis sur Paramètres. Dans la barre latérale des paramètres utilisateur, cliquez sur Clés SSH et GPG. Cliquez ensuite sur Nouvelle clé SSH. Vous pouvez maintenant entrer un nom descriptif pour votre clé, puis coller votre clé dans le champ de clé et appuyer sur "Ajouter une clé SSH". Confirmez-le et vous êtes prêt!
Partie 2 sur 3: Configuration d'un projet
Étape 1. Forkez un référentiel
Pour apporter des modifications à un projet dans GitHub, il doit être fork. Accédez au référentiel sur lequel vous souhaitez travailler et bifurquez le référentiel en appuyant sur fourche dans la partie supérieure droite de la page. Cela fera une copie de ce référentiel sur votre compte.
Étape 2. Créez un répertoire local
Créez un dossier quelque part sur votre ordinateur où vous souhaitez héberger le référentiel. Utilisez ensuite Git Bash pour accéder à ce dossier. N'oubliez pas que Git Bash accepte les commandes UNIX, donc pour accéder à votre répertoire, utilisez la commande CD comme suit: $ cd /chemin/vers/répertoire
Étape 3. Clonez la fourche
Dans GitHub, accédez à votre fork et sous le nom du référentiel, cliquez sur Clone or download et copiez le lien qu'il vous donne.
Ensuite, dans Git Bash, entrez la commande suivante en utilisant votre URL copiée: $ git clone https://github.com/YOUR-USERNAME/REPOSITORY_NAME. Appuyez sur ↵ Entrée et votre clone local sera créé
Étape 4. Synchronisez votre fourche avec l'original
Vous devez être en mesure de proposer des modifications au référentiel d'origine. Accédez au référentiel d'origine que vous avez créé dans GitHub, puis cliquez sur Cloner ou téléchargez et copiez l'URL.
- Naviguez maintenant dans le dossier réel du référentiel dans GitHub. Vous saurez que vous êtes au bon endroit lorsque vous verrez un (maître) à droite de votre invite de commande.
- Maintenant, exécutez simplement $ git remote add en amont https://github.com/user/repositoryName en utilisant l'URL d'origine du référentiel.
Étape 5. Créez un utilisateur
Ensuite, vous devez créer un utilisateur pour suivre qui a apporté les modifications au référentiel. Exécutez les deux commandes suivantes. $ git config user.email "[email protected]" et $ git config user.name "Votre nom". Assurez-vous que l'e-mail que vous utilisez est le même que celui de votre compte git hub.
Étape 6. Créez une nouvelle branche
Ensuite, vous devez créer une nouvelle branche à partir de notre branche principale. Comme une branche réelle d'un arbre. Cette branche contiendra toutes les modifications spécifiques que vous apporterez. Vous devez créer une nouvelle branche à partir du maître chaque fois que vous travaillez sur un nouveau problème. Qu'il s'agisse d'une correction de bogue ou de l'ajout d'une nouvelle fonctionnalité, chaque tâche doit avoir sa propre branche unique.
- Pour créer une branche, exécutez simplement: $ git branch feature_x. Remplacez feature_x par un nom descriptif de votre fonctionnalité.
- Une fois que vous avez créé votre branche, utilisez $ git checkout feature_x. Cela vous fera basculer dans la branche feature_x. Vous êtes maintenant libre d'apporter des modifications à votre code.
Partie 3 sur 3: Pousser vos changements
Étape 1. Validez vos modifications
Une fois que vous avez terminé d'apporter des modifications ou que vous souhaitez changer de branche et travailler sur autre chose, vos modifications doivent être validées. Exécutez $ git commit --all. Cela validera automatiquement toutes les modifications que vous avez apportées au référentiel.
Vous recevrez une invite pour entrer dans un message de validation en utilisant vim. Ce message doit être court et descriptif. Utilisez les touches fléchées pour naviguer jusqu'à la ligne du haut, puis appuyez sur i sur votre clavier. Vous pouvez maintenant taper votre message. Une fois qu'il est tapé, appuyez sur Echap puis appuyez sur la touche deux-points,:. Tapez maintenant les lettres wq et appuyez sur ↵ Entrée. Cela enregistrera votre message de validation et quittera l'éditeur vim
Étape 2. Faites une demande push
Maintenant que vos modifications ont été validées, vous devez les pousser ! Entrez $ git push origin.
Étape 3. Fusionnez avec la branche principale
Retournez sur GitHub et vous devriez bientôt voir un message apparaître avec votre push. Appuyez sur "Comparer et tirer la demande". Sur cette page, vous aurez la possibilité de revoir vos modifications, ainsi que de modifier votre message de validation et d'ajouter des commentaires. Une fois que tout semble en ordre et que GitHub ne détecte aucun conflit, lancez la demande. Et c'est tout!
Il appartiendra maintenant à vos autres contributeurs et au propriétaire du référentiel d'examiner votre modification, puis de la fusionner avec le référentiel maître
Étape 4. N'oubliez jamais de récupérer et de rebaser
Il est extrêmement important de toujours travailler sur la dernière version d'un fichier. Avant de faire des requêtes push, ou si vous venez de démarrer une nouvelle branche ou de basculer vers une branche, exécutez toujours la commande suivante git fetch amont && git rebase amont/master.
