Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
issue85:c_c [2014/11/28 18:54] – frangi | issue85:c_c [2014/11/29 17:53] (Version actuelle) – d52fr |
---|
** | ** |
| |
Le mois dernier, j'ai commencé à introduire les différents concepts et la terminologie utilisés par Git. Ce mois-ci, nous allons aller un peu plus loin, et parcourir une série d'exemples sur l'usage réel de Git (en combinaison avec GitHub; la création d'un serveur Git personnalisé est hors-sujet de cet article). Je supposerai que vous avez soit un compte gratuit sur GitHub, ou alors que vous avez trouvé le dépôt de quelqu'un que vous aimeriez dupliquer. Pour ceux qui sont intéressés, j'ai créé un dépôt public pour cet article, qui peut être trouvé ici: https://github.com/lswest/Command-Conquer-Examples. | Le mois dernier, j'ai commencé à introduire les différents concepts et la terminologie utilisés par Git. Ce mois-ci, nous allons aller un peu plus loin, et parcourir une série d'exemples sur l'usage réel de Git (en combinaison avec GitHub ; la création d'un serveur Git personnalisé est hors du cadre de cet article). Je supposerai que soit vous avez un compte gratuit sur GitHub, soit que vous avez trouvé un dépôt quelconque que vous aimeriez dupliquer. Pour ceux qui sont intéressés, j'ai créé un dépôt public pour cet article, qui peut être trouvé ici: https://github.com/lswest/Command-Conquer-Examples. |
| |
Remarque: Si vous n'avez pas de compte GitHub, et que vous utilisez le dépôt de quelqu'un, vous ne serez pas nécessairement en mesure de téléverser vers lui. Vous pouvez créer votre propre copie du dépôt par bifurcation (ça nécessite aussi un compte). | Remarque: Si vous n'avez pas de compte GitHub, et que vous utilisez le dépôt d'une autre personne, vous ne serez pas nécessairement en mesure de téléverser vers lui. Vous pouvez créer votre propre copie du dépôt par bifurcation (ça nécessite aussi un compte). |
| |
** | ** |
• Nom du dépôt | • Nom du dépôt |
• Propriétaire | • Propriétaire |
• Public / Privé (privé est disponible seulement pour les membres payants) | • Public/Privé (privé est disponible seulement pour les membres payants) |
| |
Facultatif: | Facultatif: |
• Description du dépôt | • Description du dépôt |
• Initialisation avec un Lisez-moi. | • Initialisation avec un Lisez-moi. |
• Paramètrage de .gitignore | • Paramétrage de .gitignore |
• Choix d'une licence pour le dépôt. | • Choix d'une licence pour le dépôt. |
| |
Deuxième étape: Clone du dépôt Git | Deuxième étape: Clone du dépôt Git |
| |
Il y a quelques outils d'interface graphique pour Linux, mais pour les besoins de cet article, je vais me référer qu'aux seules commandes du terminal : | Il y a quelques outils avec interface graphique pour Linux, mais, pour les besoins de cet article, je vais me référer qu'aux seules commandes du terminal : |
• Ouvrez un terminal. | • Ouvrez un terminal. |
• cd vers le sous-dossier où vous voulez que le dépôt soit situé. | • cd vers le sous-dossier où vous voulez que le dépôt soit placé. |
• Entréz: | • Entrez : |
| |
git clone https://github.com/lswest/Command-Conquer-Examples.git | git clone https://github.com/lswest/Command-Conquer-Examples.git |
| |
• Selon la taille du dépôt, ça peut prendre un moment. Une fois qu'on vous rend la main, vous l'avez cloné avec succès. Vous pouvez maintenant vouloir aller dans le dossier du dépôt (dans mon cas: cd Command-Conquer-Examples). | • Selon la taille du dépôt, ça peut prendre quelque temps. Une fois qu'on vous rend la main, vous l'avez cloné avec succès. Vous pouvez maintenant vouloir aller dans le dossier du dépôt (dans mon cas: cd Command-Conquer-Examples). |
| |
** | ** |
Troisième étape: Faire des changements | Troisième étape: Faire des changements |
| |
Pour les besoins de cet exemple, je vais éditer le fichier README.md. Naturellement, la procédure est la même pour toute autre modification: | Pour les besoins de cet exemple, je vais éditer le fichier README.md. Naturellement, la procédure est la même pour toute autre modification : |
• Ouvrez le fichier dans votre éditeur de texte favori. | • Ouvrez le fichier dans votre éditeur de texte favori. |
• Effectuez vos modifications. | • Effectuez vos modifications. |
• Une fois que le fichier est enregistré, vous devez ensuite entrer la commande suivante: | • Une fois que le fichier est enregistré, vous devez ensuite entrer la commande suivante : |
| |
git add <fichier> | git add <fichier> |
Quatrième étape: Confirmation (Commit) | Quatrième étape: Confirmation (Commit) |
| |
Une fois que vous avez ajouté le fichier que vous voulez, et vous êtes prêt à le confirmer dans la prochaine mise à jour de votre dépôt, vous pouvez exécuter la commande suivante: | Une fois que vous avez ajouté le fichier que vous voulez et que vous êtes prêt à le confirmer dans la prochaine mise à jour de votre dépôt, vous pouvez exécuter la commande suivante: |
| |
git commit | git commit |
| |
Si vous exécutez la commande comme ceci sans aucun argument ni paramètres, elle vous invite à saisir un message pour la confirmation avant de terminer. Deux options utiles sont: | Si vous exécutez la commande comme ceci sans aucun argument ni paramètres, elle vous invite à saisir un message pour la confirmation avant de terminer. Deux options utiles sont : |
• -a: ajoute automatiquement tous les fichiers modifiés (mais ignore les fichiers nouvellement ajoutés ou supprimés). | • -a : ajoute automatiquement tous les fichiers modifiés (mais ignore les fichiers nouvellement ajoutés ou supprimés). |
• -m <msg>: Utilise le message fourni comme message de confirmation, exemple :-m "Première confirmation - modif du README.md". | • -m <msg> : Utilise le message fourni comme message de confirmation, exemple : -m "Première confirmation - modif du README.md". |
| |
** | ** |
** | ** |
| |
Cinquième étape: Poussée (Push) | Cinquième étape: Poussée (Push) |
| |
Maintenant que vous avez créé une liste de confirmation de tous les changements que vous voulez prendre en charge sur le dépôt distant, vous êtes prêt à les synchroniser. Dans Git cela s'appelle une poussée. Le format de la commande est: | Maintenant que vous avez créé une liste de confirmation de tous les changements que vous voulez envoyer sur le dépôt distant, vous êtes prêt à les synchroniser. Dans Git cela s'appelle une poussée. Le format de la commande est : |
| |
git push <local> <distant> | git push <local> <distant> |
| |
Par défaut lors de l'utilisation de Github, le local sera l'origine, et le distant sera le maître. Si vous travaillez sur un dépôt plus compliqué, vous aurez besoin de vérifier l'exactitude des noms de branche. Dans cet exemple, la commande sera probablement: | Par défaut lors de l'utilisation de Github, le local sera l'origine et le distant sera le maître. Si vous travaillez sur un dépôt plus compliqué, vous aurez besoin de vérifier l'exactitude des noms de branche. Dans cet exemple, la commande sera probablement: |
| |
git push origin master | git push origin master |
| |
Si vous n'avez pas configuré git pour stocker votre nom d'utilisateur et votre mot de passe pour Github, vous serez invité à les donner maintenant. Comme c'est la coutûme dans Linux, le mot de passe ne s'affichera pas, mais sera enregistrera réellement vos frappes au clavier. | Si vous n'avez pas configuré git pour stocker votre nom d'utilisateur et votre mot de passe pour Github, vous serez invité à les donner maintenant. Comme c'est la coutume dans Linux, le mot de passe ne s'affichera pas, mais enregistrera réellement vos frappes au clavier. |
| |
===== 4 ===== | ===== 4 ===== |
Possibilité Une: Ajout d'un nouveau fichier | Possibilité Une: Ajout d'un nouveau fichier |
| |
Dans l'étape 3, nous avons discuté de la façon de modifier les fichiers qui existent déjà dans le dépôt. Tout d'abord créez un nouveau fichier en utilisant la méthode que vous souhaitez, et puis ajoutez le à une confirmation avec git add <fichier>. Une fois que vous l'avez ajouté, suivez les étapes 4 et 5. | Dans l'étape 3, nous avons discuté de la façon de modifier les fichiers qui existent déjà dans le dépôt. Tout d'abord créez un nouveau fichier en utilisant la méthode que vous souhaitez, puis l'ajoutez à une confirmation avec git add <fichier>. Une fois que vous l'avez ajouté, suivez les étapes 4 et 5. |
| |
Possibilité Deux: suppression d'un fichier | Possibilité Deux: Suppression d'un fichier |
| |
Si vous souhaitez supprimer un fichier du dépôt, le supprimer simplement du système de fichiers n'est pas suffisant. Vous aurez besoin d'utiliser la commande « git rm ». Une fois qu'un fichier est supprimé comme ceci (ex: git rm "Ajout d'un fichier.txt"), vous pouvez ensuite confirmer la modification et la pousser vers le dépôt, en suivant les étapes 4 et 5. | Si vous souhaitez supprimer un fichier du dépôt, le supprimer simplement du système de fichiers n'est pas suffisant. Vous aurez besoin d'utiliser la commande « git rm ». Une fois qu'un fichier est supprimé de cette façon (ex: git rm "Ajout d'un fichier.txt"), vous pouvez ensuite confirmer la modification et la pousser vers le dépôt, en suivant les étapes 4 et 5. |
| |
Espérons que cet article vous a aidé à faire la lumière sur l'utilisation des dépôts Git et GitHub. Si vous avez des difficultés, ou souhaitez des informations sur un scénario spécifique, n'hésitez pas à m'envoyer un courriel avec vos questions. Comme toujours, je peux être joint à lswest34+fcm@gmail.com. Pour ceux qui sont intéressés d'héberger leurs propres serveurs git, je serais heureux d'écrire un article sur ce sujet aussi (s'il y a suffisamment d'intérêt). | J'espère que cet article vous a aidé à faire la lumière sur l'utilisation des dépôts Git et GitHub. Si vous avez des difficultés, ou souhaitez des informations sur un scénario spécifique, n'hésitez pas à m'envoyer un courriel avec vos questions. Comme toujours, je peux être joint à lswest34+fcm@gmail.com. Pour ceux qui voudraient héberger leurs propres serveurs git, je serais heureux d'écrire un article sur ce sujet-là aussi (s'il y a suffisamment d'intérêt). |
| |
| |