Capgo Integration mit GitHub Aktionen: Anleitung

Capgo und GitHub Aktionen simplifizieren Sie gemeinsam die Bereitstellung von Updates für 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: Pushen Sie Updates sofort mit 95 % der Benutzer erhalten sie sie innerhalb von 24 Stunden.
• Sichere Bereitstellungen: End-to-End-Verschlüsselung stellt sicher, dass Updates sicher sind.
• Gestrafter Workflow: Automate builds und deployments direkt in Ihrem GitHub Repository.

Schnelle Übersicht

1. Anforderungen: GitHub Konto, Capgo Konto (ab 12 €/Monat), Capacitor Projekt, Node.js.
2. Einrichtung: Installieren Sie Capgo CLI mit npx @capgo/cli init, konfigurieren Sie GitHub Actions mit einem YAML-Workflow.
3. Bereitstellung: Verwenden Sie Befehle wie npx @capgo/cli deploy um Updates zu automatisieren.
4. Testen: Bereitstellen Sie in Testkanälen (z.B. Beta, Staging) vor der Produktion.

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

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 Die Integration von GitHub Actions beinhaltet die Einrichtung der notwendigen Werkzeuge und Konfigurationen.

Erforderliche Werkzeuge und Konten

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

Sobald diese Schritte abgeschlossen sind, können Sie Capgo zu Ihrem Projekt hinzufügen, um automatisierte Live-Updates zu erhalten.

Hinzufügen Capgo zu Ihrem Projekt

To integrate Capgo, install it in your Capacitor project using its CLI tool. According to Martin Donadieu, founder of Capgo:

“Führen Sie npx @capgo/cli init aus, damit es funktioniert!” [1]

Diese Anweisung stellt die Plugin-Einrichtung 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 die Workflow hinzufügen, stellen Sie sicher, dass das Repository die erforderlichen Geheimnisse, Branch-Schutzmechanismen und Auslösefunktionen für Ihren OTA-Release-Prozess enthält.

Preise

• Capgo-Pläne beginnen bei 12 Euro pro Monat.
• Der gleiche Plan umfasst OTA-Updates und etwa 15 native Builds pro Monat.
• Zusätzliche Build-Minuten werden pro Minute über Krediten abgerechnet.

Hier erfahren Sie, wie Sie Ihr Repository einrichten können.

• Repository Struktur: Ordne deine Repository mit separaten Verzeichnissen für Quellcode code, Assets und Konfigurationsdateien, um alles sauber und verwaltsbar zu halten.
• Umgebungskonfiguration: Erstelle separate Umgebungen für Entwicklung, Staging und Produktion, um sicherzustellen, dass angemessene Zugriffssteuerungen und Sicherheitsmaßnahmen getroffen werden.
• Zugriffsmanagement: Setze Repository-Rechte sorgfältig, um __CAPGO_KEEP_0__-Integration zu ermöglichen, während Sicherheit gewährleistet bleibt. Diese Schritte werden sicherstellen, dass dein Projekt für die Capgo Actions-Arbeitsablauf vorbereitet ist, der in der nächsten Abschnitt detailliert beschrieben wird. __CAPGO_KEEP_0__ Actions-Arbeitsablauf-Setup

Automatisiere deine GitHub-Deployments

GitHub Actions Workflow Setup

: Organize your repository with separate directories for source __CAPGO_KEEP_0__, assets, and configuration files to keep everything clean and manageable. Capgo deployments mit GitHub Aktionen Ihren CI/CD-Prozess vereinfachen.

Workflow-Datei erstellen

Beginnen Sie mit der Erstellung eines YAML-Dateis in dem .github/workflows Verzeichnis Ihres Repositories. 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, die Ausführung von Workflows zu personalisieren. Hier sind einige Trigger-Optionen:

Verwaltung von Geheimschlüsseln

Zur Sicherstellung sicherer Bereitstellungen müssen Sie Ihre Geheimschlüssel ordnungsgemäß verwalten. GitHub Actions bietet ein verschlüsseltes Geheimschlüssel-Verwaltungssystem für diesen Zweck.

