GitHub Actions permite automatizar procesos en GitHub mediante flujos de trabajo (workflows) que se activan por eventos como commits o pull requests. Los workflows contienen jobs que ejecutan acciones como compilar y probar código. Las acciones se ejecutan en máquinas virtuales (runners) alojadas por GitHub o en la nube. El documento muestra cómo configurar workflows para proyectos Xamarin utilizando contextos, secretos y expresiones para acceder a información del repositorio.

1. CI/CD for Xamarin
developers with GitHub
Actions and AppCenter
Luis Beltrán
@darkicebeam

2. Agenda
• ¿Qué es GitHub Actions?
• Workflows & Events
• Jobs
• Context & Expressions
• Secrets
• Referenciando acciones
• Xamarin & GitHub Actions
• Demo
• Precio
• Recursos

3. ¿Qué es GitHub Actions?

4. GitHub Actions
GitHub Actions es una herramienta que permite la integración continua (CI) y una amplia gama de
automatización dentro de GitHub, de manera que puedes construir, probar e implementar tu código
directamente desde GitHub.
Similar a otros sistemas de CI como Travis CI y Circle CI, GitHub Actions utiliza el lenguaje de marcado
YAML.
Además de activarse por pull requests y commits, las acciones permiten responder a cualquier
evento de GitHub. Te permite activar ciertos workflows (flujos de trabajo) basados en:
• la creación de issues
• comentarios
• la incorporación de un nuevo miembro al repositorio
• cambios en el GitHub project board.
https://github.com/features/actions

6. GitHub Actions:
• Automatiza GitHub. Una acción es un conjunto
de instrucciones que te permiten automatizar
procesos de GitHub.
• Es desencadenado por eventos. Las acciones se
ejecutan como resultado de un evento de GitHub
(hacer un push, crear un issue, hacer pull, etc. se
puede ejecutar una automatización basada en
dichos eventos).
• Está integrado por completo en GitHub. Las
acciones están integradas y se ejecutan dentro
de los servidores de GitHub, por lo que no se
require de una plataforma distinta de CI/CD para
realizar tareas simples o complejas.
Implementa en
• AWS
• Azure
• Netlify
• etc
Publica artefactos
• npm
• Maven Central
• etc
Cualquier lenguaje
• Node .js
• Python
• Java
• Ruby
• PHP
• Go
• Rust
• .NET
• … y más!

7. Workflows & Events

8. Workflows
Las acciones son construidas creando uno o más archivos de workflow.
Workflows son procesos personalizados y automatizados que puedes establecer en tu repositorio para construir,
probar, empaquetar, liberar o implementar cualquier proyecto de código en GitHub.
Son multiplataforma. Se ejecutan en Linux, macOS, Windows y contenedores en equipos hospedados por GitHub,
llamados “runners”, aunque también puedes hospedar tus runners para ejecutar workflows en tus propios
equipos.
Puedes crear matrices de workflows
para ejecución simultánea en varias
plataformas.

9. Workflows
Para crear un workflow:
• Genera un archivo con extensión .yml en la ruta .github/workflows (si lo haces desde el portal seleccionando
Actions, automáticamente se genera la ruta)
• Por supuesto, el contenido del archivo debe estar en formato YAML.
• Puedes crear un workflow desde cero o basarte en una plantilla (template).
Puedes tener hasta 20 workflows por repositorio.
Cada workflow puede tener uno o más jobs, y cada job puede estar ligado a un evento o ventana de tiempo
especificada en el workflow.

12. Tipos de eventos
• Workflows: Los más comunes (push, pull_request, fork,
etc) que se relacionan con cambios en el repositorio.
• Webhooks: GitHub realizará una acción cuando ocurra
un evento de tipo webhook, como cuando alguien marca
tu repositorio con una estrella o cuando una página de
wiki es creada/editada.
https://docs.github.com/es/actions/reference/events-that-trigger-workflows

13. Tipos de eventos
• Programados: Permite definir cuando o con qué frecuencia un
evento se realizará por medio de una sintaxis cron (ejemplo, 15
3 * * 1-5 significa 3:15 am de lunes a viernes).
• Manuales: Son eventos desencadenados bajo demanda que
utilizan el evento workflow_dispatch, incluso se pueden
desencadenar más flujos y crear eventos personalizados
mediante el evento repository_dispatch.
https://docs.github.com/es/actions/reference/events-that-trigger-workflows

