# CI/CD con GitHub

Una de las ventajas de trabajar con los Widgets de manera local usando el CLI de Modyo (modyo-cli) es que se puede hacer uso de herramientas para automatizar la revisión de código (CI) y hacer entrega continua o despliegue continuo (CD)

Los Widgets del catalogo, asi como los templates base para iniciar un nuevo proyecto, traen "recetas" de GitHub Actions (opens new window) que puedes utilizar para ejecutar algunas de las tareas mas comunes de CI/CD de manera rápida y sencilla.

Estas "recetas" están en el archivo README.md que se encuentra en la carpeta .GitHub del Widget.

 



 





├── .GitHub/
│   ├── pr-labeler.yml
│   ├── release-drafter.yml
│   └── workflows/
│       ├── Readme.md   <- * recetas * ->
│       ├── pr-labeler.yml
│       └── release-draft.yml
├── src/
│   ├── App.vue

Las recetas que pueden encontrar son:

  • Build and publish to modyo
  • Run ESLint, Stylelint and Unit Tests on pull requests
  • Publish package on GitHub registry
  • Release draft
  • Release drafter config
  • PR Labeler
  • PR Labeler config

TIP

Cada una de éstas esta documentada y explicada en el archivo README.md

# Despliegue de un Widget con GitHub Actions

Para poder cargar un Widget utilizando GitHub Actions necesitamos la "receta" Build and Publish que hace uso del comando PUSH del Modyo CLI y para eso necesitamos un token que de autorización para hacerlo.

Para obtener un token primero tenemos que crear un API Access a nivel de la cuenta dueña del sitio. Vamos a Settings (1) --> API access (2) --> Nuevo API access (3) --> Crear (4).

1

Después de crear el API access tenemos que generar un token para el usuario que va a cargar el Widget.

TIP

Recomendamos crear un nuevo usuario que tenga permisos y el token para cargar y publicar Widgets desde un servicio de CI/CD.

Nuevamente a nivel de cuenta:

  1. Settings
  2. Team (seleccionamos o creamos un usuario)
  3. Pestaña API access
  4. Seleccionamos el Api access que creamos anteriormente
  5. Crear Token

2

Ahora tenemos el token podemos usarlo para configurar nuestro repositorio y asi la acción de GitHub tendrá acceso a éste.

2

IMPORTANTE

¡Nunca deber compartir ni publicar el TOKEN o información sensible en el repositorio! Por eso se recomienda utilizar variables de entorno, archivo .env que esta listado en el .gitignore del proyecto, de manera local y hacer uso de los secrets (opens new window) en GitHub.