Capgo Integration with GitHub Actions: Guide

Capgo und GitHub Aktionen zusammen vereinfachen Sie die Bereitstellung von Updates Capacitor Apps. Hier ist der Grund, warum diese Integration Ihre Aufmerksamkeit verdient:

• Kosten sparen: KI/CD-Kosten um bis zu 26.100 $ pro 5 Jahren gegenüber AppFlow.
• Schnelle Updates: Pushen Sie Updates sofort mit 95 % der Benutzer erhalten sie sie in 24 Stunden.
• Sichere Bereitstellungen: End-to-End-Verschlüsselung stellt sicher, dass Updates sicher sind.
• Fließender WorkflowAutomatisieren Sie Builds und Bereitstellungen direkt in Ihrem GitHub-Repository.

Kurzer Überblick

1. Anforderungen: GitHub-Konto Capgo-Konto (ab 12 €/Monat), Capacitor-Projekt Node.js.
2. EinstellungKontext: Capgo Builder / native cloud build Produktseite. Rolle: Untertitel oder Schlagzeile. Nachrichten Schlüssel `native_build_builder_setup_eyebrow` (Native Build Builder Setup Eyebrow). | Kontext: Capgo Builder / native cloud build Produktseite. Rolle: Kurzer UI-Label oder Navigationselement. Gesehen in: Seite native-build.astro. Nachrichten Schlüssel `native_build_v2_strip_setup_k` (Native Build V2 Strip Setup K). Capgo CLI __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ npx @capgo/cli initmit der Konfiguration von GitHub Actions mit einem YAML-Workflow.
3. Deployments: Verwenden Sie Befehle wie npx @capgo/cli deploy zum context: Seite/Bereich: Produktseite für Live-Updates. Rolle: Kurzer Benutzerschnittstelle-Label oder Navigationselement. Nachrichtenschlüssel `live_update_dynamic_label_to` (Live-Update-Dynamische-Label-zu)..
4. Automatisierung von UpdatesTests

: Deployen Sie in Testkanäle (z.B. Beta, Staging) vor der Produktion.:

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

Beispiel-Workflow (YAML)

GitHub Actions __CAPGO_KEEP_0__ Aktionen

Setup Anforderungen

Integrating Capgo with GitHub Actions involves setting up the necessary tools and configurations.

Erforderliche Werkzeuge und Konten

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

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

Hinzufügen Capgo Kontext: HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `submitting_a_pr_to_capgo`). Seite/Bereich: Capgo-Marketing-Website. Rolle: Website-Kopfzeile. Gesehen in: Seite contributing.astro. Erhalten Sie Capgo-Produkt/Marke und Entwicklertrems genau. Nachrichtenschlüssel `submitting_a_pr_to_capgo` (Ein Pull-Request an Capgo einreichen).

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

