DEV Community

Cover image for 🚀 Guía para principiantes: instalación y uso de GitHub CLI 🛠️
The Eagle 🦅
The Eagle 🦅

Posted on

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

#spanish #beginners #productivity #github

¿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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Parte 2: Iniciar sesión 🔐

Primero escribe en tu terminal:

gh auth login
Enter fullscreen mode Exit fullscreen mode

Te pedirá:

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

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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...
Enter fullscreen mode Exit fullscreen mode

🎉 ¡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: ....
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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

Mostrando el repositorio de GitHub, la pestaña donde puedes seleccionar http, ssh o github cli
Y git clone de esta manera:

git clone git@github.com:chrislgarry/Apollo-11.git
Enter fullscreen mode Exit fullscreen mode

Y puedes ver el README.md del repositorio:

 gh repo view chrislgarry/Apollo-11
Enter fullscreen mode Exit fullscreen mode

Terminal mostrando la descripción de GitHub
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
Enter fullscreen mode Exit fullscreen mode

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

gh gist create file.txt
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
También puedes listar los gists:

gh gist list
Enter fullscreen mode Exit fullscreen mode

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

gh issue create --title "Título del issue" --body "Cuerpo del issue"
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
También puedes crear issues:

gh issue create --title "Título del issue" --body " Cuerpo del issue"
Enter fullscreen mode Exit fullscreen mode

ver issues:

gh issue view <número-del-issue>
Enter fullscreen mode Exit fullscreen mode

Y cerrar issues:

gh issue close <número-del-issue>
Enter fullscreen mode Exit fullscreen mode

5 - Listar pull requests 🌟: gh pr list

gh pr list
Enter fullscreen mode Exit fullscreen mode

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

gh pr view <número-del-pr>
Enter fullscreen mode Exit fullscreen mode

fusionar una pull request:

gh pr merge <número-del-pr>
Enter fullscreen mode Exit fullscreen mode

Y revisarla:

gh pr review --approve --body "¡Se ve bien!"
Enter fullscreen mode Exit fullscreen mode

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 😂

Top comments (2)

Collapse
 
eduardo_fredymelendezra profile image
EDUARDO FREDY MELENDEZ RAVELLO •

Excelente guía, encontrar este contenido en español es de mucho aporte!

Collapse
 
eduardo_fredymelendezra profile image
EDUARDO FREDY MELENDEZ RAVELLO •

Excelente contenido en español!