Capacitor CI/CD パイプライン設定ガイド

Vuoi aggiornamenti delle app più veloci con il minimo sforzo? Configurare una pipeline CI/CD per la tua app Capacitor automatizza la build, il testing e il deployment, risparmiando tempo e riducendo gli errori. Ecco cosa otterrai:

Aggiornamenti Live: Distribuisci aggiornamenti istantaneamente senza i ritardi degli app store. Il 95% degli utenti riceve gli aggiornamenti entro 24 ore.
Pipeline Essenziali: Automatizza le build attivate dall’attività dei branch (main, staging, feature/*) e definisci ambienti separati per staging e produzione.
Integrazione Capgo: Usa Capgo per distribuire aggiornamenti sicuri e criptati, gestire i canali di aggiornamento e monitorare le prestazioni.
Piani Convenienti: I piani partono da $12/mese per aggiornamenti live e analytics.

Le pipeline CI/CD di Capacitor semplificano i flussi di lavoro, migliorano l’efficienza e assicurano che la tua app rimanga aggiornata senza problemi. Entriamo nei dettagli.

Requisiti di Setup

Prerequisiti

Assicurati di avere installato e configurato:

Node.js LTS, Capacitor CLI e Git
Un account sulla piattaforma CI preferita (come GitHub Actions, GitLab CI o Jenkins)
Un account Capgo per gestire gli aggiornamenti live

Una volta pronti questi elementi, procedi a definire i trigger e gli step di build nella tua piattaforma CI.

Integra Appflow con la tua Pipeline CICD

Passaggi per il Setup della Pipeline

Ora che hai gestito i prerequisiti, è il momento di configurare i trigger della pipeline e le impostazioni dell’ambiente.

Trigger e Step di Build

Configura la tua pipeline CI/CD per attivare automaticamente le build in base a specifiche attività dei branch. Ecco come configurarla:

Trigger dei branch:
- Usa main per le build di produzione.
- Usa staging per i test.
- Usa feature/* per lo sviluppo.
Step di build:
- Installa tutte le dipendenze necessarie.
- Esegui i test unitari per garantire la qualità del codice.
- Compila gli asset web per l’applicazione.
- Genera i binari nativi per piattaforme mobile o desktop.
- Distribuisci la build nel tuo ambiente di test per ulteriori validazioni.

Impostazioni dell’Ambiente

Definisci file di configurazione separati per staging e produzione per mantenere l’organizzazione e la sicurezza. Ecco un esempio di setup:

ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

Per i dati sensibili come chiavi API e certificati, assicurati di memorizzarli in modo sicuro nel sistema di gestione dei segreti della tua piattaforma CI. Questo garantisce che la tua pipeline rimanga sia funzionale che sicura.

Guida all’Integrazione di Capgo

Capgo

Una volta configurate le fasi di build e deploy, è il momento di integrare Capgo. Questo ti permette di distribuire aggiornamenti live direttamente alla tua app, evitando i ritardi di approvazione degli app store.

Passaggi per il Setup di Capgo

Dopo aver preparato la tua pipeline CI/CD, segui questi passaggi per aggiungere Capgo al tuo progetto:

Prima, installa la Capgo CLI:

npx @capgo/cli init

Quindi, procedi con questi comandi:

Compila la tua app: npm install && npm run build
Distribuisci gli aggiornamenti: npx @capgo/cli deploy
Ripristina gli aggiornamenti: npx @capgo/cli rollback

Ecco un esempio di un job GitHub Actions per la distribuzione degli aggiornamenti:

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Caratteristiche Principali di Capgo

Capgo porta diversi benefici alle app Capacitor, tra cui:

Aggiornamenti sicuri ed efficienti: Aggiornamenti differenziali criptati riducono le dimensioni del payload garantendo una distribuzione sicura.
Gestione dei canali: Crea canali di staging e produzione per controllare come vengono distribuiti gli aggiornamenti.
Dashboard analytics: Traccia i tassi di successo degli aggiornamenti e monitora l’adozione degli utenti con insight dettagliati.

Piani e Prezzi di Capgo

Capgo offre piani flessibili per diverse esigenze:

SOLO: $12/mese (1.000 MAU, 2 GB storage, 50 GB bandwidth)
MAKER: $33/mese (10.000 MAU, 5 GB storage, 500 GB bandwidth)
TEAM: $83/mese (100.000 MAU, 10 GB storage, 2.000 GB bandwidth)
PAYG: A partire da $249/mese, con opzioni per scaling personalizzato, accesso API e domini personalizzati.

Attualmente, Capgo supporta oltre 1.900 app in produzione, rendendolo una scelta affidabile per il continuous deployment [1].

Gestione della Pipeline

Monitoraggio dello Stato

Tenere sotto controllo la tua pipeline è fondamentale per mantenere la qualità dell’app e la soddisfazione degli utenti. Usa la tua piattaforma CI/CD per configurare avvisi automatici per:

Stato della build e progresso del deployment
Tassi di successo degli aggiornamenti
Metriche di adozione degli utenti
Report di errori e log di crash

Abbina questi avvisi a una documentazione chiara per garantire un monitoraggio fluido e una rapida risoluzione dei problemi.

Guida alla Documentazione

Una buona documentazione mantiene il tuo team allineato e le tue operazioni fluide. Assicurati che la tua documentazione copra:

Configurazione Pipeline: Dettagli come trigger di build, variabili d’ambiente e impostazioni di sicurezza.
Procedure di Aggiornamento: Passaggi per i deployment, istruzioni di rollback e gestione dei canali di aggiornamento.
Setup del Monitoraggio: Come configurare gli avvisi, tracciare le metriche e rispondere ai problemi.
Linee Guida di Conformità: Regole specifiche della piattaforma, restrizioni sugli aggiornamenti e altri requisiti.

Conserva tutta la documentazione nel controllo versione e aggiornala ogni volta che la tua pipeline cambia. Includi passaggi di troubleshooting per errori comuni per risparmiare tempo quando sorgono problemi.

Linee Guida della Piattaforma

Segui le politiche di aggiornamento di Apple e Android utilizzando il sistema di canali di Capgo per garantire rollout fluidi e conformi:

Beta Testing: Rilascia aggiornamenti a piccoli gruppi di utenti per validare le modifiche.
Rollout Graduali: Distribuisci gli aggiornamenti gradualmente per individuare i problemi in anticipo.
Fix di Emergenza: Ripristina rapidamente gli aggiornamenti con un solo clic se qualcosa va storto.

Riepilogo

Panoramica dei Passaggi di Setup

Per iniziare, dovrai installare la CLI, configurare build e variabili d’ambiente, proteggere i tuoi segreti, abilitare il monitoraggio e distribuire gli aggiornamenti. Questo processo si integra perfettamente con gli strumenti di monitoraggio e rollback, garantendo che la tua app rimanga online con tempi di inattività minimi.

Benefici CI/CD

La connessione tra setup e risultati mostra come Capgo aumenti l’efficienza: gli aggiornamenti raggiungono il 95% degli utenti in sole 24 ore. Inoltre, i prezzi di Capgo - da $12/mese a $83/mese - offrono un enorme vantaggio di costo rispetto ai servizi legacy che possono costare oltre $500/mese. Attualmente, Capgo supporta più di 1.900 app in produzione [1].