Automatización de GitHub Actions para Actualizar Perfil

Resumen

Optimizar tu perfil de GitHub puede marcar una gran diferencia al mostrar tus habilidades y actividad de desarrollo, y GitHub Actions es la herramienta ideal para automatizar tareas que mantengan tu perfil siempre actualizado. A continuación, te explicamos cómo crear una GitHub Action que muestre tu actividad reciente directamente en tu portada de perfil.

¿Qué es GitHub Actions y cómo puede ayudarte?

GitHub Actions permite automatizar diversos flujos de trabajo, desde revisiones de seguridad con Dependabot hasta integraciones continuas y despliegues (CI/CD). Con una GitHub Action, puedes extraer automáticamente tu actividad más reciente y mostrarla en tu perfil. Esto ayuda a que otros vean tu progreso y compromiso en tus repositorios.

¿Cómo configurar tu repositorio de portada en GitHub?

Selecciona tu repositorio de perfil: Este suele llevar el nombre de usuario como nombre de repositorio.
Edita el README: Abre el archivo README.md en modo edición y asegúrate de contar con una sección específica para la actividad reciente.
Agrega un título personalizable: Por ejemplo, “Actividad reciente” o “Últimos commits”, para que la sección tenga un toque personal.

¿Cómo crear una GitHub Action para actualizar tu actividad?

Accede a la sección de Actions en el repositorio de tu perfil.
Elige una plantilla básica para crear un flujo de trabajo simple.
Configura el archivo YAML:
- Ubicación: Guarda el archivo como .github/workflows/update-readme.yml.
- Cron Job: Programa la frecuencia de actualización. Un formato común es */12 * * * * para actualizar cada 12 horas.
- Paso de checkout: Este paso accede a tus archivos.
- Recent Activity Workflow: Incluye el paso para extraer tu actividad reciente desde un flujo preconstruido disponible en el Marketplace de GitHub Actions.

¿Cómo asegurarte de que tu GitHub Action funcione correctamente?

Guarda y ejecuta la acción: Haz un commit directo en la rama principal.
Verifica el estado: Si ocurre algún error, GitHub Actions lo destacará en rojo, señalando el paso problemático.
Ajustes finales: Corrige cualquier error en el archivo YAML o en los comentarios del README, y vuelve a ejecutar el flujo de trabajo.

¿Qué opciones adicionales puedes explorar en GitHub Actions?

Marketplace: Encuentra acciones preconfiguradas para desplegar en Docker, compilar aplicaciones en Java, entre otras.
Variables de ambiente: Usa GITHUB_TOKEN para autenticar la Action y mantenerla segura.
Contenido personalizado: Puedes agregar secciones adicionales en tu perfil, como listas de videos de YouTube o portafolios enlazados.

¿Cómo hacer que tu perfil destaque con otras personalizaciones?

GitHub Actions ofrece un sinfín de posibilidades para personalizar tu perfil y mostrar contenido relevante. Explora perfiles inspiradores en los recursos de esta clase, descarga archivos YAML, y pruébalos en tu repositorio para continuar optimizando tu presencia profesional.

Diego Nicolás Rivera Sánchez

student•

Para los que les pueda salir este error al momento de correr el workflow, les recomiendo:

Ir a Settings > Actions > General.
En la sección Workflow permissions, selecciona:

Read and write permissions.

Guardar los cambios.

José Alberto Ortiz Vargas

student•

Gracias crack! Me has ayudado muchisimo.

Alexis Dorado Muñoz

student•

gracias por tu aporte

Sara María Mejia Sánchez

student•

Hola

Les comparto el update_readme.yml con las versiones actualizadas de las actions

name: Update README

on:
  schedule:
    - cron: "* */12 * * *"
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    name: Update Profile README

    steps:
      - uses: actions/checkout@v4.2.2
      
      - uses: Readme-Workflows/recent-activity@v2.4.1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Alexis Dorado Muñoz

student•

gracias por tu aporte

Roger Alexander Guillen Hernandez

student•

Muchas gracias, por que no me aparecian los aportes de la clase.

Diego Andrés Lopez Rodriguez

student•

GitHub Actions ofrece varias ventajas:

Automatización: Permite automatizar flujos de trabajo, como implementación de código y pruebas, lo que ahorra tiempo.
Integración continua: Facilita la integración continua y entrega continua (CI/CD), mejorando la calidad del software.
Personalización: Puedes crear flujos de trabajo personalizados con eventos específicos que desencadenen acciones.
Marketplace: Acceso a una amplia gama de plantillas y acciones comunitarias para facilitar tareas comunes.

Estas características ayudan a optimizar el desarrollo y la colaboración en proyectos de software.

Ignacio Robles

student•

Pasa mucho con este curso que indica enlaces o archivos en los recursos cuando no los hay.

Aldo Andres Delgado Castillo

student•

Si, como que esta mal eso en Platzi, por que no es el único curso, luego salen desfazados. En un curso de Python, me salían los archivos de un proyecto en una clase por la mitad del curso cuando debían de salir en una e las clases finales.

