Capgo und GitHub Actions vereinfachen gemeinsam die Bereitstellung von Updates für Capacitor Apps. Hier sind die Gründe, warum diese Integration Ihre Aufmerksamkeit verdient:

• Geld sparen: Reduzieren Sie CI/CD-Kosten um bis zu 26.100 € über 5 Jahre im Vergleich zu AppFlow
• Schnelle Updates: Sofortige Update-Bereitstellung mit 95% Nutzererreichung innerhalb von 24 Stunden
• Sichere Bereitstellungen: Ende-zu-Ende-Verschlüsselung gewährleistet sichere Updates
• Optimierter Workflow: Automatisieren Sie Builds und Bereitstellungen direkt in Ihrem GitHub Repository

Kurzer Überblick

1. Voraussetzungen: GitHub Account, Capgo Account (ab 12€/Monat), Capacitor Projekt, Nodejs
2. Einrichtung: Installieren Sie Capgo CLI mit npx @capgo/cli init, konfigurieren Sie GitHub Actions mit einem YAML Workflow
3. Bereitstellung: Nutzen Sie Befehle wie npx @capgo/cli deploy zur Automatisierung von Updates
4. Testen: Bereitstellen 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@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18.x'
      - name: Install Dependencies
        run: npm install
      - name: Deploy to Capgo
        run: npx @capgo/cli deploy
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Diese Integration gewährleistet schnelle, sichere und kosteneffektive App-Updates, ideal für agile Entwicklungsteams

GitHub Actions Tutorial - Grundkonzepte und CI/CD Pipeline

Einrichtungsvoraussetzungen

Die Integration von Capgo mit GitHub Actions erfordert die Einrichtung der notwendigen Tools und Konfigurationen

Erforderliche Tools und Konten

Stellen Sie sicher, dass Sie folgende Konten und Tools bereit haben:

Sobald diese vorhanden sind, können Sie mit der Integration von Capgo in Ihr Projekt für automatisierte Live-Updates fortfahren

Capgo zu Ihrem Projekt hinzufügen

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

“Führen Sie npx @capgo/cli init aus, das war’s!” [1]

Dieser Befehl richtet das Plugin und seine erforderlichen Abhängigkeiten ein

GitHub Repository Einrichtung

Bereiten Sie Ihr GitHub Repository vor, um die Anforderungen für CI/CD-Integration mit Capgo zu erfüllen. Wie in ihrer Dokumentation erwähnt:

“Wir konfigurieren Ihre CI/CD-Pipeline direkt in Ihrer bevorzugten Plattform, sei es GitHub Actions, GitLab CI oder andere. Wir hosten keine CI/CD oder berechnen Ihnen deren Wartung” [1]

Capgo bietet diese Einrichtung für eine einmalige Gebühr von 2.600 € und ~300 €/Monat, was günstiger ist als AppFlows jährliche Gebühr von 6.000 € [1]

So richten Sie Ihr Repository ein:

• Repository-Struktur: Organisieren Sie Ihr Repository mit separaten Verzeichnissen für Quellcode, Assets und Konfigurationsdateien, um alles übersichtlich und verwaltbar zu halten
• Umgebungskonfiguration: Erstellen Sie verschiedene Umgebungen für Entwicklung, Staging und Produktion, und stellen Sie sicher, dass entsprechende Zugriffskontrollen und Sicherheitsmaßnahmen vorhanden sind
• Zugriffsverwaltung: Legen Sie Repository-Berechtigungen sorgfältig fest, um die Capgo-Integration zu ermöglichen und gleichzeitig die Sicherheit zu gewährleisten

Diese Schritte stellen sicher, dass Ihr Projekt bereit für den GitHub Actions Workflow ist, der im nächsten Abschnitt beschrieben wird

GitHub Actions Workflow Einrichtung

Automatisieren Sie Ihre Capgo-Bereitstellungen mit GitHub Actions zur Optimierung Ihres CI/CD-Prozesses

Erstellen der Workflow-Datei

Beginnen Sie mit der Erstellung einer YAML-Datei im Verzeichnis github/workflows Ihres Repositories. Hier ein Beispiel:

name: Capgo Deploy
on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18.x'
      - 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 gewährleistet sichere und automatisierte Deployments. Nachdem Sie die Datei eingerichtet haben, wählen Sie die richtigen Auslöser für Ihren Workflow.

Workflow-Auslöser Optionen

GitHub Actions ermöglicht es Ihnen, den Zeitpunkt der Workflow-Ausführung anzupassen. Hier sind einige Auslöser-Optionen:

Verwaltung von Geheimen Schlüsseln

Für sichere Deployments müssen Sie Ihre geheimen Schlüssel richtig verwalten. GitHub Actions bietet dafür ein verschlüsseltes Geheimnis-Verwaltungssystem.

Schritte zur Einrichtung sicherer Authentifizierung:

1. Repository-Einstellungen aufrufen
   Gehen Sie zu den Einstellungen Ihres Repositories und finden Sie den Bereich “Secrets and variables” unter dem “Security” Tab

2. Capgo Anmeldedaten hinzufügen
   Speichern Sie Ihren Capgo Authentifizierungs-Token als Repository-Geheimnis. Nennen Sie es CAPGO_TOKEN

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

Capgo Befehle in Workflows

