Cómo usar la aplicación CLI de GitHub en Windows y WSL

GitHub de Microsoft es la plataforma de intercambio de código más grande del planeta y, si bien la usa a través de un navegador web es simple, cuando interactúa con el código y los archivos locales, lo más probable es que esté usando la terminal.

Ahí es donde entra en juego la CLI de GitHub. Una herramienta oficial creada por GitHub, ideal para usar tanto en Windows 10 como en Windows 11 en PowerShell o dentro del Subsistema de Windows para Linux (WSL). Una vez que se acostumbre, puede acelerar varias áreas de su flujo de trabajo de GitHub.

Aquí se explica cómo instalarlo, configurarlo y realizar algunos procesos básicos.

Configure una cuenta de GitHub antes que nada

No necesita una cuenta de GitHub para navegar por el código y clonar repositorios, pero aún así vale la pena registrarse. Con solo su propia cuenta y espacio de repositorio, puede guardar sus propios archivos y bifurcar otros proyectos, seguir a otros miembros y destacar repositorios para acceder fácilmente más tarde. Es de uso completamente gratuito y no requiere que tengas una cuenta de Microsoft.

Una cuenta de GitHub también le permite usar la aplicación de terminal CLI de GitHub que a menudo se pasa por alto, que debido a algunos cambios en la forma en que GitHub permite que las cuentas se autentiquen, es algo que debe tener. Más sobre eso más tarde.

Tu no propio para interactuar con GitHub a través de la terminal, pero en la mayoría de los casos este es el flujo de trabajo más eficiente.

Instalación de GitHub CLI en Windows o WSL

Las herramientas CLI de GitHub son la aplicación oficial de GitHub, y si vas a usar GitHub, vale la pena. Primero, usa un token de acceso privado con Git para enviar repositorios locales a GitHub, ya que puede usar la aplicación CLI de GitHub para autenticar todo su sistema.

Para instalar la CLI de GitHub en Windows, puede usar el Administrador de paquetes de Windows nuevamente ingresando winget install github.clio cómpralo directamente desde GitHub. Alternativamente, también está disponible a través de los administradores de paquetes Scoop y Chocolately, donde solo necesita instalar gh.

En WSL, el proceso es un poco más complicado, pero GitHub tiene documentación completa que puede seguir. Dado que la mayoría de las personas que usan WSL tienden a instalar Ubuntu o Debian, ya que se distribuyen oficialmente a través de Microsoft Store, puede usar el siguiente comando en su terminal WSL para instalarlo.

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/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

Al igual que con Git, la instalación WSL de la CLI de GitHub es independiente de la instalación de Windows que usaría en PowerShell. Ambos funcionan de la misma manera, pero si cambia entre WSL y PowerShell, deberá instalarlos en ambas ubicaciones.

Cómo configurar GitHub CLI y autenticar su cuenta

La CLI de GitHub, a diferencia de Git, poder use el nombre de usuario y la contraseña de su cuenta para la autenticación con la ventaja adicional de permitir que Git también lo envíe a su repositorio de GitHub. Para autenticar la CLI de GitHub, abra su terminal y siga estos pasos. Nuevamente, todos los pasos son los mismos ya sea que esté usando Windows o WSL.

1. En la terminal de inicio de sesión gh auth login
2. Escoger GitHub.com.

3. escoger HTTPS como protocolo.

   

   Fuente: Windows Central

4. Escribe Uds para autenticarse con sus credenciales de GitHub

5. Pegar Ingresar para iniciar sesión con un navegador web.

   

   Fuente: Windows Central

6. Tome nota del código único que proporcionó y presione Ingresar.
7. Ahora se abrirá un navegador y deberá iniciar sesión en GitHub si aún no lo ha hecho.
8. Ingrese el código una vez en el cuadro.

Ahora iniciará sesión en el cliente CLI de GitHub. Para ver la lista completa de comandos disponibles, simplemente escriba gh --help en la terminal.

Usando la CLI de GitHub

Hay una plantilla de comando básica para usar la CLI de GitHub que se ve así:

gh [command] [sub-command] [flags] 

Todos los comandos que ingrese comenzarán con gh para activar la CLI de GitHub. Hay varios comandos para usar, pero aquí hay algunos ejemplos de cómo realizaría algunas funciones básicas.

Crea un nuevo repositorio de GitHub

La CLI de GitHub le brinda la capacidad de crear nuevos repositorios remotos sin tener que abrir primero el sitio web de GitHub y luego vincularlos a su máquina local. Para hacerlo, debe inicializar Git en su directorio local y luego navegar hacia él en la terminal. Luego ingrese:

