Capgo Integration mit GitHub Actions: Anleitung

Capgo und GitHub Actions simplifizieren gemeinsam das Bereitstellen von Updates Capacitor Apps. Hier ist der Grund, warum diese Integration Ihre Aufmerksamkeit verdient:

• Geld sparen: Kostensenkung bei CI/CD um bis zu 26.100 $ über 5 Jahre im Vergleich zu AppFlow.
• Schnelle Updates: Updates werden sofort gepusht, wobei 95 % der Benutzer sie innerhalb von 24 Stunden erhalten.
• Sichere Bereitstellungen: End-to-end-Verschlüsselung sichert Updates ab.
• Gestrafter Workflow: Automatisierung von Builds und Bereitstellungen direkt in Ihrem GitHub-Repository.

Schnelle Übersicht

1. Anforderungen: GitHub Konto, Capgo Konto (ab 12 €/Monat), Capacitor Projekt, Node.js.
2. Einrichtung: Installieren Capgo CLI mit npx @capgo/cli init, GitHub Actions mit einer YAML-Arbeitsablauf konfigurieren.
3. Bereitstellung: Verwenden Sie Befehle wie npx @capgo/cli deploy zu Automatisierung von Updates.
4. Testen: In Testkanäle (z.B. Beta, Staging) vor der Produktion deployen.

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

Diese Integration sichert schnelle, sichere und kosteneffiziente App-Updates, was sie ideal für agile Entwicklungsteams macht.

GitHub Aktionen Tutorial - Grundlagen und CI/CD-Pipeline

Setup-Anforderungen

Integrieren von Capgo mit GitHub Aktionen werden die notwendigen Werkzeuge und Konfigurationen eingerichtet.

Erforderliche Werkzeuge und Konten

Stellen Sie sicher, dass Sie die folgenden Konten und Werkzeuge bereit haben:

Sobald diese Schritte abgeschlossen sind, können Sie sich auf die Integration von Capgo in Ihr Projekt für automatisierte Live-Updates vorbereiten.

Hinzufügen Capgo in Ihr Projekt

Um Capgo zu integrieren, installieren Sie es in Ihrem Capacitor-Projekt mithilfe seiner CLI-Tool. Laut Martin Donadieu, Gründer von Capgo:

“Run npx @capgo/cli init das!” [1]

Diese Kommandozeilenanweisung stellt die Plugin- und die erforderlichen Abhängigkeiten ein.

GitHub Repository-Einrichtung

Vorbereiten Sie Ihr GitHub-Repository, um die Anforderungen für die CI/CD-Integration mit Capgo zu erfüllen.

Bevor Sie das Workflow hinzufügen, bestätigen Sie, dass das Repository die erforderlichen Geheimnisse, Zweigschutzmechanismen und Auslöser für Ihre OTA-Release-Prozesse enthält.

Preise

• Die Capgo-Pläne beginnen bei 12 €/Monat.
• Der gleiche Tarif umfasst OTA-Updates und etwa 15 native Builds pro Monat.
• Zusätzliche Build-Minuten werden nach Minute mit Credits abgerechnet.

Hier erfahren Sie, wie Sie Ihr Repository einrichten:

• Repository-Struktur: Ordnen Sie Ihr Repository mit separaten Verzeichnissen für Quellcode code, Assets und Konfigurationsdateien an, um alles sauber und verwaltbar zu halten.
• Umgebungs-Konfiguration: Erstellen Sie unterschiedliche Umgebungen für Entwicklung, Staging und Produktion, um sicherzustellen, dass die richtigen Zugriffssteuerungen und Sicherheitsmaßnahmen in Kraft sind.
• Zugriffs-Management: Legen Sie die Repository-Berechtigungen sorgfältig fest, um Capgo-Integration zu ermöglichen, während die Sicherheit aufrechterhalten wird.

Diese Schritte werden sicherstellen, dass Ihr Projekt für die GitHub Actions-Auftragsarbeit vorbereitet ist, die in der nächsten Abschnitt beschrieben wird.

GitHub Actions-Auftragsarbeit-Konfiguration

Automatisieren Sie Ihre Capgo-Dienstleistungen mit GitHub Actions, um Ihren CI/CD-Prozess zu vereinfachen.

