Guía: integración de Capgo con GitHub Actions

Capgo y Acciones de GitHub juntos simplifican el despliegue de actualizaciones para Capacitor apps. Aquí te contamos por qué esta integración merece tu atención:

• Ahorra dinero: Reduce costos de CI/CD hasta $26,100 en 5 años frente a AppFlow.
• Actualizaciones rápidas: Lanza updates al instante; el 95% de los usuarios los recibe en 24 horas.
• Despliegues seguros: El cifrado de extremo a extremo garantiza la seguridad de los updates.
• Workflow optimizado: Automatiza builds y deployments directo en tu repositorio de GitHub.

Resumen rápido

1. Requisitos: cuenta de GitHub, cuenta de Capgo (desde $12/mes), proyecto Capacitor, Node.js.
2. Configuración: Instala Capgo CLI con npx @capgo/cli init, configura GitHub Actions con un workflow YAML.
3. Despliegue: Usa comandos como npx @capgo/cli deploy a automatiza updates.
4. Pruebas: Despliega en canales de prueba (ej. beta, staging) antes de producción.

Ejemplo de Workflow (YAML):

name: Capgo Deploy  
on:  
  push:  
    branches:  
      - main  

jobs:  
  deploy:  
    runs-on: ubuntu-latest  
    steps:  
      - uses: actions/checkout@v6  
      - uses: actions/setup-node@v3  
        with:  
          node-version: '24'  
      - name: Install Dependencies  
        run: npm install  
      - name: Deploy to Capgo  
        run: npx @capgo/cli deploy  
        env:  
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}  

Esta integración garantiza actualizaciones de apps rápidas, seguras y económicas, ideal para equipos de desarrollo ágil.

Acciones de GitHub Tutorial - Conceptos básicos y pipeline de CI/CD

Requisitos de configuración

Integración de Capgo con GitHub Actions requiere configurar las herramientas y la configuración necesarias.

Herramientas y cuentas necesarias

Asegúrate de tener listas las siguientes cuentas y herramientas:

Una vez configurado esto, puedes añadir Capgo a tu proyecto para automatizar los Live Updates.

Añadir Capgo a tu proyecto

Para integrar Capgo, instálalo en tu proyecto Capacitor usando su herramienta CLI. Según Martin Donadieu, fundador de Capgo:

“¡Ejecuta npx @capgo/cli init y listo!” [1]

Este comando configurará el plugin y sus dependencias necesarias.

Configuración del repositorio GitHub

Prepara tu repositorio GitHub para cumplir con los requisitos de integración CI/CD con Capgo.

Antes de añadir el workflow, confirma que el repositorio tenga los secrets, las protecciones de rama y los triggers de despliegue necesarios para tu proceso de release OTA.

Precios

• Los planes de Capgo empiezan en $12/mes.
• El mismo plan incluye actualizaciones OTA y unos 15 native builds al mes.
• Los minutos de build extra se facturan por minuto mediante créditos.

Así es como puedes configurar tu repositorio:

• Estructura del repositorio: Organiza tu repositorio con directorios separados para el code fuente, assets y archivos de configuración para mantener todo limpio y manejable.
• Configuración del entorno: Crea entornos distintos para development, staging y production, asegurando que existan los controles de acceso y medidas de seguridad adecuados.
• Gestión de accesos: Configura los permisos del repositorio con cuidado para permitir integración de Capgo manteniendo la seguridad.

Estos pasos asegurarán que tu proyecto esté listo para el workflow de GitHub Actions, que detallaremos en la siguiente sección.

Configuración del Workflow de GitHub Actions

Automatiza tus deployments de Capgo usando GitHub Actions para optimizar tu proceso de CI/CD.

Creación del archivo del Workflow

Empieza creando un archivo YAML en el .github/workflows directorio de tu repositorio. Aquí tienes un ejemplo:

name: Capgo Deploy
on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v3
        with:
          node-version: '24'
      - name: Install Dependencies
        run: npm install
      - name: Build App
        run: npm run build
      - name: Deploy to Capgo
        run: npx @capgo/cli deploy
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Esta configuración garantiza despliegues seguros y automatizados. Una vez configurado el archivo, elige los triggers adecuados para tu workflow.

Opciones de triggers del workflow

GitHub Actions te permite personalizar cuándo se ejecutan los workflows. Aquí tienes algunas opciones de triggers:

Gestión de claves secretas

Para garantizar despliegues seguros, debes gestionar tus claves secretas correctamente. GitHub Actions ofrece un sistema de gestión de secretos cifrados para este propósito.

Pasos para configurar la autenticación segura:

1. Acceder a la configuración del repositorio
   Ve a la configuración de tu repositorio y busca la sección “Secrets and variables” bajo la pestaña “Security”.

2. Añadir Credenciales de Capgo
   Guarda tu token de autenticación de Capgo como un secret del repositorio. Nómbralo CAPGO_TOKEN.

3. Referenciar secrets en workflows
   Usa tus secrets almacenados en el workflow referenciándolos de esta forma: ${{ secrets.CAPGO_TOKEN }}.

Comandos de Capgo en workflows

