Capgo Integration with GitHub Actions: Guide

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

• Ersparnis: Kosteneinsparungen von bis zu 26.100 € über 5 Jahre im Vergleich zu AppFlow.
• Schnelle Updates: Pushen Sie Updates sofort und 95 % der Benutzer erhalten sie innerhalb von 24 Stunden.
• Sichere Bereitstellungen: Ende-zu-Ende-Verschlüsselung sichert Updates ab.
• Fließender Workflow: Automatisieren Sie 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, konfigurieren Sie GitHub-Actions mit einem YAML-Workflow.
3. Deployments: Verwenden Sie Befehle wie npx @capgo/cli deploy zum context:Live updates product page. Role: Short UI label or navigation item. Message key `live_update_dynamic_label_to` (Live Update Dynamic Label To)..
4. Automatisierung von UpdatesTests

: Deployen Sie in Testkanäle (z.B. Beta, Staging) bevor Sie in die Produktion gehen.:

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

Einstellungsvoraussetzungen

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

erfordert die Einrichtung der notwendigen Werkzeuge und Konfigurationen.

Erforderliche Werkzeuge und Konten

Nachdem diese Schritte abgeschlossen sind, können Sie Capgo zu 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. Beibehalten Sie Capgo-Produkt-/Marken- und Entwicklertitel 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:

“Lassen Sie npx @capgo/cli init, das ist es!” [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, stellen Sie sicher, dass das Repository die erforderlichen Geheimnisse, Zweig-Schutzmaßnahmen und Bereitstellungs-Trigger für Ihren OTA-Release-Prozess enthält.

Preise

• Capgo-Pläne beginnen bei 12 $/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 Guthaben abgerechnet werden.

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

• Repository Struktur: Ordne deine Repositorys mit separaten Verzeichnissen für Quellcode code, Assets und Konfigurationsdateien, um alles sauber und verwaltbar zu halten.
• Umgebungs-Konfiguration: Erstelle separate Umgebungen für Entwicklung, Staging und Produktion, um sicherzustellen, dass Zugriffssteuerungen und Sicherheitsmaßnahmen ordnungsgemäß eingerichtet sind.
• Zugriffs-Management: Setze Repository-Rechte sorgfältig, um __CAPGO_KEEP_0__-Integration zu ermöglichen, während Sicherheit gewährleistet bleibt. Capgo-Integration __CAPGO_KEEP_0__-Workflow-Einrichtung

: Automatisiere deine GitHub-Deployments

GitHub-Deployments

__CAPGO_KEEP_0__-Actions-Workflow-Einrichtung Capgo-Deployments mit GitHub Actions Ihren CI/CD-Prozess zu vereinfachen.

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

Zur Sicherstellung sicherer Bereitstellungen müssen Sie Ihre Geheimschlüssel ordnungsgemäß verwalten. GitHub Actions 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 Repositorys und finde die "Geheimnisse und Variablen"-Sektion unter der "Sicherheit"-Schaltfläche.

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-Installation durchzuführen:

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

Authentifizierung der CLI

Authentifizieren Sie die CLI sicher mithilfe des CAPGO_TOKEN:

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

Bereitstellungs-Befehle

Hier sind die wichtigsten Befehle, um Ihr Update zu erstellen, zu versionieren und zu deployen:

Setzt die Versionsnummer für das Update

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 die Workflow-Ausführung läuft. GitHubs Geheimhaltungssystem hält Ihre Zugangsdaten während des gesamten Prozesses sicher.

Testen und Fehlerbehebungen

Ausführen von Test-Workflows

Sie können Ihren GitHub-Actions-Workflow, indem Sie eine dedizierte 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-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 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 Betriebsabläufe, fast alle unsere Nutzer sind innerhalb von Minuten nach dem Ausrollen des OTA bei @Capgo auf dem neuesten Stand.” [1]

3. Versionenkonflikte

Halten Sie sich an semantische Versionierung und erhöhen Sie die Versionen korrekt, um Konflikte während der Bereitstellungen zu vermeiden.

Wartungs-Tipps

• Verwenden Sie Capgo-Analytik 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ühren Sie bei Hochprioritäts-Bereitstellungen Vorteil aus Capgo's Fehler-Tracking, 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örung minimiert wird. Diese Praktiken werden Ihnen helfen, Ihre Bereitstellungen reibungslos laufen zu lassen, während Sie näher an die Produktion herankommen.

Zusammenfassung

Hauptpunkte

Capgo’s Integration mit GitHub Actions vereinfacht den Bereitstellungsprozess für Capgo-Anwendungen Capacitor-Anwendungen, wodurch Entwicklungsteams erhebliche Vorteile erfahren. 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 $ ü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 die 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 Ihrem Capgo und GitHub Actions-Integration herauszuholen, erkunden Sie diese fortgeschrittenen Taktiken:

• Benutzerdefinierte API Workflows: Verwenden Sie Capgo’s öffentlichen API zur Gestaltung von Bereitstellungsworkflows, die den spezifischen Bedürfnissen Ihres Teams entsprechen. 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 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.

Capgo ist ein Markenname, der nicht übersetzt werden sollte. API ist ein Produktname, der nicht übersetzt werden sollte.

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.