Capgo Intégration avec GitHub Actions : Guide

Capgo et GitHub Actions pour simplifier ensemble le déploiement des mises à jour Capacitor pour les applications. Voici pourquoi cette intégration est susceptible de vous intéresser :

• Économisez de l'argent: Réduisez les coûts CI/CD de jusqu'à 26 100 $ sur 5 ans par rapport à AppFlow.
• Mises à jour rapides: Déployez les mises à jour instantanément avec 95 % des utilisateurs les recevant en 24 heures.
• Déploiements sécurisés: L'encryption de bout en bout garantit que les mises à jour sont sûres.
• Flux de travail simplifié: Automate builds and deployments directly in votre GitHub.

Vue d'ensemble rapide

1. Exigences: Un compte GitHub Un compte Capgo (à partir de 12 $/mois), un projet Capacitor Node.js.
2. Configuration: Installer Capgo CLI avec npx @capgo/cli init, configurer les GitHub Actions avec un flux de travail YAML.
3. Déploiement: Utilisez des commandes comme npx @capgo/cli deploy pour context":"Page/area: Page de produit de mises à jour en direct. Role: Étiquette de navigation ou élément UI court. Message clé `live_update_dynamic_label_to` (Étiquette de mise à jour en direct dynamique To)",.
4. automatiser les mises à jourTest

: Déployez sur des canaux de test (par exemple, bêta, étape de préparation) avant la production.:

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

Flux de travail d'exemple (YAML)

GitHub Actions __CAPGO_KEEP_0__ Actions

Configuration requise

Intégration avec les Capgo L'intégration des GitHub avec les Actions implique la configuration des outils et des paramètres nécessaires.

Outils et comptes requis

Veuillez vous assurer d'avoir les comptes et les outils suivants prêts :

Une fois ces éléments en place, vous pouvez procéder à l'ajout de Capgo à votre projet pour des mises à jour en temps réel automatiques.

Ajouter Capgo context : fragment de texte HTML d'une chaîne de Capgo (clé parent `submitting_a_pr_to_capgo`). Page/zone : site web de marketing de Capgo. Rôle : phrase de site web. Vu dans : page contributing.astro. Conservez exactement les termes de produit et de marque de Capgo et les termes de développeur. Clé de message `submitting_a_pr_to_capgo` (Soumettre Un Pr À Capgo).

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 cela !” [1]

Cette commande mettra en place le plugin et ses dépendances requises.

GitHub Configuration du dépôt

Préparez votre dépôt GitHub pour répondre aux exigences de l'intégration CI/CD avec Capgo.

Avant d'ajouter le flux de travail, assurez-vous que le dépôt dispose des secrets requis, des protections de branchement et des déclencheurs de déploiement pour votre processus de mise à jour OTA.

Prix

• Les plans Capgo commencent à 12 $/mois.
• Le même plan comprend les mises à jour OTA et environ 15 builds natifs par mois.
• Les minutes de build supplémentaires sont facturées par minute par crédit.

Voici comment configurer votre dépôt :

• Structure de Répertoire: Organisez votre répertoire avec des dossiers séparés pour le code source code, les actifs et les fichiers de configuration pour garder tout propre et gérable.
• Configuration de l'Environnement: Créez des environnements distincts pour le développement, la mise en ligne et la production, en veillant à ce que les contrôles d'accès et les mesures de sécurité soient correctement mis en place.
• Gestion des Accès: Définissez les permissions du répertoire avec soin pour autoriser Capgo intégration tandis que vous maintenez la sécurité.

Ces étapes vous permettront de vous assurer que votre projet est prêt pour le flux de travail GitHub Actions, qui sera détaillé dans la section suivante.

Configuration du Flux de Travail GitHub Actions

: Automatisez vos Capgo déploiements en utilisant GitHub Actions pour simplifier votre processus CI/CD.

Créer le Fichier de Flux

Démarrez en créant un fichier YAML dans le .github/workflows répertoire de votre dépôt. Voici un exemple :

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

Cette configuration garantit des déploiements sécurisés et automatisés. Une fois que vous avez configuré le fichier, choisissez les bonnes déclencheurs pour votre flux.

Options de Déclencheurs de Flux

GitHub Actions vous permet de personnaliser quand les flux s'exécutent. Voici quelques options de déclencheurs :

Gestion des clés secrètes

Pour s'assurer de déploiements sécurisés, vous devez gérer correctement vos clés secrètes. GitHub Actions propose un système de gestion de secrets chiffrés à cet effet.

Étapes pour configurer une authentification sécurisée :

1. Accéder aux paramètres de la ressource
   Allez dans les paramètres de votre ressource et trouvez la section « Secrets et variables » sous l’onglet « Security ».

2. Ajouter Capgo Identifiants
   Enregistrez votre jeton d’authentification Capgo en tant que secret de la ressource. Nommez-le CAPGO_TOKEN.

3. Référencer les secrets dans les workflows
   Utilisez vos secrets stockés dans le workflow en les référençant comme suit : ${{ secrets.CAPGO_TOKEN }}.

Capgo Commandes dans les workflows

Une fois votre environnement d’actions GitHub configuré, vous pouvez automatiser les déploiements en intégrant les commandes Capgo CLI.

