Integración CI/CD

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

La integración de Capgo en tu pipeline de CI/CD te permite automatizar completamente el proceso de construcción y despliegue de actualizaciones de tu aplicación. Al aprovechar el Capgo CLI y semantic-release, puedes asegurar despliegues consistentes y confiables, y habilitar la iteración rápida.

Ventajas de la Integración de CI/CD

Automatización: Ya no hay pasos manuales ni espacio para errores humanos. Tu proceso de construcción, prueba y despliegue completo puede ser automatizado de principio a fin.
Consistencia: Cada despliegue sigue el mismo conjunto de pasos, asegurando un proceso predecible y repetible. Esto es especialmente valioso cuando tienes varios miembros del equipo contribuyendo code.
Iteraciones más rápidas: Con despliegues automatizados, puedes enviar actualizaciones con mayor frecuencia y con confianza. Ya no hay que esperar a la aprobación de QA o de lanzamiento manual.

Capgo CLI

La Capgo CLI es la clave para integrar Capgo en tu flujo de trabajo de CI/CD. Proporciona comandos para enviar nuevas versiones de paquetes, gestionar canales y más.

El comando más importante para la integración de CI/CD es bundle upload:

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY

Si utilizas cifrado, debes proporcionarlo de una de las siguientes maneras:

Usando la ruta del archivo de clave privada:

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-v2 PRIVATE_KEY_PATH

Usando el contenido de la clave privada directamente (recomendado para CI/CD):

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-data-v2 PRIVATE_KEY_CONTENT

Usando variables de entorno (recomendado para CI/CD):

npx @capgo/cli@latest bundle upload --channel Production --apikey YOUR_API_KEY --key-data-v2 "$CAPGO_PRIVATE_KEY"

Configuración de variables de entorno para la cifrado

Para entornos de CI/CD, se recomienda almacenar tu clave privada como una variable de entorno en lugar de un archivo. Aquí está cómo configurarlo:

Obtén el contenido de tu clave privada:
Ventana de terminal
```
cat .capgo_key_v2 | pbcopy
```
Esto copia el contenido de la clave a tu portapapeles.
Añádelo a tu entorno de CI/CD:
- GitHub Acciones: Agregar CAPGO_PRIVATE_KEY a los secretos de tu repositorio
- GitLab CI: Agregalo como una variable oculta en tus ajustes de proyecto
- CircleCI: Agregalo como una variable de entorno en tus ajustes de proyecto
- Jenkins: Agregalo como un credencial de texto secreto

Utilízalo en tu pipeline:

- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }} --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}"

Nota: La --key-data-v2 permite pasar el contenido de la clave privada directamente como una cadena de texto, lo que la hace ideal para variables de entorno en flujos de CI/CD donde no deseas crear archivos temporales.

Este comando sube la compilación web actual al canal especificado. Por lo general, ejecutas este comando como el último paso en tu flujo de CI/CD, después de que tu compilación web se haya completado con éxito.

Configuración de Capgo en tu flujo de CI/CD

Mientras que los pasos exactos variarán dependiendo de la herramienta de CI/CD que elijas, el proceso general para integrar Capgo se parece a esto:

Generar una API clave: Inicia sesión en la consola de Capgo y crea una nueva API clave. Esta clave se utilizará para autenticar el CLI en tu entorno de CI/CD. Manténla en secreto y nunca la comitas a tu repositorio!
Configurar el bundle upload comando: Agrega un paso a tu configuración de CI/CD que ejecute el bundle upload comando con los argumentos adecuados:
upload.yml
```
- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }}
```
\n Reemplaza Production con el canal que deseas desplegar a, ${{ secrets.CAPGO_API_KEY }} con la variable de entorno que contiene tu API clave, y agrega --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" si estás utilizando cifrado.

Agrega el upload paso después de tu compilación web: Asegúrate de que el upload paso se ejecute después de que tu compilación web haya finalizado con éxito. Esto garantiza que siempre estás desplegando tu última code.\n Aquí tienes un ejemplo de configuración para GitHub Actions:\n

name: Deploy to Capgo
 on:
  push:
   branches: [main]

jobs:
 deploy:
 runs-on: ubuntu-latest

 steps:
 - uses: actions/checkout@v6
 - uses: actions/setup-node@v6
  with:
   node-version: '24'

 - run: npm ci
 - run: npm run build

 - run: npm install -g @capgo/cli
 - run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }} --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}"

Gestión de versiones con Semantic-release

La forma recomendada de manejar la versión con Capgo es establecer la versión en tu archivo importándola desde capacitor.config.ts Copiar al portapapeles package.json:

import pkg from './package.json'

const config: CapacitorConfig = {
  // ... other config
  plugins: {
    CapacitorUpdater: {
      version: pkg.version,
    }
  }
}

Usar semantic-release (o cualquier otra herramienta) para actualizar la

versión package.json Construir tu aplicación con la versión actualizada automáticamente incluida
Subir el paquete con la versión correcta
Tu flujo de trabajo CI/CD sería como este:

