Integrazione di Capgo con GitHub Actions: Guida

Capgo e Azioni GitHub insieme semplificano il deploy degli update per Capacitor le app. Ecco perché questa integrazione merita la tua attenzione:

• Risparmia denaro: Riduci i costi CI/CD fino a $26.100 in 5 anni rispetto a AppFlow.
• Update rapidi: Distribuisci aggiornamenti istantaneamente: il 95% degli utenti li riceve entro 24 ore.
• Deployment sicuri: La crittografia end-to-end garantisce la sicurezza degli update.
• Workflow ottimizzato: Automatizza build e deployment direttamente nel tuo repository GitHub.

Panoramica rapida

1. Requisiti: account GitHub, account Capgo (da $12/mese), progetto Capacitor, Node.js.
2. Setup: Installa Capgo CLI con npx @capgo/cli init, configura GitHub Actions con un workflow YAML.
3. Deployment: Usa comandi come npx @capgo/cli deploy a automatizza gli update.
4. Test: Distribuisci sui canali di test (es. beta, staging) prima della produzione.

Esempio di 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 }}  

Questa integrazione garantisce aggiornamenti app veloci, sicuri ed economici, ideale per team di sviluppo agile.

Azioni GitHub Tutorial - Concetti Base e Pipeline CI/CD

Requisiti di configurazione

Integrare Capgo con GitHub Actions richiede la configurazione degli strumenti e dei parametri necessari.

Strumenti e Account Richiesti

Assicurati di avere pronti i seguenti account e strumenti:

Una volta pronti, puoi procedere ad aggiungere Capgo al tuo progetto per gli aggiornamenti live automatizzati.

Aggiunta Capgo al tuo progetto

Per integrare Capgo, installalo nel tuo progetto Capacitor usando il suo tool CLI. Secondo Martin Donadieu, fondatore di Capgo:

“Esegui npx @capgo/cli init e il gioco è fatto!” [1]

Questo comando configurerà il plugin e le relative dipendenze.

Configurazione del repository GitHub

Prepara il tuo repository GitHub per soddisfare i requisiti di integrazione CI/CD con Capgo.

Prima di aggiungere il workflow, verifica che il repository abbia i secret, le branch protections e i trigger di deployment necessari per il tuo processo di rilascio OTA.

Prezzi

• I piani Capgo partono da $12/mese.
• Lo stesso piano include gli aggiornamenti OTA e circa 15 Native Build al mese.
• I minuti extra di build vengono fatturati al minuto tramite crediti.

Ecco come configurare il tuo repository:

• Struttura del Repository: Organizza il repository con directory separate per il code sorgente, gli asset e i file di configurazione per mantenere tutto pulito e gestibile.
• Configurazione dell'Ambiente: Crea ambienti distinti per development, staging e production, assicurandoti che siano attivi i corretti controlli di accesso e misure di sicurezza.
• Gestione degli accessi: Configura con cura i permessi del repository per consentire l'integrazione con Capgo mantenendo alta la sicurezza.

Questi passaggi ti assicureranno che il tuo progetto sia pronto per il workflow di GitHub Actions, che vedremo nella prossima sezione.

Configurazione del Workflow GitHub Actions

Automatizza i tuoi deployment di Capgo usando GitHub Actions per ottimizzare il tuo processo CI/CD.

Creazione del file Workflow

Inizia creando un file YAML nella .github/workflows directory del tuo repository. Ecco un esempio:

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

Questa configurazione garantisce deployment sicuri e automatizzati. Una volta creato il file, scegli i trigger corretti per il tuo workflow.

Opzioni di Trigger del Workflow

GitHub Actions ti permette di personalizzare l'esecuzione dei workflow. Ecco alcune opzioni di trigger:

Gestione delle Secret Keys

Per garantire deployment sicuri, devi gestire correttamente le tue secret keys. GitHub Actions offre un sistema di gestione criptata delle secret per questo scopo.

Passaggi per configurare l'autenticazione sicura:

1. Accedi alle impostazioni del repository
   Vai nelle impostazioni del tuo repository e trova la sezione “Secrets and variables” sotto la tab “Security”.

2. Aggiungi Credenziali Capgo
   Salva il token di autenticazione Capgo come secret del repository. Chiamalo CAPGO_TOKEN.

3. Referenziare i Secret nei Workflow
   Usa i secret salvati nel workflow referenziandoli in questo modo: ${{ secrets.CAPGO_TOKEN }}.

Comandi Capgo nei Workflow

Una volta configurato l'ambiente GitHub Actions, puoi automatizzare i deployment integrando i comandi Capgo CLI.

Installare Capgo CLI

Aggiungi questo step al tuo workflow per installare Capgo CLI:

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