Schritte zur Einrichtung einer sicheren Authentifizierung:

1. Zugriff auf Repository-Einstellungen
   Gehen Sie zu den Einstellungen Ihres Repositorys und finden Sie die „Geheimnisse und Variablen“-Sektion unter der „Sicherheit“-Registerkarte.

2. Hinzufügen Capgo-Anmeldeinformationen
   Speichern Sie Ihr Capgo-Authentifizierungstoken als Repository-Geheimnis. Benennen Sie es CAPGO_TOKEN.

3. Verweise auf Geheimnisse in Workflows
   Verwenden Sie Ihre gespeicherten Geheimnisse im Workflow, indem Sie auf sie wie folgt verweisen: ${{ 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 erreichen.

Installation von Capgo CLI

Fügen Sie dem folgenden Schritt Ihren 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

Authentifiziert den CLI

Authentifizieren Sie den CLI sicher mithilfe des CAPGO_TOKEN:

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

Bereitstellungsbefehle

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

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

Testen und Reparaturen

Test-Workflow ausführen

Sie können Ihren GitHub-Actions-Workflow, indem Sie einen dedizierten 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 Bereitstellungspfade für verschiedene Stadien zu erstellen:

Fehler Lösungen

Hier sind einige häufige Integrationsschwierigkeiten und wie man sie behebt:

1. Authentifizierungsfehler

Überprüfen Sie den CAPGO_TOKEN in GitHub Secrets. Wenn er abgelaufen ist, regenerieren Sie ihn, 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 ausgerollt. Wir sehen sehr glatte Operationen, fast alle unsere Nutzer sind innerhalb von Minuten nach dem Bereitstellen des OTA an @Capgo auf dem neuesten Stand.” [1]

3. Versionenkonflikte

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

Wartungstipps

• Verwenden Sie Capgo-Analytics um die Erfolgsraten von Updates zu überwachen.
• Aktivieren Sie automatische Rollbacks für Updates, die Probleme verursachen könnten.
• Testen Sie Pull-Anforderungen (PRs) mit Kanal-Selektoren, um mehr Kontrolle zu haben.
• Halten Sie Ihre Workflow auf dem neuesten Stand mit den neuesten Capgo-CLI-Befehlen.

Für 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 werden Ihnen helfen, Ihre Bereitstellungen reibungslos laufen zu lassen, während Sie näher an die Produktion herankommen.

Zusammenfassung

Hauptmerkmale

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

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 sichergestellt wird, dass keine Verzögerungen durch App-Store-Verzögerungen auftreten.
• Starker Schutz: 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 maßgeschneiderte Lösungen und verbesserte Leistung, die im Folgenden genauer untersucht werden.

Erweiterte Strategien

Um das volle Potenzial aus Ihrem Capgo und GitHub Actions-Integration zu nutzen, erkunden Sie diese erweiterten Taktiken:

• Benutzerdefinierte API Workflows: Verwenden Sie Capgo’s öffentlichen API zur Gestaltung von Bereitstellungsworkflows, die auf die spezifischen Bedürfnisse Ihres Teams zugeschnitten sind. Dies kann weißen-Label-Erfahrungen und eine nahtlose Integration mit Ihren aktuellen Werkzeugen ermöglichen. [1].
• Kanalbasierte Releases: Optimieren Sie Ihren Bereitstellungsprozess, indem Sie Capgo’s Kanal-Funktionen 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 über 750 Produktionsanwendungen abgeliefert wurden, hat das System seine Fähigkeit, große Anforderungen zu bewältigen, unter Beweis gestellt. [1]Für noch bessere Ergebnisse sollten Sie die Selbst-Hosting-Optionen von __CAPGO_KEEP_0__ oder benutzerdefinierte __CAPGO_KEEP_1__-Konfigurationen in Betracht ziehen. Überprüfen Sie die vorherigen Abschnitte, um detaillierte Setup- und Testanweisungen zu finden, um diese Strategien vollständig umzusetzen.

Capgo ist ein Produkt von Capgo, einem führenden Anbieter von API-Lösungen.