Integración de CI/CD

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

Integrando 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 asegurarte de que los despliegues sean consistentes y fiables y permitir 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.

Capgo CLI

El 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.

La orden más importante para la integración CI/CD es bundle upload:

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

Si utiliza cifrado, debe 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 (buena práctica 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 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: Añadir CAPGO_PRIVATE_KEY a tus secretos de repositorio
- GitLab CI: Agregue como una variable oculta en sus ajustes de proyecto
- CircleCI: Agregue como una variable de entorno en sus ajustes de proyecto
- Jenkins: Agregue como un texto de credencial secreta

Use it in your 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 bandera permite pasar el contenido de la llave privada directamente como una cadena de texto, lo que la hace perfecta para variables de entorno en pipelines CI/CD donde no se quiere crear archivos temporales.

Este comando sube la compilación web actual al canal especificado. Generalmente ejecuta esto como el último paso en su pipeline CI/CD, después de que la compilación web se haya completado con éxito.

Configurando Capgo en tu pipeline 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:

Genera 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!
Configura 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 }}
```
Reemplazar Production con el canal al que deseas desplegar ${{ secrets.CAPGO_API_KEY }} con la variable de entorno que contiene tu clave API, y agregar --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 step comes after your web build has completed successfully. This ensures you’re always deploying your latest code.\n Here’s an example configuration for 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 }}"

Copiar a portapapeles

The recommended way to handle versioning with Capgo is to set the version in your capacitor.config.ts archivo importándolo desde package.json:

import pkg from './package.json'

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

Esta aproximación te permite:

Usar semantic-release (o cualquier otra herramienta) para actualizar el package.json versión
Construye tu aplicación con la versión actualizada automáticamente incluida
Sube el paquete con la versión correcta

Tu flujo de trabajo de CI/CD sería como sigue:

- 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}"
      }
    ]
  ]
}

Esta configuración realiza lo siguiente:

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. CHANGELOG.md Actualiza la versión, que será capturada por tu __CAPGO_KEEP_0__.config.
Comitea los archivos actualizados, así como cualquier otro archivo modificado, de vuelta a la repositorio. package.json Asegúrate de ejecutar semantic-release antes de compilar tu aplicación para que la versión actualizada de capacitor.config. se incluya en tu build.
Solución de problemas CHANGELOG.md, package.jsonAsegúrate de ejecutar semantic-release antes de compilar tu aplicación para que la versión actualizada de __CAPGO_KEEP_0__.config. se incluya en tu build.

Solución de problemas package.json Asegúrate de ejecutar semantic-release antes de compilar tu aplicación para que la versión actualizada de capacitor.config. se incluya en tu build.

Solución de problemas

Si encuentra problemas con su Capgo integración de CI/CD, aquí hay algunas cosas que verificar:

API clave: Asegúrese de que su API clave sea válida y tenga los permisos necesarios. Si utiliza una variable de entorno, compruebe que está configurada correctamente.
CLI versión: Asegúrese de que esté utilizando la última versión del Capgo CLI. Las versiones antiguas pueden tener problemas de compatibilidad o faltarle ciertas características.
Artículos de compilación: Confirme que su compilación web está generando los archivos de salida esperados. El Capgo CLI necesita 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 de Capgo. Problemas con los firewalls o los proxies pueden interferir con el comando. upload Si sigue teniendo problemas, póngase en contacto con el __CAPGO_KEEP_0__ soporte para obtener asistencia. Pueden ayudarlo a resolver problemas con su configuración específica.

If you’re still having trouble, reach out to Capgo support for assistance. They can help troubleshoot any issues with your specific setup.

Conclusion

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

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

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

¡Feliz despliegue!

Sigue adelante desde la Integración de CI/CD

Si estás utilizando Integración CI/CD para planificar la automatización de CI/CD, conecta con 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 Integración de CI/CD de GitLab para los detalles de implementación en la Integración de CI/CD de GitLab.