Erstellung der Auftragsarbeit-Datei

Erstellen Sie zunächst eine YAML-Datei im .github/workflows Verzeichnis Ihres Repositorys. Hier ist ein Beispiel:

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

Diese Konfiguration sichert sichere und automatisierte Bereitstellungen. Sobald Sie die Datei eingerichtet haben, wählen Sie die richtigen Trigger für Ihr Workflow.

Workflow-Trigger-Optionen

GitHub Aktionen ermöglichen Ihnen, anzugeben, wann Workflows ausgeführt werden. Hier sind einige Trigger-Optionen:

Verwaltung von Geheimschlüsseln

Um sicherzustellen, dass die Bereitstellungen sicher sind, müssen Sie Ihre Geheimschlüssel ordnungsgemäß verwalten. GitHub Aktionen bietet ein verschlüsseltes Geheimnissystem zur Verwaltung dieses Zwecks.

Schritte zur Einrichtung einer sicheren Authentifizierung:

1. Zugriff auf Repository-Einstellungen
   Gehe zu den Einstellungen deines Repositories und finde die 'Geheimnisse und Variablen'-Sektion unter der 'Sicherheit'-Schaltfläche.

2. Hinzufügen Capgo Anmeldeinformationen
   Speichere Ihren Capgo-Authentifizierungstoken als Repository-Geheimnis. Benenne es CAPGO_TOKEN.

3. Verweise auf Geheimnisse in Workflows
   Verwende Ihre gespeicherten Geheimnisse im Workflow, indem Sie sie wie folgt referenzieren: ${{ secrets.CAPGO_TOKEN }}.

Capgo Befehle in Workflows

Sobald Ihr GitHub Actions-Umgebung eingerichtet ist, können Sie die Automatisierung von Bereitstellungen durch die Integration von Capgo CLI-Befehlen durchführen.

Installation von Capgo CLI

Füge den folgenden Schritt deinem Workflow hinzu, um die Capgo CLI zu installieren:

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

Authentifizierung von CLI

Authentifiziere CLI sicher mithilfe der CAPGO_TOKEN:

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

Deployments-Befehle

Hier sind die wichtigsten Befehle, um das Erstellen, Versionsverwalten und Bereitstellen Ihrer Updates zu handhaben:

Um den gesamten Bereitstellungsprozess zu automatisieren, verwenden Sie die Befehle zusammen wie folgt:

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

Dieses Setup stellt sicher, dass Ihre Updates automatisch erstellt, versioniert und bereitgestellt werden, sobald der Workflow läuft. GitHub's geheimes Verwaltungssystem hält Ihre Anmeldeinformationen während des gesamten Prozesses sicher.

Testen und Fehlerbehebungen

Laufende Test-Workflows

Sie können Ihren GitHub-Actions-Workflow, indem Sie ein dediziertes Capgo-Testkanalverwenden. Dies ermöglicht es Ihnen, Updates vor ihrer Veröffentlichung zu validieren.

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

Capgo's Kanal-System hilft Ihnen, separate Bereitstellungswege für verschiedene Stufen zu erstellen:

Fehlerlösungen

Hier sind einige häufige Integrationsprobleme und wie man sie löst:

1. Authentifizierungsfehler

Überprüfen Sie den CAPGO_TOKEN in GitHub Secrets. Wenn es abgelaufen ist, regenerieren Sie es, um eine reibungslose Authentifizierung sicherzustellen.

2. Build-Fehler

Stellen Sie sicher, dass Ihre Build-Konfiguration den Anforderungen Ihres Bereitstellungsumfelds entspricht.

„Wir haben Capgo OTA-Updates in der Produktion für unsere Nutzerbasis von +5000 durchgeführt. Wir sehen sehr glatte Operationen. Fast alle unsere Nutzer sind innerhalb von Minuten nach dem OTA-Update bei @Capgo auf dem neuesten Stand.“ [1]

3. Version Konflikte

Bleiben Sie bei der semantischen Versionsnummerierung und erhöhen Sie die Versionen korrekt, um Konflikte während der Bereitstellung zu vermeiden.

Wartungstipps