gh repo create

Se le pedirá que le dé un nombre, una descripción opcional, su visibilidad y que confirme que desea crear un control remoto de Git de "origen" en su directorio local. Una vez que todo esté hecho, puede verificar su nuevo repositorio en el sitio web de GitHub. Puede abrir este o sus otros repositorios de GitHub desde su directorio local ingresando gh browse en la terminal.

Clonar o bifurcar el repositorio de GitHub

La mayor parte del tiempo utilizará git clone comando para clonar una copia local de un repositorio de GitHub, pero puede hacer lo mismo usando la herramienta CLI de GitHub usando este comando.

gh repo clone [user/repo name or URL]

Entonces, por ejemplo, para clonar Microsoft Visual Studio, simplemente puede ingresar:

gh repo clone microsoft/vscode

El resultado final es el mismo que usar Git, y se creará un nuevo directorio en su máquina local con todo el contenido del repositorio remoto. También puede usar la CLI de GitHub para clonar el repositorio con la URL completa si tiene una, y usar el mismo comando sin el nombre de usuario le permitirá clonar su propio repositorio fácilmente.

gh repo clone [your repo name]

También puede usar la CLI de GitHub para bifurcar el repositorio y clonar una copia local si lo desea. Sin embargo, no tiene que clonarlo, pero es una forma rápida de lograr ambos objetivos con un solo comando.

gh repo fork [user/repo name or URL]

Como ejemplo:

gh repo fork microsoft/winget-pkgs

Una vez que presione Enter, se le preguntará si desea clonar la bifurcación o no, simplemente y o n sea ​​todo lo que necesita para iniciar sesión.

La herramienta CLI de GitHub también tiene una manera fácil de encontrar repositorios que quizás desee clonar, asumiendo que conoce la organización o el nombre de usuario. Por ejemplo, para ver todos los repositorios de Microsoft en GitHub, puede ingresar:

gh repo list microsoft

Crea un nuevo problema

La creación de problemas es una parte importante del proceso de GitHub, y puedes hacerlo directamente desde la línea de comandos usando este comando.

gh issue create

Luego, la herramienta le pedirá que le dé un título a su problema, seguido de abrir un editor de texto, como Nano en WSL, para completar el cuerpo del problema, luego la opción de enviar o continuar en el navegador. Es muy fácil y las instrucciones lo guiarán en cada paso del camino.

Ver y cerrar problemas

Para obtener una lista completa de herramientas disponibles para issue tipo de comando gh issue --help en la terminal. Uno de los más comunes que querrá usar es mirar el problema y luego cerrarlo si se soluciona.

Para ver todos los problemas de su repositorio de GitHub, ingrese este comando.

gh issue list

Ahora se le entregará una copia impresa de todos los problemas enviados a ese repositorio. Para cerrar un problema que ya ha sido resuelto, anote el número del problema e ingrese este comando.

gh issue close 1

Recibirá una confirmación de que el problema se ha cerrado y, para confirmar, puede ejecutar el comando list nuevamente, y debería desaparecer.

Hacer una solicitud de extracción

Hay varias opciones que tiene al crear una solicitud de extracción en la CLI de GitHub, pero la plantilla básica es la siguiente.

gh pr create [subcommand] 

En cualquier momento puedes agregar --help hacia arriba para obtener un desglose completo de todas las opciones disponibles. Si desea realizar una solicitud de extracción y continuarla en la web, por ejemplo, deberá ingresar:

gh pr create -w

Las solicitudes de extracción se comportan exactamente de la misma manera que lo hacen en la web, por lo que, por supuesto, no funcionarán si está en la rama maestra.

Hay muchos más a la CLI de GitHub de lo que hemos hablado aquí, pero con suerte, le indicará la dirección correcta, especialmente si es un novato en el uso de GitHub. Tenemos una guía completa para principiantes de GitHub que es un buen compañero para esto, pero una vez que se sienta cómodo con los conceptos básicos, hay mucho que explorar. Se puede interactuar con la mayoría de las funciones principales de GitHub mediante herramientas CLI.

Si en algún momento necesitas un poco más de información, --help marque después del comando es su amigo, porque desglosará todo lo que puede hacer con cada comando posible disponible en la CLI de GitHub.

Equipo rojo de por vida

Estas son las mejores computadoras portátiles con tecnología AMD Ryzen

Está buscando una nueva computadora portátil, pero ¿preferiría tener algo con tecnología AMD Ryzen que Intel? La elección no es tan amplia, pero afortunadamente, hay algunos portátiles excelentes para elegir.