Una vez configurado tu entorno de GitHub Actions, puedes automatizar despliegues integrando comandos de Capgo CLI.

Instalación de Capgo CLI

Añade el siguiente paso a tu workflow para instalar Capgo CLI:

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Initialize Capgo
    run: npx @capgo/cli init

Autenticación de CLI

Autentica CLI de forma segura usando CAPGO_TOKEN:

- name: Authenticate Capgo CLI
  run: npx @capgo/cli login
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Comandos de despliegue

Estos son los comandos clave para el build, versionado y despliegue de tus updates:

Para automatizar todo el proceso de despliegue, usa los comandos juntos así:

steps:
  - name: Build and Deploy
    run: |
      npx @capgo/cli build
      npx @capgo/cli version ${{ github.ref_name }}
      npx @capgo/cli deploy
    env:
      CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Esta configuración garantiza que tus actualizaciones se construyan, versionen y desplieguen automáticamente cada vez que se ejecute el workflow. El sistema de gestión de secretos de GitHub mantiene tus credenciales seguras en todo momento.

Testing y correcciones

Ejecución de workflows de prueba

Puedes probar tu workflow de GitHub Actions usando un canal de pruebas de Capgo. Esto te permite validar las actualizaciones antes de lanzarlas.

- name: Test Build Deployment
  run: |
    npx @capgo/cli build
    npx @capgo/cli deploy --channel beta
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

El sistema de canales de Capgo te permite crear rutas de despliegue separadas para cada etapa:

Solución de errores

Aquí tienes algunos problemas comunes de integración y cómo resolverlos:

1. Fallos de autenticación

Revisa el CAPGO_TOKEN en GitHub Secrets. Si ha expirado, regeneralo para asegurar una autenticación fluida.

2. Errores de build

Asegúrate de que tu configuración de build cumpla con los requisitos de tu entorno de despliegue.

“Implementamos las actualizaciones OTA de Capgo en producción para nuestra base de más de 5000 usuarios. El funcionamiento es muy fluido; casi todos nuestros usuarios están al día a los pocos minutos de desplegar la actualización OTA en @Capgo.” [1]

3. Conflictos de versión

Usa versionado semántico e incrementa las versiones correctamente para evitar conflictos durante los despliegues.

Consejos de mantenimiento

• Usa analytics de Capgo para monitorear la tasa de éxito de las actualizaciones.
• Activa rollbacks automáticos para actualizaciones con errores.
• Prueba los pull requests (PRs) usando selectores de canal.
• Mantén tu workflow al día con los últimos comandos de Capgo CLI.

Para despliegues críticos, aprovecha el error tracking de Capgo para detectar problemas pronto. Si algo falla, el rollback te permite volver a una versión estable rápidamente, minimizando interrupciones. Estas prácticas ayudarán a que tus despliegues fluyan sin problemas hacia producción.

Conclusión

Puntos clave

La integración de Capgo con GitHub Actions simplifica el despliegue de apps de Capacitor, aportando grandes beneficios a los equipos de desarrollo. Con una tasa de éxito global del 82% en las actualizaciones y un 95% de usuarios activos recibiéndolas en menos de 24 horas [1], esta solución destaca por su eficiencia.

Estas son algunas características destacadas:

• Workflows automatizados: Al configurar los workflows directamente en GitHub Actions, no necesitas hosting de CI/CD externo. Esto reduce costes operativos, ahorrando unos 26.100 $ en cinco años frente a alternativas como AppFlow [1].
• Despliegue rápido: Las actualizaciones se pueden lanzar al instante, evitando los retrasos de las app stores.
• Seguridad robusta: El cifrado de extremo a extremo garantiza entregas seguras, mientras que el sistema de canales de Capgo permite rollouts controlados y por etapas.

Estas funciones permiten crear soluciones más personalizadas y mejorar el rendimiento, como veremos a continuación.

Estrategias avanzadas

Para sacar el máximo partido a tu integración de Capgo y GitHub Actions, explora estas tácticas avanzadas:

• Workflows de API personalizados: Usa la API pública de Capgo para diseñar workflows de despliegue que se adapten a las necesidades de tu equipo. Esto permite experiencias white-label e integración fluida con tus herramientas actuales. [1].
• Lanzamientos basados en canales: Optimiza tu proceso de despliegue usando las funciones de canales de Capgo para actualizaciones escalonadas y controladas.
• Rendimiento optimizado: Aprovecha las actualizaciones parciales de Capgo para reducir el ancho de banda y acelerar las actualizaciones. Con 23.5 millones de actualizaciones entregadas en 750 apps en producción [1], el sistema ha demostrado su capacidad para manejar demandas a gran escala.

Para mejores resultados, considera las opciones de self-hosting de Capgo o configuraciones de API personalizadas. Revisa las secciones anteriores para ver instrucciones detalladas de configuración y testing para implementar estas estrategias.

Continuar desde Integración de Capgo con GitHub Actions: Guía

Si estás usando Guía: integración de Capgo con GitHub Actions para planificar la seguridad y el cumplimiento, conéctalo con Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security, y Centro de confianza de Capgo para el flujo de trabajo del producto en Capgo Trust Center.