• Verwenden Sie Capgo-Analytik um Erfolgssätze bei Updates zu überwachen.
• Aktivieren Sie automatische Rollbacks für Updates, die Probleme verursachen könnten.
• Testen Sie Pull-Anfragen (PRs) mit Kanal-Selektoren, um mehr Kontrolle zu haben.
• Halten Sie Ihr Workflow auf dem neuesten Stand mit den neuesten Capgo CLI-Befehlen.

Bei Hochprioritäts-Bereitstellungen nutzen Sie die Fehlerüberwachung von Capgo, um potenzielle Probleme frühzeitig zu erkennen. Wenn etwas schief geht, ermöglicht die Rollback-Funktion eine schnelle Rückkehr zu einer stabilen Version, wodurch die Störungen minimiert werden. Diese Praktiken helfen Ihnen, Ihre Bereitstellungen reibungslos in die Produktion zu bringen.

Zusammenfassung

Hauptmerkmale

Capgo’s Integration mit GitHub Actions vereinfacht den Bereitstellungsprozess für Capacitor-Apps, die großen Vorteile für Entwicklerteams bringen. Mit einer globalen Erfolgsrate von 82% für Updates und 95% der aktiven Benutzer erhalten Updates innerhalb von 24 Stunden [1], überzeugt diese Lösung durch ihre Effizienz.

Hier sind einige herausragende Funktionen:

• Automatisierte Workflows: Durch die Konfiguration von Workflows direkt in GitHub Actions ist keine externe CI/CD-Hosting erforderlich. Diese Vorgehensweise reduziert die Betriebskosten um etwa 26.100 $ über fünf Jahre im Vergleich zu Alternativen wie AppFlow [1].
• Schnelle Bereitstellung: Updates können sofort gepusht werden, wobei sich App-Store-Verzögerungen vermeiden lassen.
• Starke Sicherheit: Die Ende-zu-Ende-Verschlüsselung sichert Updates sicher ab, während Capgo’s Kanal-System kontrollierte, gestufte Rollouts ermöglicht.

Diese Funktionen eröffnen den Weg für mehr zugeschnittene Lösungen und verbesserte Leistung, die im Folgenden genauer untersucht werden.

Fortgeschrittene Strategien

Um das Maximum aus Ihrem Capgo und GitHub Actions-Integration zu erhalten, erkunden Sie diese fortgeschrittenen Taktiken:

• Eigene API Workflows: Verwenden Sie Capgo’s öffentliche API zur Gestaltung von Bereitstellungsworkflows, die sich an die spezifischen Bedürfnisse Ihres Teams anpassen lassen. Dies kann weißen Etiketten und eine nahtlose Integration mit Ihren aktuellen Werkzeugen ermöglichen [1].
• Kanalbasierte Releases: Optimieren Sie Ihren Bereitstellungsprozess, indem Sie Capgo’s Kanalfeatures für gestufte und kontrollierte Updates verwenden.
• Optimierte Leistung: Nutzen Sie Capgo’s partielle Updates, um den Bandbreitenverbrauch zu reduzieren und die Updates zu beschleunigen. Mit 23,5 Millionen Updates, die in 750 Produktionsanwendungen übermittelt wurden, hat das System seine Fähigkeit unter Beweis gestellt, große Skalendemands zu bewältigen. [1]Für noch bessere Ergebnisse sollten Sie die Selbstverwaltungsoptionen von __CAPGO_KEEP_0__ oder benutzerdefinierte __CAPGO_KEEP_1__-Konfigurationen in Betracht ziehen. Überprüfen Sie die früheren Abschnitte für detaillierte Setup- und Testanweisungen, um diese Strategien vollständig umzusetzen.

Fortsetzen Sie mit der Capgo-Integration mit API Actions: Anleitung

Keep going from Capgo Integration with GitHub Actions: Guide

If you are using Capgo Integration mit GitHub Aktionen: Anleitung um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Verschlüsselung, Kongruenz für die Implementierungsdetails in Kongruenz, Capgo Sicherheits-Scanner für den Produktworkflow in Capgo Sicherheits-Scanner, Capgo Sicherheit für den Produktworkflow in Capgo Sicherheit, und Capgo Trust Center für den Produktworkflow in Capgo Trust Center.