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 (0)

Read next

skillcr profile image

Optimize Your Docker Builds with .dockerignore

SkillCR -

luca1iu profile image

Obsidian - How to create Daily note every day, even if I don't open it

Luca Liu -

danielle_lee_896 profile image

Boost Your Potential with Cisco 300-535 SPAUTO Certification Exam

Danielle Lee -

melchizedek404 profile image

Master css grid

Melchizedek Amos -