Installer Capgo CLI

Ajoutez l'étape suivante à votre workflow pour installer les Capgo CLI :

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

Authentifier le CLI

Authentifier sécurisé le CLI à l'aide de CAPGO_TOKEN:

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

Commandes de déploiement

Voici les commandes clés pour gérer la construction, la versionnage et le déploiement de vos mises à jour :

Pour automatiser l'ensemble du processus de déploiement, utilisez les commandes ensemble comme suit :

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

Ce paramétrage garantit que vos mises à jour sont automatiquement construites, versionnées et déployées chaque fois que le flux de travail s'exécute. Le système de gestion des secrets de GitHub garde vos informations d'identification en toute sécurité tout au long du processus.

Tests et corrections

Exécution des flux de travail de test

Vous pouvez tester votre flux de travail d'actions GitHub en utilisant un canal dédié Capgo permet de tester votre flux de travail avant de le mettre en production.Le système de canaux de __CAPGO_KEEP_0__ vous aide à créer des chemins de déploiement séparés pour différentes étapes :

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

Solutions d'erreur

Ici vous trouverez quelques problèmes d'intégration courants et comment les résoudre :

1. Échecs d'authentification

Vérifiez le CAPGO_TOKEN dans les GitHub Secrets. Si celui-ci est expiré, régénérez-le pour vous assurer d'une authentification fluide.

2. Erreurs de construction

Assurez-vous que votre configuration de build correspond aux exigences de votre environnement de déploiement.

“Nous avons déployé des mises à jour OTA Capgo en production pour notre base d'utilisateurs de +5000. Nous constatons une opération très fluide, presque tous nos utilisateurs sont à jour dans les minutes qui suivent le déploiement de l'OTA sur @Capgo.” [1]

3. Conflits de version

Conseils de maintenance

Utilisez

• les __CAPGO_KEEP_0__ analytics Capgo analytics Activez les retours automatiques pour les mises à jour qui pourraient causer des problèmes.
• Testez les demandes de tirage (PRs) en utilisant des sélecteurs de canal pour un meilleur contrôle.
• Maintenez votre workflow à jour avec les dernières commandes __CAPGO_KEEP_0__ __CAPGO_KEEP_1__.
• 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.

Conclusion

Key Highlights

L'intégration de Capgo avec GitHub Actions simplifie le processus de déploiement pour les applications Capgo applications Capacitor, offrant des bénéfices majeurs aux équipes de développement. Avec un taux de réussite global de 82 % pour les mises à jour et 95 % des utilisateurs actifs recevant des mises à jour dans les 24 heures [1], cette solution se démarque par son efficacité.

Voici quelques fonctionnalités notables :

• Flux de travail automatisé: En configurant les flux de travail directement dans GitHub Actions, il n'est pas nécessaire d'héberger un CI/CD externe. Cette approche réduit les coûts opérationnels, en économisant environ 26 100 $ sur cinq ans par rapport à des alternatives comme AppFlow [1].
• Déploiement rapide: Les mises à jour peuvent être poussées instantanément, en contournant les délais des magasins d'applications.
• Sécurité renforcée: La cryptage de bout en bout garantit que les mises à jour sont livrées de manière sécurisée, tandis que le système de canal de Capgo permet des déploiements contrôlés et étalés.

Les fonctionnalités de ces solutions préparent la voie à des solutions plus personnalisées et à une meilleure performance, comme on les explore plus bas.

Stratégies Avancées

Pour tirer le meilleur parti de votre intégration Capgo et GitHub Actions, explorez ces stratégies avancées :

• Flux de Travail personnalisés API: Utilisez le Capgo public API pour concevoir des flux de déploiement qui répondent aux besoins spécifiques de votre équipe. Cela peut permettre des expériences sans étiquette blanche et une intégration sans heurt avec vos outils actuels [1].
• Sorties basées sur les canaux: Optimisez votre processus de déploiement en utilisant les fonctionnalités de canal de Capgo pour des mises à jour étalées et contrôlées.
• Performance Optimisée: Utilisez les mises à jour partielles de Capgo pour réduire l'utilisation de la bande passante et accélérer les mises à jour. Avec 23,5 millions de mises à jour livrées sur 750 applications de production [1], le système a prouvé sa capacité à gérer des demandes à grande échelle.

Pour des résultats encore meilleurs, considérez l'utilisation des options d'hébergement auto-hébergé de Capgo ou des configurations de API personnalisées. Vérifiez les sections précédentes pour des instructions de mise en œuvre et de test détaillées pour mettre en œuvre pleinement ces stratégies.

Continuez de là avec l'intégration de Capgo avec les GitHub Actions : Guide

Si vous utilisez l'intégration de Capgo avec les GitHub Actions : Guide pour planifier la sécurité et la conformité, connectez-l’avec Chiffrement pour le détail d'implémentation dans Chiffrement, Conformité pour le détail d'implémentation dans Conformité, Capgo Scanner de sécurité pour le flux de travail du produit dans Capgo Scanner de sécurité, Capgo Sécurité pour le flux de travail du produit dans Capgo Sécurité, et Centre de confiance Capgo pour le flux de travail du produit dans le Centre de confiance Capgo.