“Run npx @capgo/cli init das!” [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 das Workflow hinzufügen, bestätigen Sie, dass das Repository die erforderlichen Geheimnisse, Zweigschutzmaßnahmen und Auslöser für Ihre OTA-Release-Prozesse 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 nach Minute berechnet, wobei die Kosten in Form von Krediten erhoben werden.

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.
• Umgebungs-Konfiguration: Erstelle separate Umgebungen für Entwicklung, Staging und Produktion, um sicherzustellen, dass angemessene Zugriffssteuerungen und Sicherheitsmaßnahmen vorhanden sind.
• Zugriffs-Management: 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-Arbeitsschritt vorbereitet ist, der in der nächsten Abschnitt detailliert beschrieben wird. __CAPGO_KEEP_0__-Actions-Arbeitsschritt-Konfiguration

: Automatisiere deine GitHub-Deployments

GitHub Actions Workflow Setup

: Ordne deine Repository mit separaten Verzeichnissen für Quellcode __CAPGO_KEEP_0__, Assets und Konfigurationsdateien, um alles sauber und verwaltsbar zu halten. Capgo deployments mit GitHub Actions Ihren CI/CD-Prozess optimieren.

Erstellung der Workflow-Datei

Beginnen Sie mit der Erstellung einer 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 Ihre Workflow.

Workflow-Trigger-Optionen

GitHub Actions ermöglicht Ihnen, die Ausführung von Workflows zu personalisieren. 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 Actions bietet ein verschlüsseltes Geheimschlüssel-Verwaltungssystem für diesen Zweck.

Schritte zur Einrichtung einer sicheren Authentifizierung:

1. Zugriff auf Repository-Einstellungen
   Gehe zu den Einstellungen deines Repositorys und finde die 'Geheimnisse und Variablen'-Sektion unter der 'Sicherheit'-Registerkarte.

2. Hinzufügen Capgo-Anmeldeinformationen
   Speichere deinen Capgo-Authentifizierungs-Token als Repository-Geheimnis. Benenne es CAPGO_TOKEN.

3. Verweise auf Geheimnisse in Workflows
   Verwende deine gespeicherten Geheimnisse in der Workflow-Datei, indem du auf sie wie folgt verweist: ${{ secrets.CAPGO_TOKEN }}.

Capgo-Befehle in Workflows

Einmal dein GitHub-Actions-Umgebung eingerichtet, kannst du Automatisierungen durchführen, indem du Capgo CLI-Befehle integrierst.

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 der CLI

Sichere Authentifizierung der CLI mithilfe der CAPGO_TOKEN:

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

Bereitstellungsbefehle

Hier sind die wichtigsten Befehle zur Verwaltung des Builds, der Versionsnummerierung und der Bereitstellung Ihrer Updates:

Setzt die Versionsnummer für das Update fest

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. GitHubs Geheimhaltungssystem hält Ihre Zugangsdaten während des gesamten Prozesses sicher.

Testen und Korrekturen

Test-Workflow ausführen

Sie können Ihren GitHub-Workflow mit Actions testen, indem Sie einen dedizierten GitHub-Testkanal verwenden Capgo testing channel__CAPGO_KEEP_0__s Kanal-System hilft Ihnen, separate Bereitstellungspfade für verschiedene Stufen zu erstellen:

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

Capgo’s channel system helps you create separate deployment paths for different stages:

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 er abgelaufen ist, regenerieren Sie ihn, um eine reibungslose Authentifizierung sicherzustellen.

2. Buildfehler

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 Abläufe, fast alle unsere Nutzer sind innerhalb von Minuten nach dem Ausrollen des OTA bei @Capgo auf dem neuesten Stand.” [1]

3. Versionenkonflikte

Beachten Sie die folgenden Wartungstipps:

Verwenden Sie

• __CAPGO_KEEP_0__-Analytik Capgo analytics 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_KEEP_0__-__CAPGO_KEEP_1__-Befehlen.
• Keep your workflow updated with the latest Capgo CLI commands.

For high-priority deployments, take advantage of Capgo’s error tracking to spot potential issues early. If something goes wrong, the rollback feature allows you to revert to a stable version quickly, minimizing disruption. These practices will help keep your deployments running smoothly as you move closer to production.

Zusammenfassung

Hauptpunkte

Capgo’s Integration mit GitHub Actions vereinfacht den Bereitstellungsprozess für Capgo-Anwendungen Capacitor-Anwendungen, wodurch Entwicklungsteams erhebliche Vorteile erzielen. Mit einer globalen Erfolgsrate von 82% für Updates und 95% der aktiven Benutzer erhalten Updates innerhalb von 24 Stunden [1], was diese Lösung für ihre Effizienz auszeichnet.

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 US-Dollar über fünf Jahre im Vergleich zu Alternativen wie AppFlow [1].
• Schnelle Bereitstellung: Updates können sofort gepusht werden, ohne dass sich die App-Store-Verzögerungen auswirken.
• 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.

Fortgeschrittene Strategien

Um das Maximum aus Ihrer Capgo und GitHub Actions-Integration herauszuholen, erkunden Sie diese fortgeschrittenen Taktiken:

• Benutzerdefinierte API Workflows: Verwenden Sie Capgo’s öffentliche API zur Gestaltung von Bereitstellungsworkflows, die auf die spezifischen Bedürfnisse Ihres Teams zugeschnitten sind. 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 Kanal-Funktionen für gestufte und kontrollierte Updates verwenden.
• Optimierte Leistung: Nutzen Sie Capgo’s partielle Updates, um den Bandbreitenverbrauch zu reduzieren und Updates zu beschleunigen. Mit 23,5 Millionen Updates, die über 750 Produktionsanwendungen verteilt wurden, hat das System seine Fähigkeit, große Skalendemands zu bewältigen, unter Beweis gestellt. [1]Für noch bessere Ergebnisse sollten Sie __CAPGO_KEEP_0__’s Selbst-Hosting-Optionen oder benutzerdefinierte __CAPGO_KEEP_1__-Konfigurationen in Betracht ziehen. Überprüfen Sie die früheren Abschnitte, um detaillierte Setup- und Testanweisungen zu finden, um diese Strategien vollständig umzusetzen.

For even better results, consider using Capgo’s self-hosting options or custom API setups. Check earlier sections for detailed setup and testing instructions to fully implement these strategies.

Weiter von Capgo Integration mit GitHub Actions: Leitfaden

Wenn Sie __CAPGO_KEEP_0__ Integration mit __CAPGO_KEEP_1__ Actions: Leitfaden verwenden Wenn Sie Capgo Integration mit GitHub Actions: Leitfaden verwenden Um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Verschlüsselung Compliance für die Implementierungsdetails in Compliance Capgo Sicherheits-Scanner für den Produktworkflow in Capgo Sicherheits-Scanner Capgo Sicherheit für den Produktworkflow in Capgo Sicherheit Capgo Vertrauenszentrum zur Produktworkflow in Capgo Vertrauenszentrum.