🚀 Guía para principiantes: instalación y uso de GitHub CLI 🛠️

🚀 Guía para principiantes: instalación y uso de GitHub CLI 🛠️

¿Por qué usar GitHub CLI?

GitHub CLI lleva GitHub a tu terminal. Te permite clonar, crear, bifurcar y ver repositorios, así como manejar issues y pull requests con comandos para listar, crear, ver y fusionar estos. También puedes gestionar gists, activar y revisar los workflows de GitHub Actions, y hacer solicitudes directas a la API. Además, tienes opciones de autenticación y configuración disponibles para gestionar el acceso y los settings, mientras que las funcionalidades de búsqueda te ayudan a encontrar repositorios, issues y más.

Parte 1: Instalar GitHub CLI 🔨

macOS 🍎

gh está disponible a través de Homebrew, MacPorts, Conda, Spack, Webi, y como un binario descargable que incluye el instalador para Mac OS .pkg desde la página de lanzamientos.

# Homebrew
brew install gh

# MacPorts
sudo port install gh

# Conda
conda install gh –channel conda-forge

# Spack
spack install gh

# Webi
curl -sS https://webi.sh/gh | sh

Windows 🪟

gh está disponible a través de WinGet, scoop, Chocolatey, Conda, Webi, y como instalador MSI.

# WinGet
winget install –id GitHub.cli

# scoop
scoop install gh

# Chocolatey
choco install gh

# Conda
conda install gh –channel conda-forge

# Spack
spack install gh

# Webi
curl -sS https://webi.sh/gh | sh

Linux 🐧

Aquí realmente depende de lo que estés usando; puedes leer la documentación de instalación para Linux para encontrar lo que necesitas, o verificar aquí los comandos dependiendo de la distribución que estés usando.

# Arch
sudo pacman -S github-cli

# Debian, Ubuntu Linux, Raspberry Pi OS (apt)
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y))
&& sudo mkdir -p -m 755 /etc/apt/keyrings
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg
&& echo “deb [arch=$(dpkg –print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main” | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
&& sudo apt update
&& sudo apt install gh -y
# Actualizar
sudo apt update
sudo apt install gh

# Fedora, CentOS, Red Hat Enterprise Linux (dnf)
sudo dnf install ‘dnf-command(config-manager)’
sudo dnf config-manager –add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh –repo gh-cli
# Alternativamente, instalar desde el repositorio comunitario:
sudo dnf install gh
# Actualizar
sudo dnf update gh

# openSUSE/SUSE Linux (zypper)
sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
sudo zypper ref
sudo zypper install gh
# Actualizar
sudo zypper ref
sudo zypper update gh

Parte 2: Iniciar sesión 🔐

Primero escribe en tu terminal:

gh auth login

Te pedirá:

? ¿En qué cuenta deseas iniciar sesión? [Usa las flechas para moverte, escribe para filtrar]
> GitHub.com
GitHub Enterprise Server

Si eliges GitHub.com, te pedirá:

? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host? [Usa las flechas para moverte, escribe para filtrar]
> HTTPS
SSH

A continuación, te preguntará tu protocolo y preferencia personal. Recomiendo SSH.

? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host? [Usa las flechas para moverte, escribe para filtrar]
HTTPS
> SSH

Ahora solo crea la contraseña para tu clave SSH, el título y selecciona cómo te gustaría autenticarte, y si es la primera vez, solo usa Iniciar sesión con un navegador web.

? ¿Generar una nueva clave SSH para agregar a tu cuenta de GitHub? (Y/n) Y

Ingresa una frase de contraseña para tu nueva clave SSH (Opcional): **************************

? Título para tu clave SSH: (GitHub CLI) TheMachine-Desktop

? ¿Cómo te gustaría autenticar GitHub CLI? [Usa las flechas para moverte, escribe para filtrar]
> Iniciar sesión con un navegador web
Pegar un token de autenticación

! Primero copia tu código de un solo uso: 1234-ABCD
Presiona Enter para abrir github.com en tu navegador…

🎉 ¡Felicidades! 🎉, ahora puedes usar GitHub desde tu terminal 🖥️. Si escribes gh auth status, deberías obtener algo como esto:

$ gh auth status
github.com
Conectado a la cuenta github.com nombredeusuario (/home/username/.config/gh/hosts.yml)
Cuenta activa: true
Protocolo de operaciones de Git: ssh
Token:
Ámbitos del token: .

Parte 3: Comandos útiles 📝

Aquí te daré ⭐Mis 5 comandos principales en GitHub CLI🏅 para que te hagas una idea de lo que eres capaz de hacer, pero siéntete libre de revisar la documentación para obtener un conocimiento más profundo de esta herramienta.

1 – Clonar un repositorio de GitHub 🥇: gh repo clone owner/repo

gh repo clone chrislgarry/Apollo-11

Bonus 🎁:
Como estás usando ssh, también puedes ir a esta sección de un repositorio de GitHub:


Y git clone de esta manera:

git clone git@github.com:chrislgarry/Apollo-11.git

Y puedes ver el README.md del repositorio:

gh repo view chrislgarry/Apollo-11


2 – Crear un nuevo repositorio en GitHub 🥈: gh repo create repo, puedes usar opciones como –public, private, –description <string> y más.

gh repo create my-new-repo –public

3 – Crear un nuevo gist 🥉: gh gist create <file>

gh gist create file.txt

Bonus 🎁:
También puedes listar los gists:

gh gist list

4 – Crear un nuevo issue 🏅: gh issue create –title <title> –body <body>

gh issue create –title “Título del issue” –body “Cuerpo del issue”

Bonus 🎁:
También puedes crear issues:

gh issue create –title “Título del issue” –body

Cuerpo del issue”

ver issues:

gh issue view <número-del-issue>

Y cerrar issues:

gh issue close <número-del-issue>

5 – Listar pull requests 🌟: gh pr list

gh pr list

Bonus 🎁:
También puedes ver la pull request:

gh pr view <número-del-pr>

fusionar una pull request:

gh pr merge <número-del-pr>

Y revisarla:

gh pr review –approve –body “¡Se ve bien!”

Pensamientos finales 🎉

GitHub CLI lleva GitHub a tu terminal, ¡haciendo que sea increíblemente poderoso! 🚀 Espero que hayas encontrado útil este post y que te haya inspirado a sacar el máximo provecho de esta herramienta. ¡No olvides suscribirte para recibir más actualizaciones de mis futuros posts! 🙌🖥️

Fuentes 📚

Instalar GitHub CLI
Instalar GitHub CLI en Linux
Manual de GitHub CLI
Código de Apollo 11

Aquí me gustaría agregar una frase personal, pero todavía estoy pensando/buscando una 😂

Please follow and like us:
Pin Share