En lugar de usar ngrok, ahora podemos hacer port forwarding y tener el mismo resultado build-in en vscode.
Aquì les dejo la documentaciòn:
Configurar webhooks de GitHub con Go te permite recibir eventos en tiempo real cada vez que alguien hace push a tu repositorio. Aprenderás a montar una API en Go con Mux Router, exponerla públicamente con Ngrok y conectarla a GitHub para capturar el payload del último commit.
Este flujo es útil si construyes herramientas de tracking, auditoría o automatizaciones sobre tu repo, y los conceptos aplican más allá de Go: son transversales a cualquier lenguaje.
¿Cómo se inicializa un proyecto en Go con Mux Router?
Lo primero es crear la base del proyecto y declarar el módulo con sus dependencias.
El flujo que seguimos en la clase fue directo:
github-tracker para alojar el código [00:08].go mod init github-tracker para generar el archivo go.mod con las dependencias [00:35].main.go dentro del paquete main con la función principal donde vive la lógica [00:48].Si no tienes la dependencia instalada, usa go get con el path de Gorilla Mux. Esto la deja registrada en tu sistema, pero no necesariamente en el proyecto.
¿Qué hace go mod vendor? Trae las dependencias declaradas en
go.moda una carpeta local llamadavendor, para que vivan dentro del proyecto y no dependan de tu instalación global de Go.
Después de instalar Mux, ejecutamos go mod vendor y luego go mod tidy para sincronizar todo correctamente [01:30].
¿Cómo se construye un handler POST en Go para recibir webhooks?
El handler es la función que define qué pasa cuando alguien llama a un endpoint. En este caso, creamos uno llamado postHandler que escucha en la ruta /hello.
En Go, un handler de API REST recibe dos parámetros obligatorios: un writer y un request. La lógica fue así [02:20]:
received POST request.body cuando termine la ejecución del módulo.io.ReadAll, ya que llega serializado en bytes.En el router, registramos el handler con HandleFunc y especificamos Methods("POST") para limitarlo solo a peticiones POST [03:30].
¿Cómo se levanta el servidor en el puerto 8080?
Usamos la librería nativa http de Go con ListenAndServe(":8080", router). Antes imprimimos un log tipo server listening on port 8080 y validamos errores. Con go run main.go, el servidor queda escuchando peticiones locales [04:10].
¿Cómo exponer tu servidor local con Ngrok para recibir webhooks de GitHub?
GitHub necesita una URL pública para enviarte eventos, y tu localhost:8080 no lo es. Aquí entra Ngrok, una herramienta que crea un túnel público hacia tu puerto local.
El proceso de configuración es sencillo:
ngrok http 8080 en una terminal aparte mientras el servidor de Go corre en otra [05:30].Ngrok te devuelve una URL pública que apunta directo a tu puerto 8080. Esa URL es la que vas a registrar en GitHub.
¿Qué es un webhook? Es una notificación HTTP automática que un servicio envía a una URL cuando ocurre un evento. GitHub puede mandarte un POST cada vez que alguien hace push, abre un pull request o crea un issue.
¿Cómo configurar el webhook en el repositorio de GitHub?
En el repositorio donde quieres escuchar eventos, ve a Settings y luego a Webhooks. Al añadir uno nuevo, GitHub te pedirá el código de two factor authentication si lo tienes activo, lo cual deberías [06:20].
Los campos clave son:
/hello.application/json, que es lo que vamos a parsear.Una vez añadido, GitHub queda escuchando y enviará un ping inicial para validar la conexión.
¿Qué información trae el payload de un webhook push de GitHub?
Para probarlo, hicimos un push real al repositorio. Antes, agregamos un .gitignore para excluir la carpeta vendor y archivos como .DS_Store, evitando subir las dependencias y solo versionando go.mod, go.sum y main.go [08:15].
Al ejecutar git push, el servidor en Go imprimió un payload enorme con todos los datos del evento. En la interfaz de GitHub, dentro de Recent deliveries, puedes ver cada entrega de forma legible.
El campo más útil para este proyecto es head_commit, que contiene:
¿Por qué usar Ngrok solo en desarrollo? Porque expone tu máquina local a internet temporalmente. No necesitas mantener el puerto abierto siempre; en Settings puedes cambiar la URL del webhook cuantas veces quieras mientras desarrollas.
Con esto ya tienes un canal funcional entre GitHub y tu API en Go. El siguiente paso natural es persistir cada webhook en una base de datos para construir un historial de commits consultable. ¿Qué evento de GitHub te gustaría trackear primero en tu proyecto?
Configurar webhooks de GitHub con Go te permite recibir eventos en tiempo real cada vez que alguien hace push a tu repositorio. Aprenderás a montar una API en Go con Mux Router, exponerla públicamente con Ngrok y conectarla a GitHub para capturar el payload del último commit.
Este flujo es útil si construyes herramientas de tracking, auditoría o automatizaciones sobre tu repo, y los conceptos aplican más allá de Go: son transversales a cualquier lenguaje.
Lo primero es crear la base del proyecto y declarar el módulo con sus dependencias.
El flujo que seguimos en la clase fue directo:
github-tracker para alojar el código [00:08].go mod init github-tracker para generar el archivo go.mod con las dependencias [00:35].main.go dentro del paquete main con la función principal donde vive la lógica [00:48].Si no tienes la dependencia instalada, usa go get con el path de Gorilla Mux. Esto la deja registrada en tu sistema, pero no necesariamente en el proyecto.
¿Qué hace go mod vendor? Trae las dependencias declaradas en
go.moda una carpeta local llamadavendor, para que vivan dentro del proyecto y no dependan de tu instalación global de Go.
Después de instalar Mux, ejecutamos go mod vendor y luego go mod tidy para sincronizar todo correctamente [01:30].
El handler es la función que define qué pasa cuando alguien llama a un endpoint. En este caso, creamos uno llamado postHandler que escucha en la ruta /hello.
En Go, un handler de API REST recibe dos parámetros obligatorios: un writer y un request. La lógica fue así [02:20]:
received POST request.body cuando termine la ejecución del módulo.io.ReadAll, ya que llega serializado en bytes.En el router, registramos el handler con HandleFunc y especificamos Methods("POST") para limitarlo solo a peticiones POST [03:30].
Usamos la librería nativa http de Go con ListenAndServe(":8080", router). Antes imprimimos un log tipo server listening on port 8080 y validamos errores. Con go run main.go, el servidor queda escuchando peticiones locales [04:10].
GitHub necesita una URL pública para enviarte eventos, y tu localhost:8080 no lo es. Aquí entra Ngrok, una herramienta que crea un túnel público hacia tu puerto local.
El proceso de configuración es sencillo:
ngrok http 8080 en una terminal aparte mientras el servidor de Go corre en otra [05:30].Ngrok te devuelve una URL pública que apunta directo a tu puerto 8080. Esa URL es la que vas a registrar en GitHub.
¿Qué es un webhook? Es una notificación HTTP automática que un servicio envía a una URL cuando ocurre un evento. GitHub puede mandarte un POST cada vez que alguien hace push, abre un pull request o crea un issue.
En el repositorio donde quieres escuchar eventos, ve a Settings y luego a Webhooks. Al añadir uno nuevo, GitHub te pedirá el código de two factor authentication si lo tienes activo, lo cual deberías [06:20].
Los campos clave son:
/hello.application/json, que es lo que vamos a parsear.Una vez añadido, GitHub queda escuchando y enviará un ping inicial para validar la conexión.
Para probarlo, hicimos un push real al repositorio. Antes, agregamos un .gitignore para excluir la carpeta vendor y archivos como .DS_Store, evitando subir las dependencias y solo versionando go.mod, go.sum y main.go [08:15].
Al ejecutar git push, el servidor en Go imprimió un payload enorme con todos los datos del evento. En la interfaz de GitHub, dentro de Recent deliveries, puedes ver cada entrega de forma legible.
El campo más útil para este proyecto es head_commit, que contiene:
¿Por qué usar Ngrok solo en desarrollo? Porque expone tu máquina local a internet temporalmente. No necesitas mantener el puerto abierto siempre; en Settings puedes cambiar la URL del webhook cuantas veces quieras mientras desarrollas.
Con esto ya tienes un canal funcional entre GitHub y tu API en Go. El siguiente paso natural es persistir cada webhook en una base de datos para construir un historial de commits consultable. ¿Qué evento de GitHub te gustaría trackear primero en tu proyecto?
En lugar de usar ngrok, ahora podemos hacer port forwarding y tener el mismo resultado build-in en vscode.
Aquì les dejo la documentaciòn:
Es muy interesante que sea en Go
En el repo de GitHub vamos a Settings, luego a Webhooks -> Add webhook, donde pegamos la URL en Payload URL. En este caso en Content type corresponde application/json.
En SSL verification seleccionar Enable SSL verification.
En Which events would you like to trigger this webhook? seleccionamos Just the push event.
Y tildamos Active para finalmente cliquear en Add webhook.
Muy interesante, aprender nuevas tecnologías.
Rayiosss - Yo Nunka habiase visto un VSCode EN LIGHT, Cielos que mis Ojos Se Recinten , Yo soliase pensar que naide Usaba VisualStudioCode en Light y ahora veo alguien que si lo hace y me causa mucha impresion,\n ps todo el mundo lo usa en Dark.
eyyy para los nuevos posiblemente les instale en al versión 1.18 a mi me paso y el curso pide la 1.22 :
sigan estos pasos
sudo apt updatesudo apt upgradecd /sudo rm -rf usr/local/gocd ~sudo rm -rf gomkdir tempcd tempwget sudo tar -xvf go1.22.9.linux-amd64.tar.gzsudo mv go /usr/localexport GOBIN=$GOPATH/binexport GOROOT=/usr/local/goexport PATH=$PATH:$GOBIN:$GOROOT/bingo versionsi sigue con la versión 1.18 reinician y ya debería salir la 1.22.9
saludos!!!! pst llevo 3 horas y ya pude
muy buena explicación, muchas gracias!
¿Qué tan importante es el código?
El código es solo el vehículo para entender cómo viaja la información. Lo verdaderamente importante son los conceptos transversales: cómo estructurar un webhook, procesar un payload y manejar un túnel, sin importar si usas Go, Node o Python.
El lenguaje es anecdótico; la arquitectura se queda. ¿Te gustaría poner a prueba cómo interactúan estas piezas con un ejercicio?
Se sigue trabajdno y trabando a cada rato el video, lento la explicacion :(
me costó pero entendí el ejemplo :)