Capgo-Integration mit GitHub-Actions: Leitfaden

Capgo und GitHub Actions zusammen vereinfachen sie die Bereitstellung von Updates für Capacitor Apps. Hier ist der Grund, warum diese Integration Ihre Aufmerksamkeit verdient:

• Kosten sparen: Kostensenkung von 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: Ende-zu-Ende-Verschlüsselung sichert Updates ab.
• Fließender Workflow: Automatisieren 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 Benutzerschnittstelle-Label oder Navigationselement. Gesehen in: Seite native-build.astro. Nachrichten Schlüssel `native_build_v2_strip_setup_k` (Native Build V2 Strip Setup K). : Installieren Sie CLI Capgo mit npx @capgo/cli init, konfigurieren Sie GitHub-Aktionen mit einem YAML-Workflow.
3. Deployments: Verwenden Sie Befehle wie npx @capgo/cli deploy zur Automatisierung von Updates.
4. Tests: 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 für agile Entwicklungsteams ideal macht.

GitHub-Aktionen Anleitung - Grundlagen und CI/CD-Pipeline

Setup-Anforderungen

Capgo mit Capgo Aktionen GitHub mit GitHub Aktionen beinhaltet die Einrichtung der notwendigen Werkzeuge und Konfigurationen.

Benötigte Werkzeuge und Konten

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

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

Hinzufügen Capgo Zum Projekt

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]

Dieser Befehl stellt die Plugin- und Abhängigkeitskonfiguration ein.

GitHub Repository Setup

Stellen Sie Ihr GitHub-Repository so ein, dass es die Anforderungen für die CI/CD-Integration mit Capgo erfüllt.

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

Pricing

• Capgo-Pläne beginnen bei 12 $/Monat.
• Der gleiche Plan umfasst OTA-Updates und etwa 15 native Builds pro Monat.
• Die zusätzlichen Buildminuten werden pro Minute über Krediten abgerechnet.

Hier erfahren Sie, wie Sie Ihre Repository einrichten.

• Repository-StrukturOrganisieren Sie Ihr Repository mit separaten Verzeichnissen für Quellcode code, Assets und Konfigurationsdateien, um alles sauber und verwaltbar zu halten.
• Umgebungs-KonfigurationErstellen Sie separate Umgebungen für Entwicklung, Staging und Produktion, um sicherzustellen, dass Zugriffssteuerungen und Sicherheitsmaßnahmen ordnungsgemäß eingerichtet sind.
• Zugriffs-ManagementSetzen Sie die Repository-Rechte sorgfältig, um __CAPGO_KEEP_0__-Integration zu ermöglichen, Capgo integration während die Sicherheit gewährleistet bleibt.

Diese Schritte stellen sicher, dass Ihr Projekt für den GitHub-Actions-Workflow vorbereitet ist, der in der nächsten Abschnitt beschrieben wird.

GitHub-Actions-Workflow-Einrichtung

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

Erstellen Sie das Workflow-File

Beginnen Sie mit der Erstellung eines YAML-Dateis in dem .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 }}

Dieses Konfigurations-Set sichert sicher und automatisiert die Bereitstellung. Sobald Sie das File 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:

Geheime Schlüssel verwalten

Zur sicheren Bereitstellung müssen Sie Ihre geheimen Schlüssel ordnungsgemäß verwalten. GitHub Actions bietet ein verschlüsseltes Geheimnissystem 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“-Karte.

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

3. Verweise auf Geheimnisse in Workflows
   Verwenden Sie Ihre gespeicherten Geheimnisse in der Workflow-Datei, indem Sie auf sie wie folgt verweisen: ${{ secrets.CAPGO_TOKEN }}.

Capgo Befehle in Workflows

Nachdem Ihr GitHub Actions-Umgebung eingerichtet ist, können Sie die Bereitstellung automatisieren, indem Sie Capgo CLI Befehle integrieren.

Installation von Capgo CLI

Fügen Sie den folgenden Schritt in Ihrem Workflow ein, 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

Authentifizieren Sie die CLI sicher mit dem CAPGO_TOKEN:

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

Befehle zur Bereitstellung

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