Yorgen Omar Marciales Parada

student•

Para agregar la funcionalidad de mostrar tu actividad reciente en tu perfil de GitHub usando GitHub Actions, debes crear un archivo YAML con el siguiente código:

name: Update README

on:
  schedule:
    - cron: '0 */12 * * *' # Cada 12 horas

jobs:
  update-readme:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2
      - name: Update README with recent activity
        uses: your-username/repository-name@main # Reemplaza con tu información

Asegúrate de modificar your-username/repository-name con tu nombre de usuario y el nombre del repositorio donde quieres aplicar esto. Guarda este archivo en la carpeta .github/workflows de tu repositorio.

Recuerda también agregar el comentario correspondiente en tu README donde deseas que aparezca la actividad reciente. ¡Buena suerte!

Samuel Soto Hoyos

student•

Al igual que Codespaces. GitHub Actions tiene una capa gratuita mensual y si se supera la cuota van a tener que pagar por consumo.

Generalmente las Actions de repositorios públicos son las que tienen la capa gratuita, para los repositorios privados tienen que pagar por consumo o correr las Actions en su propia infraestructura para asumir el costo de las Actions.

Amin Espinoza

teacher•

Costo que bien manejado se regresa sin ningún problema!

John Erikc Alexander Obando Ramirez

student•

yo lo realice de la siguente manera en el readme.md

⚡ Recent Activity

update_readme.yml

on:

schedule:

- cron: '0 */12 * * *' #

workflow_dispatch:

jobs:

build:

runs-on: ubuntu-latest

permissions:

contents: write

steps:

- uses: actions/checkout@v4

- uses: jamesgeorge007/github-activity-readme@master

env:

GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Nicolas Arbelaez

student•

Aquí hay otro proyecto mas actualizado por si les interesa. jamesgeorge007/github-activity-readme: Updates README with the recent GitHub activity of a user

Implementación:

name: Update README

on:
  schedule:
    - cron: '* */6 * * *'
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: write

    steps:
      - uses: actions/checkout@v3
      - uses: jamesgeorge007/github-activity-readme@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Yorgen Omar Marciales Parada

student•

GitHub Actions es una herramienta que permite automatizar tareas en tus proyectos de GitHub. Facilita la integración continua (CI) y la entrega continua (CD) al permitirte definir flujos de trabajo que se ejecutan en respuesta a eventos en tu repositorio, como pushes o pull requests. Puedes utilizar acciones predefinidas o crear las tuyas propias para realizar tareas como pruebas, despliegues y actualizaciones de documentación. ¡Es una excelente manera de optimizar tu flujo de trabajo y mejorar la colaboración en tus proyectos!

Samuel Soto Hoyos

student••

name: Update README

on:
  schedule:
    - cron: '*/12 * * * *'
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    name: Update Profile README
    steps:
      - uses: actions/checkout@v2.3.4
      - uses: Readme-Workflows/recent-activity@v2.4.1
      - env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Alexis Dorado Muñoz

student•

Gracias por tu aporte

Hugo Gonzalez

student•

En el video se muestra algo muy interesante: GITHUB_TOKEN es el único secreto que GitHub Actions proporciona por defecto, listo para usar, sin necesidad de configurarlo manualmente en la sección de secretos del repositorio.

Aquí dejo el enlace a la documentación con todas las variables de entorno disponibles en GitHub Actions: 🔗 https://docs.github.com/es/actions/reference/workflows-and-actions/variables

Eduardo Ruiz

student•

En mi caso, el error en Actions se mantuvo por lo que tuve que agregar lo siguiente en el archivo update_readme.yml:

permissions:

contents: write

¿Alguien más hizo esto?

Amin Espinoza

teacher•

Mmmmm extraño, no sé por qué podría ser pero que bueno que encontraste una solución!

Alexander Silvera

student•

No me aparecen los recursos de este curso, sería bueno que puedan arreglar este problema???

Amin Espinoza

teacher•

Aquí tienes: https://github.com/platzi/git-github

Ana Rotela Cabrera

student•

Utilice este .yml

name: Update README2

on:

schedule:

- cron: '0 */12 * * *' # Cada 12 horas

workflow_dispatch:

jobs:

build:

runs-on: ubuntu-latest

name: Update Profile README

steps:

- uses: actions/checkout@v2.3.4

- uses: Readme-Workflows/recent-activity@v2.4.1

env:

GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Kevin Gonzalez

student•

No hay el documento de workflow en los recursos.

Martin Paez

student•

Las reglas cambiaron un poco despues de unos años.

Este es el codigo que debemos agregar a nuestro archivo Readme:


\### :zap: Actividad reciente

\<!--START\_SECTION:activity-->

\<!--END\_SECTION:activity-->



\<!--RECENT\_ACTIVITY:start-->

\<!--RECENT\_ACTIVITY:last\_update-->

Archivo .yml para Github Actions:

on: schedule: - cron: "* */12 * * *" workflow_dispatch:

jobs: build: runs-on: ubuntu-latest name: Update Profile README permissions: contents: write

steps:
  - uses: actions/checkout@v4.2.2
  - uses: Readme-Workflows/recent-activity@main
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Gabriel Obregón

student•

💡Optimiza tu Perfil de GitHub con GitHub Actions

🧭 Propósito

Automatiza tu perfil para que siempre muestre tu actividad reciente. Con GitHub Actions, tu perfil se mantiene activo, profesional y actualizado sin esfuerzo.

⚙️ 1. Qué es GitHub Actions

🧩 Definición: Es una herramienta de GitHub que automatiza tareas y flujos de trabajo dentro de tus repositorios.

🔁 Permite automatizar:

🔒 Revisiones de seguridad → Dependabot.
🚀 Procesos CI/CD → Integración y despliegue continuos.
📢 Actualización automática del README del perfil.

✨ Ventaja: Demuestra tu constancia y evolución como desarrollador frente a la comunidad.

🗂️ 2. Configura tu Repositorio de Portada

🔹 Paso 1: Crea o abre el repositorio que tiene el mismo nombre que tu usuario.

🔹 Paso 2: Edita el archivo <u>README.md</u>.

🔹 Paso 3: Añade una sección para tu actividad reciente.

🔹 Paso 4: Personaliza el título. Ejemplos:

📈 Actividad reciente
💻 Últimos commits
⚡ Mi trabajo más reciente

💬 Esta será la zona donde GitHub Actions actualizará la información automáticamente.

🔄 3. Crea tu GitHub Action

👣 Pasos básicos:

Entra en la pestaña “Actions” de tu repositorio.
Selecciona una plantilla básica de flujo de trabajo.
Configura el archivo YAML con los siguientes elementos:

📁 Ruta del archivo: .github/workflows/update-readme.yml

🕒 Frecuencia (Cron Job): */12 * * * * → Actualiza tu README cada 12 horas.

🧰 Paso de checkout: Permite a la acción acceder a los archivos del repositorio.

⚡ Flujo de actividad reciente: Importa un flujo del GitHub Marketplace que extraiga tus últimos commits o contribuciones.

🧪 4. Comprueba que Funcione Correctamente

✅ 1. Ejecuta la acción: Haz un commit directo en la rama principal.

🧭 2. Verifica el estado:

🟢 Éxito: Todo funciona correctamente.
🔴 Error: GitHub resaltará el paso fallido.

🛠️ 3. Ajusta si es necesario: Corrige el archivo YAML o los comentarios del README y vuelve a ejecutar el flujo.

💬 Repite hasta que tu acción se ejecute sin errores.

🧰 5. Funciones Extra y Personalización

🚀 Explora el Marketplace: Encuentra acciones ya listas para:

🐳 Desplegar en Docker.
☕ Compilar proyectos en Java.
🧠 Automatizar tareas personalizadas.

🔐 Variables de entorno: Usa GITHUB_TOKEN para mantener tus acciones seguras y autenticadas.

🎨 Contenido adicional: Enriquece tu perfil con:

🔗 Enlaces a tu portafolio profesional.
▶️ Listas de tus videos de YouTube.
📂 Proyectos destacados o recientes.

🌟 6. Dale Estilo y Haz que Destaque

💡 Recomendaciones:

Inspírate en otros perfiles llamativos de GitHub.
Experimenta con archivos YAML descargados de ejemplo.
Ajusta la frecuencia, el diseño y el contenido para reflejar tu estilo.

🧠 Recuerda: tu perfil es más que un repositorio, es tu carta de presentación profesional.

SANTIAGO ALBERTO BOLIVAR CARDENAS.

student•

Que buen video, Gracias Profesor, Gracias Platzi.

Daniel Andres Rojas Paredes

student•

creo que esto es bastante genial pero amenos qe seas dev ops o prodct owner no vas a estar usando actions de manera constante en tu trabajo , me equivoco?

Amin Espinoza

teacher•

Bueno, eso depende, si hiciste un buen trabajo al principio del proyecto y lo configuraste todo bien entonces no, no las usarás todo el tiempo. La verdad es que a mi nunca me ha gustado decir que el rol de "DevOps" existe, eso no se trata de una sola posición, se trata de algo que todos como profesionales debemos saber y dominar.

Enrique Alexis Lopez Araujo

student•

Para crear un template básico de una GitHub Action on demand (es decir, que se ejecute al ser llamada y no mediante un cron) puedes usar workflow_dispatch, que permite iniciar el workflow manualmente. Aquí tienes un ejemplo básico:

name: My Manual Action

on:
  workflow_dispatch:
    inputs:
      example_input:
        description: 'Este es un ejemplo de input'
        required: true
        default: 'valor por defecto'

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Chequear código
        uses: actions/checkout@v2
      - name: Imprimir input
        run: echo "El input es: ${{ github.event.inputs.example_input }}"

Este template permite ejecutar la acción manualmente desde la interfaz de GitHub y pasar un input que puedes utilizar dentro de tu workflow.