Capgo Intégration avec GitHub Actions : Guide

Capgo et GitHub Actions simplifient ensemble la mise en production des mises à jour pour les Capacitor applications. Voici pourquoi cette intégration vaut la peine de votre attention :

• Économisez de l'argentRéduisez les coûts CI/CD de jusqu'à 26 100 $ sur 5 ans par rapport à AppFlow.
• Mises à jour rapidesDéployez des mises à jour instantanément avec 95 % des utilisateurs les recevant en 24 heures.
• Déploiements sécurisésLes mises à jour sont chiffrées de bout en bout, ce qui garantit leur sécurité.
• Flux de travail simplifiéAutomatisez les builds et les déploiements directement dans votre GitHub repository.

Aperçu rapide

1. Exigencesun compte GitHub un compte Capgo (à partir de 12 $/mois), projet Capacitor Node.js.
2. Configuration: Installer Capgo CLI avec npx @capgo/cli init, configurer les actions GitHub avec un flux de travail YAML.
3. Déploiement: Utiliser des commandes comme npx @capgo/cli deploy pour automatiser les mises à jour.
4. TestDéployez dans les canaux de test (par exemple, beta, étape de préparation) avant la production.

Flux de travail d'exemple (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 }}  

Cette intégration garantit des mises à jour d'applications rapides, sécurisées et rentables, ce qui la rend idéale pour les équipes de développement agile.

GitHub Actions Tutoriel - Concepts de base et pipeline CI/CD

Exigences de configuration

Intégrer Capgo avec GitHub Actions implique de configurer les outils et les paramètres nécessaires.

Outils et comptes requis

Assurez-vous 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 live automatiques.

Ajouter Capgo __CAPGO_KEEP_0__ Interface de mise à jour live

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

“Exécutez npx @capgo/cli init, ça marche !” [1]

Cette commande configure le plugin et ses dépendances requises.

Configuration du référentiel GitHub

Préparez votre GitHub pour qu'il satisfasse aux exigences d'intégration CI/CD avec Capgo. Comme mentionné dans leur documentation :

“Nous configurons votre pipeline CI/CD directement sur votre plateforme préférée, qu'il s'agisse d'GitHub Actions, GitLab CI ou d'autres. Nous ne hébergeons pas CI/CD ni ne vous facturons pour le maintenir.” [1]

Capgo propose des mises à jour OTA à partir de 12$/mois, ce qui est plus abordable que le tarif annuel de 6 000$ d'AppFlow [1]Pour les équipes ayant besoin d'une CI/CD automatisée pour construire des applications natives, un service de configuration facultatif est disponible pour 2 600 $ une fois.

Voici comment configurer votre dépôt :

• Structure du Répertoire de Référence: Organisez votre dépôt avec des dossiers séparés pour les sources code, les ressources et les fichiers de configuration pour garder tout propre et gérable.
• Configuration de l'environnementCréez des environnements distincts pour le développement, la mise en production 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 d'accès: Fixezz les permissions du dépôt avec soin pour autoriser Intégration Capgo en maintenant la sécurité.

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

GitHub Actions Workflow Setup

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

Création du Fichier de Flux de Travail

Commencez par créer 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 de travail.

Options de Déclencheurs de Flux de Travail

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

Gérer les clés secrètes

Pour s'assurer des déploiements sécurisés, vous devez gérer vos clés secrètes de manière appropriée. GitHub Actions offre un système de gestion des secrets chiffrés à cette fin.

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

1. Accéder aux paramètres du dépôt
   Allez dans les paramètres de votre dépôt et trouvez la section « Secrets et variables » sous l'onglet « Sécurité ».

2. Ajouter Capgo Identifiants
   Enregistrez votre jeton d'authentification Capgo en tant que secret de dépôt. 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 flux de travail

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 flux de travail pour installer le 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 de manière sécurisée le CLI en utilisant le 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 :

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

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

This setup ensures that your updates are automatically built, versioned, and deployed whenever the workflow runs. GitHub’s secret management system keeps your credentials safe throughout the process.

Exécution de flux de travail de test

Vous pouvez tester votre flux de travail d'actions __CAPGO_KEEP_0__ en utilisant un canal dédié

You can test your GitHub Actions workflow by using a dedicated Le système de canaux de Capgo vous aide à créer des chemins de déploiement séparés pour différentes étapes :Canaux de déploiement

- 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 de réparation d'erreurs

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

1. Échecs d'authentification

Vérifiez le CAPGO_TOKEN dans GitHub Secrets. Si il est expiré, régénérez-le pour garantir une authentification fluide.

2. Erreurs de construction

Assurez-vous que votre configuration de construction 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 suivant le déploiement de la mise à jour OTA sur @Capgo.” [1]

3. Conflits de versions

Utilisez la versionnement semantique et augmentez les versions correctement pour prévenir les conflits lors des déploiements.

Conseils de maintenance

• Utilisez les analyses Capgo surveiller les taux de réussite des mises à jour.
• Activer les retours automatiques pour les mises à jour qui pourraient causer des problèmes.
• Tester les demandes de tirage (PR) en utilisant des sélecteurs de canal pour un meilleur contrôle.
• Tenir votre flux de travail à jour avec les dernières commandes Capgo CLI.

Pour les déploiements de haute priorité, profitez des fonctionnalités de suivi d'erreurs de Capgo pour détecter les problèmes potentiels en amont. Si quelque chose se produit mal, la fonctionnalité de retrait permet de revenir à une version stable rapidement, minimisant ainsi les perturbations. Ces pratiques aideront à maintenir vos déploiements en cours de route tout en vous rapprochant de la production.

Conclusion

Points clés

Capgo’s intégration avec GitHub Actions simplifie le processus de déploiement pour les applications Capgo Capacitor apps, cette solution se démarque par son efficacité. [1]Voici quelques fonctionnalités phares :

Voici quelques fonctionnalités phares :

• Flux de travail automatisé: En configurant les flux de travail directement dans les Actions GitHub, il n'est pas nécessaire d'héberger un CI/CD externe. Cette approche réduit les coûts opérationnels, é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 ignorant les retards des magasins d'applications
• Sécurité solide: L'encryption de bout en bout s'assure 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 étalonnés

Ces fonctionnalités ouvrent la voie à des solutions plus personnalisées et à une meilleure performance, explorées plus en détail ci-dessous

Stratégies avancées

Pour tirer le maximum de votre Capgo et de l'intégration de ses Actions avec GitHub, explorez ces tactiques avancées :

• Flux de travail personnalisé API: Utilisez les Capgo publics 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 étiquetage et une intégration fluide avec vos outils actuels [1].
• Lancements basés sur les canauxOptimisez votre processus de déploiement en utilisant les fonctionnalités de canal de Capgo pour des mises à jour étalées et contrôlées.
• Performances OptimiséesUtilisez les mises à jour partielles de Capgo pour réduire la consommation de bande passante et accélérer les mises à jour. Avec 23,5 millions de mises à jour délivrées dans 750 applications de production [1], le système a prouvé sa capacité à gérer des demandes à grande échelle.

Pour des résultats encore meilleurs, envisagez d'utiliser les options d'hébergement auto-hôte de Capgo ou des configurations personnalisées de API. Consultez les sections précédentes pour obtenir des instructions détaillées de configuration et de test pour mettre en œuvre pleinement ces stratégies.