Sobald Ihre GitHub Actions Umgebung eingerichtet ist, können Sie Deployments durch Integration von Capgo CLI Befehlen automatisieren.

Installation der Capgo CLI

Fügen Sie den folgenden Schritt zu Ihrem 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

Authentifizieren Sie die CLI sicher mit dem CAPGO_TOKEN:

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

Deployment Befehle

Hier sind die wichtigsten Befehle für das Erstellen, Versionieren und Deployen Ihrer Updates:

Um den gesamten Deployment-Prozess 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 deployed werden, wenn der Workflow ausgeführt wird. Das Geheimnis-Verwaltungssystem von GitHub hält Ihre Anmeldedaten während des gesamten Prozesses sicher.

Tests und Fehlerbehebung

Test-Workflows ausführen

Sie können Ihren GitHub Actions Workflow testen, indem Sie einen dedizierten Capgo Test-Kanal verwenden. Dies ermöglicht es Ihnen, Updates zu validieren, bevor sie live gehen.

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

Das Kanal-System von Capgo hilft Ihnen, separate Deployment-Pfade für verschiedene Stufen zu erstellen:

Fehlerlösungen

Hier sind einige häufige Integrationsprobleme und wie Sie diese angehen:

1. Authentifizierungsfehler

Überprüfen Sie den CAPGO_TOKEN in den GitHub Secrets. Wenn er abgelaufen ist, generieren Sie ihn neu, um eine reibungslose Authentifizierung sicherzustellen.

2. Build-Fehler

Stellen Sie sicher, dass Ihre Build-Konfiguration den Anforderungen Ihrer Deployment-Umgebung entspricht.

“Wir haben Capgo OTA-Updates in der Produktion für unsere Nutzerbasis von +5000 eingeführt. Wir sehen einen sehr reibungslosen Betrieb, fast alle unsere Nutzer sind innerhalb von Minuten nach dem OTA-Deployment auf @Capgo auf dem neuesten Stand” [1]

3. Versionskonflikte

Halten Sie sich an semantische Versionierung und erhöhen Sie Versionen ordnungsgemäß, um Konflikte während des Deployments zu vermeiden.

Wartungstipps

• Nutzen Sie Capgo Analytics zur Überwachung der Update-Erfolgsraten- Aktivieren Sie automatische Rollbacks für Updates, die Probleme verursachen könnten
• Testen Sie Pull Requests (PRs) mit Kanal-Selektoren für bessere Kontrolle
• Halten Sie Ihren Workflow mit den neuesten Capgo CLI-Befehlen aktuell

Für Deployments mit hoher Priorität nutzen Sie Capgos Fehlerverfolgung, um potenzielle Probleme frühzeitig zu erkennen. Falls etwas schief geht, ermöglicht die Rollback-Funktion eine schnelle Rückkehr zu einer stabilen Version, wodurch Störungen minimiert werden. Diese Praktiken helfen dabei, Ihre Deployments reibungslos am Laufen zu halten, während Sie sich der Produktion nähern.

Fazit

Wichtige Punkte

Capgos Integration mit GitHub Actions vereinfacht den Deployment-Prozess für Capacitor Apps und bietet Entwicklungsteams große Vorteile. Mit einer globalen Erfolgsrate von 82% für Updates und 95% der aktiven Nutzer, die Updates innerhalb von 24 Stunden erhalten [1], sticht diese Lösung durch ihre Effizienz hervor.

Hier sind einige herausragende Funktionen:

• Automatisierte Workflows: Durch die direkte Konfiguration von Workflows in GitHub Actions ist kein externes CI/CD-Hosting erforderlich. Dieser Ansatz reduziert die Betriebskosten und spart im Vergleich zu Alternativen wie AppFlow über fünf Jahre etwa 26.100 $ [1]
• Schnelles Deployment: Updates können sofort bereitgestellt werden, ohne App-Store-Verzögerungen
• Hohe Sicherheit: Ende-zu-Ende-Verschlüsselung gewährleistet sichere Update-Auslieferung, während Capgos Kanalsystem kontrollierte, gestufte Einführungen ermöglicht

Diese Funktionen ebnen den Weg für maßgeschneiderte Lösungen und verbesserte Leistung, die nachfolgend näher erläutert werden.

Fortgeschrittene Strategien

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

• Benutzerdefinierte API-Workflows: Nutzen Sie Capgos öffentliche API, um Deployment-Workflows zu erstellen, die den spezifischen Bedürfnissen Ihres Teams entsprechen. Dies ermöglicht White-Label-Erfahrungen und nahtlose Integration mit Ihren aktuellen Tools [1]
• Kanalbasierte Releases: Optimieren Sie Ihren Deployment-Prozess durch die Nutzung von Capgos Kanalfunktionen für gestufte und kontrollierte Updates
• Optimierte Leistung: Nutzen Sie Capgos partielle Updates, um die Bandbreitennutzung zu reduzieren und Updates zu beschleunigen. Mit 235 Millionen ausgelieferten Updates über 750 Produktions-Apps [1] hat das System seine Fähigkeit bewiesen, große Anforderungen zu bewältigen

Für noch bessere Ergebnisse erwägen Sie die Nutzung von Capgos Self-Hosting-Optionen oder benutzerdefinierten API-Einrichtungen. Schauen Sie in den vorherigen Abschnitten nach detaillierten Einrichtungs- und Testanweisungen, um diese Strategien vollständig umzusetzen.