Copiar al portapapeles

- run: npm ci
- run: npx semantic-release  # Updates package.json version
- run: npm run build         # Builds with new version from capacitor.config
- run: npx @capgo/cli@latest bundle upload --channel=production --apikey=${{ secrets.CAPGO_API_KEY }}

Aquí tienes un archivo de configuración de ejemplo para semantic-release: .releaserc Copiar a portapapeles

{
  "branches": [
    "main",
    {
      "name": "beta",
      "prerelease": true
    }
  ],
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    "@semantic-release/changelog",
    [
      "@semantic-release/git",
      {
        "assets": ["CHANGELOG.md", "package.json"],
        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
      }
    ]
  ]
}

Analiza los mensajes de commit para determinar el número de versión siguiente, siguiendo la especificación de Conventional Commits.

Genera notas de lanzamiento basadas en los commits desde la última versión.
Actualiza el archivo con las nuevas notas de lanzamiento.
Actualiza la versión, que será recogida por tu __CAPGO_KEEP_0__.config. CHANGELOG.md Comitea los archivos actualizados, y cualquier otro archivo modificado, de vuelta a la repositorio.
Genera notas de lanzamiento basadas en los commits desde la última versión. package.json version, which will be picked up by your capacitor.config.
Actualiza la versión, que será recogida por tu __CAPGO_KEEP_0__.config. CHANGELOG.md, package.jsonComitea los archivos actualizados, y cualquier otro archivo modificado, de vuelta a la repositorio.

Asegúrese de ejecutar semantic-release antes de construir su aplicación para que la versión actualizada de package.json se incluya en su construcción a través de capacitor.config.

Auto-bump cuando la versión local ya está en Capgo

Los nombres de los paquetes deben ser únicos (las versiones eliminadas ocupan aún su nombre). Si el CI sigue subiendo la misma package.json versión, la subida falla. Prefiera aumentar package.json (por ejemplo con semantic-release). Cuando eso no es práctico, déjelo que CLI elija la siguiente versión semver libre del canal vinculado al paquete, o de lo contrario la última versión remota de la aplicación:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

--auto-bump ai usa Capgo Cloudflare Workers AI para comparar los archivos de paquete locales con el delta de manifest de canal anterior Capgo, elige major | minor | patch | metadatay imprime una breve razón. Sin versión anterior Capgo, se omite el AI y el aumento es patch.

no combine --auto-bump con --bundle / -b. Consulte la bundle upload referencia para obtener la lista completa de opciones.

Resolución de problemas

If you encounter issues with your Capgo CI/CD integration, here are a few things to check:

Si encuentra problemas con la integración de CI/CD de su API aquí hay algunas cosas que verificar:API clave
: Asegúrese de que su CLI clave sea válida y tenga los permisos necesarios. Si utiliza una variable de entorno, compruebe que está configurada correctamente.Capgo versión de CLI
Artículos de compilación: Asegúrese de que su compilación web está generando los archivos de salida esperados. Los Capgo CLI necesitan una compilación web válida para crear un paquete.
Conectividad de red: Verifique que su entorno de CI/CD tenga acceso a Internet a los servidores Capgo. Problemas con los firewalls o los proxies pueden interferir con el upload comando.

Si sigue teniendo problemas, póngase en contacto con el soporte de Capgo para obtener asistencia. Pueden ayudarlo a depurar cualquier problema con su configuración específica.

Conclusión

Integrar Capgo en su pipeline de CI/CD con un manejo de versiones adecuado puede simplificar significativamente su flujo de trabajo de desarrollo. Al automatizar sus despliegues y versionar a través del enfoque de capacitor.config, puede enviar actualizaciones más rápido y con más confianza.

El enfoque recomendado de establecer la versión en su capacitor.config.ts archivo y utilizar semantic-release para actualizar package.json proporciona un proceso de despliegue robusto y confiable que le permite enfocarse en crear características excelentes en lugar de preocuparse por los pasos de liberación manuales.

Para obtener más detalles sobre los comandos y opciones de Capgo CLI, consulte la CLI referencia. Y para una exploración más profunda de la configuración de semantic-release, consulte los documentos de semantic-release.

¡Feliz despliegue!

Sigue adelante desde la integración CI/CD

Si estás utilizando Integración CI/CD context: Página/área: Capgo Builder / producto de construcción nativa en la nube. Rol: Etiqueta de IU corta o elemento de navegación. Clave de mensaje `native_build_feature_ci_cd` (Native Build Feature Ci Cd). Capgo CI/CD Capgo integración CI/CD para el flujo de trabajo del producto en Capgo integración CI/CD, Capgo Compilaciones nativas para el flujo de trabajo del producto en Capgo Compilaciones nativas, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones, GitHub Integración de Acciones para el detalle de implementación en GitHub Integración de Acciones, y Integración CI/CD de GitLab para el detalle de implementación en Integración CI/CD de GitLab.