Um den gesamten Bereitstellungsprozess zu automatisieren, verwenden Sie die Befehle gemeinsam 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. GitHubs Geheimhaltungssystem hält Ihre Zugangsdaten während des gesamten Prozesses sicher.

Testen und Korrekturen

Laufende Test-Workflows

Sie können Ihren GitHub-Actions-Workflow testen, indem Sie einen dedizierten GitHub-Testkanal verwenden Capgo testing channel__CAPGO_KEEP_0__s Kanal-System hilft Ihnen, separate Bereitstellungswege für verschiedene Stadien 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 es abgelaufen ist, regenerieren Sie es, um eine glatte 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 Nutzergruppe von +5000 ausgerollt. Wir sehen sehr glatte Betriebsabläufe. Fast alle unsere Benutzer sind innerhalb von Minuten nach dem Ausrollen des OTA bei @Capgo auf dem neuesten Stand.” [1]

3. Versionskonflikte

Beachten Sie die semantische Versionsierung und erhöhen Sie die Versionen korrekt, um Konflikte während der Bereitstellung zu vermeiden.

Wartungs-Tipps

• 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-Anforderungen (PRs) mit Kanal-Selektoren, um mehr Kontrolle zu haben.
• Behalten Sie Ihren Workflow mit den neuesten Capgo CLI-Befehlen auf dem neuesten Stand.

Für Hochprioritäts-Deployments nutzen Sie die Fehlererkennung 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 Deployments reibungslos zu gestalten, während Sie sich dem Produktionsumfeld näher kommen.

Zusammenfassung

Hauptmerkmale

Capgo’s Integration mit GitHub Actions vereinfacht den Deployment-Prozess für Capgo-Anwendungen Capacitor-Anwendungen, die bedeutenden Vorteile für Entwicklerteams liefern. Mit einer globalen Erfolgsrate von 82 % bei 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, wodurch etwa 26.100 $ über fünf Jahre gegenüber Alternativen wie AppFlow eingespart werden können. [1].
• Schnelle BereitstellungUpdates können sofort hochgeladen werden, ohne dass sich App-Store-Verzögerungen einstellen müssen.
• Starker SchutzEnd-to-end-Verschlüsselung sichert die sichere Lieferung von Updates, während das Capgo-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 erläutert werden.

Erweiterte Strategien

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

• Benutzerdefinierte API-WorkflowsVerwenden Sie Capgo's öffentliche API zum Entwerfen von Bereitstellungsworkflows, die den spezifischen Bedürfnissen Ihres Teams entsprechen. Dies kann die Möglichkeit für weiße Etiketten und eine nahtlose Integration mit Ihren aktuellen Werkzeugen ermöglichen. [1].
• Kanalbasierte ReleasesOptimieren Sie Ihren Bereitstellungsprozess, indem Sie Capgo's Kanal-Funktionen für gestufte und kontrollierte Updates verwenden.
• Optimierte LeistungNutzen Sie Capgo's partielle Updates, um den Bandbreitenverbrauch zu reduzieren und die Updates zu beschleunigen. Mit 23,5 Millionen Updates, die über 750 Produktionsanwendungen geliefert wurden. [1]Die Systeme haben ihre Fähigkeit bewiesen, große Anforderungen zu bewältigen.

Für noch bessere Ergebnisse sollten Sie die Selbstverwaltungsoptionen von Capgo oder benutzerdefinierte API-Konfigurationen in Betracht ziehen. Überprüfen Sie die vorherigen Abschnitte für detaillierte Einrichtungs- und Testanweisungen, um diese Strategien vollständig umzusetzen.

Fortsetzung von Capgo-Integration mit GitHub-Aktionen: Anleitung

Wenn Sie __CAPGO_KEEP_0__-Integration mit __CAPGO_KEEP_1__-Aktionen: Anleitung verwenden Capgo Integration with GitHub Actions: Guide Verschlüsselung zur Implementierungsdetail in Verschlüsselung, Compliance zur Implementierungsdetail in Compliance, __CAPGO_KEEP_0__-Sicherheits-Scanner zur Produktworkflow in Capgo-Sicherheits-Scanner, for the product workflow in Capgo Security Scanner, Capgo Sicherheit zur Produktworkflow in Capgo Sicherheit, und Capgo Vertrauenszentrum zur Produktworkflow in Capgo Vertrauenszentrum.