Capgo Integrazione con GitHub Azioni: Guida

Capgo e GitHub Azioni insieme semplificano il processo di distribuzione degli aggiornamenti per Esegui il Capacitor Le applicazioni. Ecco perché questa integrazione merita la tua attenzione:

• Salva denaro: Risparmia fino a 26.100€ di costi CI/CD rispetto a AppFlow.
• Aggiornamenti veloci: Invia gli aggiornamenti istantaneamente con il 95% degli utenti che li riceve in 24 ore.
• Deployamenti sicuri: La crittografia end-to-end garantisce che gli aggiornamenti siano sicuri.
• Flusso di lavoro semplificato: Automatizza costruzioni e deploy direttamente nel tuo repository GitHub.

Panoramica rapida

1. Requisiti: account GitHub, account Capgo (da 12€/mese), progetto Capacitor, Node.js.
2. Configurazione: Installa Capgo CLI con npx @capgo/cli init, configura le GitHub Actions con un flusso di lavoro YAML.
3. Distribuzione: Utilizza comandi come npx @capgo/cli deploy per automatizzare gli aggiornamenti per automatizzare gli aggiornamenti.
4. Test: Distribuisci sui canali di test (ad esempio, beta, staging) prima della produzione.

Flusso di lavoro di esempio (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 di app veloci, sicuri e a basso costo, rendendola ideale per i team di sviluppo agile.

GitHub Azioni Tutorial - Concetti base e pipeline CI/CD

Requisiti di configurazione

Integrazione di Capgo With GitHub azioni coinvolge la configurazione degli strumenti e delle impostazioni necessarie.

Strumenti e Conti Obbligatori

Assicurati di avere i seguenti conti e strumenti pronti:

Una volta che questi sono stati installati, puoi procedere ad aggiungere Capgo al tuo progetto per aggiornamenti live automatici.

Aggiungere Capgo al Tuo Progetto

Per integrare Capgo, installalo nel tuo progetto Capacitor utilizzando lo strumento CLI di Capgo.

Esegui npx @capgo/cli init che è divertente! [1]

Questa riga di comando configurerà il plugin e le sue dipendenze richieste.

GitHub Repository Setup

Prepara il tuo repository GitHub per soddisfare le esigenze di integrazione CI/CD con Capgo.

Prima di aggiungere il workflow, conferma che il repository abbia i segreti, le protezioni di branch e i trigger di distribuzione necessari per il tuo processo di rilascio OTA.

Prenotazioni

• I piani Capgo iniziano a $12/mese.
• Lo stesso piano include aggiornamenti OTA e circa 15 build native al mese.
• I minuti aggiuntivi di build sono fatturati per minuto attraverso crediti.

Ecco come configurare il tuo repository:

• Struttura del Repository: Organizza il tuo repository con directory separate per il codice code, le risorse e i file di configurazione per mantenere tutto pulito e gestibile.
• Configurazione dell'ambiente: Crea ambienti distinti per lo sviluppo, la staging e la produzione, assicurandoti che siano presenti controlli di accesso e misure di sicurezza adeguati.
• Gestione degli accessi: Imposta con cura le autorizzazioni dei repository per consentire Capgo integrazione mantenendo comunque la sicurezza.

Questi passaggi assicureranno che il tuo progetto sia pronto per il flusso di lavoro GitHub Actions, che verrà descritto nella sezione successiva.

GitHub Flusso di lavoro di azioni

Automatizza i Capgo deployment utilizzando GitHub Actions per semplificare il processo CI/CD.

Creazione del file di flusso di lavoro

Avvia creando un file YAML nel .github/workflows di 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 impostato il file, scegli le giuste azioni per il tuo workflow.

Opzioni di attivazione del workflow

GitHub Azioni ti consentono di personalizzare quando i workflow vengono eseguiti. Ecco alcune opzioni di attivazione:

Gestione delle chiavi segrete

Per garantire i deployment sicuri, è necessario gestire correttamente le tue chiavi segrete. GitHub Azioni offre un sistema di gestione delle chiavi segrete crittografate per questo scopo.

Passaggi per configurare l'autenticazione sicura:

1. Accesso alle impostazioni del repository
   Vai alle impostazioni del tuo repository e trova la sezione "Segreti e variabili" sotto il pulsante "Security".

2. Aggiungi Capgo Credenziali
   Salva il tuo Capgo token di autenticazione come un segreto del repository. Chiamalo CAPGO_TOKEN.

3. Riferimento ai Segreti nei Flussi di lavoro
   Utilizza le tue segrete archiviate nel flusso di lavoro facendo riferimento a esse in questo modo: ${{ secrets.CAPGO_TOKEN }}.

Capgo Comandi nei Flussi di lavoro

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

Installazione di Capgo CLI

Aggiungi il seguente passo al tuo flusso di lavoro per installare il Capgo CLI:

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

Autenticazione del CLI

Autentica in modo sicuro il CLI utilizzando il CAPGO_TOKEN:

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

Comandi di distribuzione

Ecco i comandi chiave per gestire la costruzione, la versione e la distribuzione delle tue aggiornamenti:

Per automatizzare l'intero processo di distribuzione, utilizza i comandi insieme come segue:

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 aggiornamenti siano automaticamente costruiti, versionati e distribuiti ogni volta che il flusso di lavoro viene eseguito. Il sistema di gestione dei segreti di GitHub mantiene i tuoi credenziali al sicuro durante tutto il processo.

Test e correzioni

Esecuzione dei Flussi di Lavoro di Test

Puoi testare il tuo flusso di lavoro di GitHub Actions utilizzando un canale dedicato Capgo per il testing. Ciò ti consente di verificare gli aggiornamenti prima che vengano resi disponibili.

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

Il sistema dei canali di Capgo ti aiuta a creare percorsi di distribuzione separati per diverse fasi:

Soluzioni di errore

Ecco alcune problematiche di integrazione comuni e come risolverle:

1. Fallimenti di autenticazione

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

2. Errori di costruzione

Assicurati che la configurazione di costruzione corrisponda alle esigenze del tuo ambiente di distribuzione.

“Abbiamo distribuito gli aggiornamenti Capgo OTA in produzione per la nostra base di utenti di +5000. Stiamo vedendo un'operazione molto fluida quasi tutti i nostri utenti sono aggiornati in pochi minuti dall'aggiornamento OTA distribuito su @Capgo.” [1]

3. Conflitti di Versione

Segui la versione semantica e incrementa le versioni correttamente per prevenire conflitti durante le distribuzioni.

Consigli di Manutenzione

• Usa Capgo analytics per monitorare i tassi di successo delle aggiornamenti.
• Abilita i rollback automatici per gli aggiornamenti che potrebbero causare problemi.
• Testa le richieste di pull (PRs) utilizzando i selettori dei canali per un controllo migliore.
• Mantieni aggiornato il tuo workflow con i comandi più recenti di Capgo CLI.

Per le distribuzioni di alta priorità, approfitta del tracciamento degli errori di Capgo per individuare potenziali problemi in anticipo. Se qualcosa va storto, il feature di rollback consente di tornare a una versione stabile velocemente, minimizzando la disfunzione. Queste pratiche aiuteranno a mantenere le distribuzioni in esecuzione in modo fluido mentre ti avvicini alla produzione.

Conclusioni

Punti Chiave

Capgo’s integrazione con GitHub Actions semplifica il processo di distribuzione per Capacitor app, offrendo benefici significativi alle squadre di sviluppo. Con un tasso di successo globale del 82% per gli aggiornamenti e il 95% degli utenti attivi che ricevono gli aggiornamenti entro 24 ore [1], questa soluzione si distingue per la sua efficienza.

Ecco alcune delle caratteristiche più significative:

• Automated Workflows: Configurando i flussi di lavoro direttamente in GitHub Actions, non è più necessario utilizzare hosting CI/CD esterno. Questo approccio riduce i costi operativi, risparmiando circa $26,100 in cinque anni rispetto a alternative come AppFlow [1].
• Fast Deployment: Gli aggiornamenti possono essere spediti istantaneamente, bypassando i ritardi degli store di app.
• Strong Security: La crittografia end-to-end garantisce che gli aggiornamenti siano consegnati in modo sicuro, mentre il sistema di canali di Capgo consente roll-out controllati e fasi.

Queste caratteristiche aprono la strada a soluzioni più personalizzate e prestazioni migliorate, esplorate ulteriormente di seguito.

Strategie Avanzate

Per ottenere il massimo dalle tue Capgo e GitHub azioni di integrazione, esplora queste tattiche avanzate:

• Flussi di lavoro personalizzati API: Use Capgo’s public API to design deployment workflows that fit your team’s specific needs. This can enable white-label experiences and seamless integration with your current tools [1].
• Rilasci basati su canali: Ottimizza il tuo processo di distribuzione utilizzando le funzionalità dei canali di Capgo per aggiornamenti in fase di testing e controllati
• Performanza Ottimizzata: Utilizza gli aggiornamenti parziali di Capgo per ridurre l'uso di banda e accelerare gli aggiornamenti. Con 23,5 milioni di aggiornamenti consegnati su 750 applicazioni di produzione, il sistema ha dimostrato la sua capacità di gestire esigenze a grande scala. [1]Per risultati ancora migliori, considera l'uso delle opzioni di hosting self-service di __CAPGO_KEEP_0__ o dei settaggi di __CAPGO_KEEP_1__ personalizzati. Consulta le sezioni precedenti per le istruzioni dettagliate di configurazione e testing per implementare completamente queste strategie.

Continua da qui: Integrazione Capgo con API azioni: Guida

Keep going from Capgo Integration with GitHub Actions: Guide

Se stai utilizzando Capgo Integration with GitHub Actions: Guide per pianificare la sicurezza e la conformità, connettilo con Crittografia per i dettagli di implementazione in Crittografia, Conformità per i dettagli di implementazione in Conformità, Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner di Sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di Trust per il flusso di lavoro del prodotto in Capgo Centro di Trust.