14. Especificadores
• Sencillo o múltiple: Puedes ejecutar un workflow
basado en un solo evento o tener una lista de
eventos que desencadenan el workflow (por
ejemplo, que se desencadene cuando ocurra un
push o un pull_request).
• Tipos: Algunos eventos admiten condiciones a ser
evaluadas cuando el evento ocurre, por ejemplo
solo desencadenar las acciones si ocurre un
pull_request que está siendo cerrado.
• Ejecución: Cuando un workflow se ejecuta, una o
más acciones son resueltas (ejecutan dependencias).
Si una acción falla, no se ejecutan las demás
acciones subsecuentes.

15. Jobs

16. Jobs
Aunque solo puedes ejecutar 20 workflows por repositorio, puedes
incluir uno o más jobs en cada workflow.
En un workflow, cada job es identificado por un ID label.
El cual debe ser un nombre único, comenzar por letra o guión bajo y
solo puede contener caracteres alfanuméricos, guión o guión bajo.
Ejecución de jobs:
• Se ejecutan en paralelo a menos que se indique lo contrario (por
ejemplo, se puede pedir a un job que espere a que otro finalice por
medio del atributo needs).
• Se puede indicar que un job se ejecute en distintas máquinas o en
un arreglo de equipos por medio del atributo run-os.
• ubuntu-latest, ubuntu-18.04, ubuntu-16.04
• windows-latest, windows-2019, windows-2016
• macOS-latest, macOS-10.14

17. runs
Especifica qué comando ejecutar en el contenedor Docker
args
Especifica los parámetros a adjuntar en el comando run
env
Permite configurar variables de entorno en los contenedores y que estarán
disponibles en cada job. Si deseas utilizar variables de entorno en más de
un job, debes colocarlas en el mismo nivel que el objeto jobs.
Opciones de un Job
needs
Especifica dependencias, encadena acciones para formar un pipeline.

18. if
El job solo se ejecutará si se cumplen ciertas condiciones
steps
Especifica la lista de tareas que realizará el job
Opciones de un Job

19. Context & Expressions

20. Contexts
github
La información más importante acerca de tu repositorio está almacenada
dentro de un objeto github
job, steps
También es possible acceder a información sobre los jobs actuales y los
pasos que puedes utilizar en cada job
secrets
Un contexto útil para acceder a información almacenada en GitHub que no
puede ser vista por otros.
strategy, matrix, runner
Son contextos poco utilizados, pero que incluyen el acceso a:
• Los parámetros de estrategia configurados (fail-fast, job-index, job-
total y max-parallel)
• Los parámetros de matriz configurada para el job actual (os, node)
• Información sobre el runner que está realizando el job actual.

21. Expressions
Los jobs tienen una sintaxis especial de expresiones, las cuales utilizan el
signo $ seguido de una expresión contenida entre {{ }}.
La expresión puede contener todo tipo de elementos, incluyendo
literales, operadores y funciones.
https://docs.github.com/es/actions/reference/context-and-expression-syntax-for-github-actions

22. Secrets

23. Secrets
GitHub permite inyectar secretos como variables de entorno.
Settings > Secrets
Se crean por medio de la interfaz web accediendo a las settings del proyecto.
Escribe una vez
Se almacenan encriptados (no contraseñas de texto plano) en el repositorio.
Se pueden almacenar hasta 100 secretos en tus repositorios y deben tener un nombre único.
No pueden ser impresos.
Una vez escrito, no se puede ver su contenido por razones de seguridad.

25. Xamarin & GitHub Actions
Demo

26. Precio

27. https://docs.github.com/es/github/setting-up-and-managing-
billing-and-payments-on-github/about-billing-for-github-
actions

28. Si tu uso de cuenta sobrepasa los límites y habías configurado un límite de gastos mayor a $0, pagarás:
• $0.25 USD por GB de almacenamiento por mes
• y una tasa por minuto de uso dependiendo en el sistema operativo que utilice el ejecutor hospedado en GitHub.
• GitHub redondea hacia arriba los minutos que utiliza cada job.

29. Recursos

30. Para aprender más…
GitHub Actions https://github.com/features/actions
Documentación de GitHub Actions https://docs.github.com/es/actions
Sintaxis https://docs.github.com/es/actions/reference/workflow-syntax-for-github-actions
Colección de GitHub Actions https://github.com/actions
Awesome Actions https://github.com/sdras/awesome-actions
Ejecuta GitHub Actions localmente con act https://github.com/nektos/act
Marketplace de GitHub Actions https://github.com/marketplace?type=actions
GitHub Actions Advent Calendar
https://edwardthomson.com/blog/github_actions_advent_calendar.html

31. Q & A

32. ¡Muchas gracias por tu
atención!
Luis Beltrán
Tomás Bata University in Zlín
Tecnológico Nacional de México en Celaya
About Me:
https://about.me/luis-beltran