Autenticazione di CLI

Autentica in modo sicuro CLI usando CAPGO_TOKEN:

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

Comandi di Deployment

Ecco i comandi principali per gestire build, versioning e deployment dei tuoi update:

Per automatizzare l'intero processo di deployment, usa i comandi insieme in questo modo:

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

Questa configurazione garantisce che i tuoi update vengano buildati, versionati e deployati automaticamente a ogni esecuzione del workflow. Il sistema di gestione dei secret di GitHub mantiene le tue credenziali al sicuro durante tutto il processo.

Test e correzioni

Esecuzione dei workflow di test

Puoi testare il tuo workflow di GitHub Actions usando un canale di testing Capgo. Questo ti permette di validare gli update prima del rilascio.

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

Il sistema di canali di Capgo ti permette di creare percorsi di deployment separati per ogni fase:

Soluzioni agli errori

Ecco i problemi di integrazione più comuni e come risolverli:

1. Errori di autenticazione

Controlla il CAPGO_TOKEN nei GitHub Secrets. Se è scaduto, rigeneralo per garantire un'autenticazione fluida.

2. Errori di build

Assicurati che la configurazione di build sia conforme ai requisiti dell'ambiente di deployment.

“Abbiamo rilasciato gli update OTA di Capgo in produzione per la nostra base di oltre 5000 utenti. Il funzionamento è molto fluido: quasi tutti i nostri utenti sono aggiornati pochi minuti dopo il deploy dell'OTA su @Capgo.” [1]

3. Conflitti di versione

Usa il semantic versioning e incrementa le versioni correttamente per evitare conflitti durante i deployment.

Consigli di manutenzione

• Usa analytics di Capgo per monitorare il tasso di successo degli update.
• Abilita il rollback automatico per gli update che potrebbero causare problemi.
• Testa le pull request (PR) usando i selettori di canale per un controllo migliore.
• Mantieni il tuo workflow aggiornato con gli ultimi comandi Capgo CLI.

Per i deployment ad alta priorità, sfrutta l'error tracking di Capgo per individuare subito eventuali problemi. Se qualcosa va storto, la funzione di rollback ti permette di tornare rapidamente a una versione stabile, minimizzando i disservizi. Queste pratiche ti aiuteranno a mantenere i deployment fluidi man mano che ti avvicini alla produzione.

Conclusione

Punti chiave

L'integrazione di Capgo con GitHub Actions semplifica il deployment per app Capacitor, offrendo grandi vantaggi ai team di sviluppo. Con un tasso di successo globale degli aggiornamenti dell'82% e il 95% degli utenti attivi che riceve gli update entro 24 ore [1], questa soluzione si distingue per la sua efficienza.

Ecco alcune delle caratteristiche principali:

• Workflow Automatizzati: Configurando i workflow direttamente in GitHub Actions, non serve un hosting CI/CD esterno. Questo approccio riduce i costi operativi, risparmiando circa $26.100 in cinque anni rispetto ad alternative come AppFlow [1].
• Deployment rapido: Updates can be pushed instantly, bypassing app store delays.
• Sicurezza Elevata: La crittografia end-to-end garantisce la consegna sicura degli update, mentre il sistema di channel di Capgo permette rollout controllati e graduali.

Queste funzionalità aprono la strada a soluzioni su misura e prestazioni migliori, che vedremo più avanti.

Strategie Avanzate

Per sfruttare al meglio l'integrazione tra Capgo e GitHub Actions, esplora queste tattiche avanzate:

• Workflow API personalizzati: Usa le API pubbliche di Capgo per progettare workflow di deployment su misura per il tuo team. Questo permette esperienze white-label e un'integrazione fluida con i tuoi tool attuali. [1].
• Rilasci basati su Channel: Ottimizza il processo di deployment usando le funzionalità di channel di Capgo per aggiornamenti graduali e controllati.
• Performance ottimizzate: Sfrutta gli aggiornamenti parziali di Capgo per ridurre il consumo di banda e velocizzare gli update. Con 23,5 milioni di update inviati a 750 app in produzione [1], il sistema ha dimostrato di saper gestire richieste su larga scala.

Per risultati ancora migliori, considera le opzioni di self-hosting di Capgo o configurazioni API personalizzate. Consulta le sezioni precedenti per istruzioni dettagliate su setup e testing per implementare queste strategie.

Continua con: Integrazione Capgo con GitHub Actions: Guida

Se stai usando Integrazione Capgo con GitHub Actions: Guida per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow del prodotto in Capgo Security Scanner, Sicurezza Capgo per il workflow del prodotto in Capgo Security, e Trust Center di Capgo per il workflow del prodotto in Capgo Trust Center.