Comment créer et gérer un référentiel Github à partir de la ligne de commande

La création de nouveaux référentiels Github est une partie essentielle du flux de travail de nombreuses personnes, en particulier lors du démarrage de nouveaux projets. L’automatisation de ce processus est possible à l’aide du propre outil CLI de Github, qui vous permet de créer et de gérer les dépôts de votre compte à partir de la ligne de commande.

Pourquoi automatiser Github ?

Si vous travaillez beaucoup avec Github, vous connaissez probablement le processus de création d’un référentiel et de le lier à votre git montage avec git init ou git remote add.

Faire cela manuellement peut cependant devenir un peu fastidieux, surtout lorsque c’est le changement de contexte qui vous sort de votre flux de travail, juste pour aller cliquer sur certains boutons et récupérer un lien sur le site Web de Github. Bien sûr, si cela vous convient, vous devriez simplement utiliser la norme git init ou git remote add méthode et configurez-la normalement.

Mais, Github dispose d’un outil de ligne de commande qui peut être utilisé pour créer facilement des dépôts avec une seule commande. Il est couramment utilisé pour automatiser d’autres tâches, comme travailler sur des demandes d’extraction ou des problèmes, mais possède une sous-commande pour travailler avec des référentiels qui peuvent créer et gérer des référentiels.

Utilisation de la CLI de Github

Tout d’abord, vous devrez installer la CLI et la lier à votre compte Github. C’est assez simple cependant; vous pouvez trouver les versions et les instructions d’installation sur le référentiel Github de l’outil.

Il est disponible pour la plupart des gestionnaires de packages, y compris Windows winget, et tous les binaires et programmes d’installation sont disponibles en tant que versions. Par exemple, si vous êtes sous Windows, vous pouvez l’installer nativement en utilisant le MSI. Mais, si vous utilisez le sous-système Windows pour Linux (WSL), ou simplement Linux ordinaire, vous pouvez l’installer à partir de apt:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key C99B11DEB97541F0
sudo apt-add-repository https://cli.github.com/packages
sudo apt update
sudo apt install gh

Cela peut vous inciter à faire confiance à la clé du référentiel de packages de Github.

Une fois installé, vous devrez vous connecter.

gh auth login

Cela vous demandera quelques informations et vous demandera enfin de vous connecter avec votre navigateur via OAuth, ou de créer et de coller manuellement un jeton d’authentification à partir des paramètres de sécurité de votre compte.

La connexion avec OAuth est cependant simple et nécessite simplement que vous appuyiez sur le bouton. Cependant, il peut ne pas ouvrir votre navigateur Web par défaut, vous devrez donc peut-être appuyer manuellement sur le lien et copier la clé à 8 chiffres affichée dans le terminal.

Ensuite, vous pouvez faire un repo très facilement, en spécifiant --public ou --private lors de l’utilisation de la commande :

gh repo create test --private

Et vous devriez voir le nouveau référentiel dans votre compte :

La CLI Github a un tas d’autres sous-commandes pour travailler avec les repos :

• gh repo edit, qui peut définir de nombreux indicateurs de configuration différents, tels que la branche par défaut, si les pages problèmes/wiki/projet sont activées, ainsi que votre page d’accueil et votre description.
• gh repo fork, qui fonctionne comme git clone sauf à forger le référentiel cible et à en faire une copie dans votre compte.
• gh repo list, qui imprime une liste de vos référentiels.
• gh repo rename, modifie le nom et l’URL.