Intégration de Capgo avec GitHub Actions : guide

Capgo et GitHub Actions GitHub simplifier ensemble le déploiement des mises à jour pour Capacitor les apps. Voici pourquoi cette intégration mérite votre attention :

• Save Money: Réduisez vos coûts CI/CD jusqu'à 26 100 $ sur 5 ans par rapport à AppFlow.
• Mises à jour rapides: Déployez des mises à jour instantanément avec 95 % des utilisateurs qui les reçoivent en 24 heures.
• Déploiements sécurisés: Le chiffrement de bout en bout garantit la sécurité des mises à jour.
• Workflow optimisé: Automatisez vos builds et déploiements directement dans votre dépôt GitHub.

Aperçu rapide

1. Prérequis: compte GitHub, compte Capgo (à partir de 12 $/mois), un projet Capacitor, Node.js.
2. Configuration: Installer Capgo CLI par npx @capgo/cli init, configurez GitHub Actions avec un workflow YAML.
3. Déploiement: Utilisez des commandes comme npx @capgo/cli deploy vers automatiser les mises à jour.
4. En test: Déployez sur des canaux de test (ex: beta, staging) avant la production.

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

Cette intégration garantit des mises à jour d'app rapides, sécurisées et économiques, l'idéal pour les équipes de développement agiles.

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

Prérequis de configuration

Intégrer Capgo avec GitHub Actions nécessite la configuration des outils et paramètres nécessaires.

Outils et comptes requis

Assurez-vous d'avoir les comptes et outils suivants prêts :

Une fois ces éléments en place, vous pouvez ajouter Capgo à votre projet pour des live updates automatisés.

Ajouter Capgo à votre projet

Pour intégrer Capgo, installez-le dans votre projet Capacitor via son outil CLI. Selon Martin Donadieu, fondateur de Capgo :

« Lancez npx @capgo/cli init et c'est prêt ! » [1]

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

Configuration du dépôt GitHub

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

Avant d'ajouter le workflow, confirmez que le dépôt possède les secrets, les protections de branche et les déclencheurs de déploiement requis pour votre processus de release OTA.

Tarifs

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

Voici comment configurer votre dépôt :

• Structure du dépôt: Organisez votre dépôt avec des répertoires distincts pour le code source, les assets et les fichiers de configuration afin de tout garder propre et gérable.
• Configuration de l'environnement: Créez des environnements distincts pour le développement, la staging et la production, tout en garantissant des contrôles d'accès et des mesures de sécurité appropriés.
• Gestion des accès: Configurez les permissions du dépôt avec soin pour permettre l'intégration Capgo tout en maintenant la sécurité.

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

Configuration du workflow GitHub Actions

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

Création du fichier de workflow

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 le fichier configuré, choisissez les bons déclencheurs pour votre workflow.

Options de déclenchement du workflow

GitHub Actions vous permet de personnaliser le moment où les workflows s’exécutent. Voici quelques options de déclenchement :

Gestion des clés secrètes

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

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

1. Accéder aux paramètres du dépôt
   Rendez-vous dans les paramètres de votre dépôt et trouvez la section « Secrets and variables » sous l'onglet « Security ».

2. Ajoutez Identifiants Capgo
   Enregistrez votre token 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 ainsi : ${{ secrets.CAPGO_TOKEN }}.

Commandes Capgo dans les workflows

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

Installer Capgo CLI

Ajoutez l'étape suivante à votre workflow 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 CLI

Authentifiez en toute sécurité 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 le build, le versioning et le déploiement de vos mises à jour :

Pour automatiser tout le processus de déploiement, utilisez les commandes ensemble comme ceci :

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

Cette configuration garantit que vos mises à jour sont automatiquement buildées, versionnées et déployées à chaque exécution du workflow. Le système de gestion des secrets de GitHub protège vos identifiants tout au long du processus.

Tests et correctifs

Exécuter des workflows de test

Vous pouvez tester votre workflow GitHub Actions en utilisant un canal de test Capgo. Cela vous permet de valider les mises à jour avant leur déploiement.

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

Le système de canaux de Capgo vous aide à créer des chemins de déploiement distincts pour chaque étape :

Solutions aux erreurs

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

1. Échecs d'authentification

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

2. Erreurs de build

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

« Nous avons déployé des Capgo mises à jour OTA en production pour notre base de +5000 utilisateurs. Le fonctionnement est très fluide : presque tous nos utilisateurs sont à jour quelques minutes seulement après le déploiement de l'OTA sur @Capgo. » [1]

3. Conflits de version

Respectez le versionnage sémantique et incrémentez correctement les versions pour éviter les conflits lors des déploiements.

Conseils de maintenance

• Utiliser Analytics Capgo pour surveiller le taux de réussite des mises à jour.
• Activez les rollbacks automatiques pour les mises à jour susceptibles de poser problème.
• Testez les pull requests (PR) avec les sélecteurs de canaux pour un meilleur contrôle.
• Gardez votre workflow à jour avec les dernières commandes Capgo CLI.

Pour les déploiements prioritaires, profitez du suivi des erreurs de Capgo pour repérer les problèmes potentiels en amont. En cas de souci, le rollback vous permet de revenir rapidement à une version stable, en limitant la perturbation. Ces bonnes pratiques vous aideront à garder des déploiements fluides à l'approche de la production.

Conclusion

Points clés

L'intégration de Capgo avec GitHub Actions simplifie le déploiement pour apps Capacitor, offrant des avantages majeurs aux équipes de développement. Avec un taux de réussite mondial de 82 % pour les mises à jour et 95 % des utilisateurs actifs recevant les mises à jour sous 24 heures [1], cette solution se distingue par son efficacité.

Voici quelques fonctionnalités phares :

• Workflows automatisés: En configurant les workflows directement dans GitHub Actions, aucun hébergement CI/CD externe n'est nécessaire. Cette approche réduit les coûts opérationnels, permettant d'économiser environ 26 100 $ sur cinq ans par rapport à des alternatives comme AppFlow [1].
• Déploiement rapide: Les mises à jour peuvent être déployées instantanément, évitant les délais des stores.
• Sécurité renforcée: Le chiffrement de bout en bout garantit la sécurité des mises à jour, tandis que le système de canaux de Capgo permet des déploiements progressifs contrôlés.

Ces fonctionnalités ouvrent la voie à des solutions plus personnalisées et à de meilleures performances, détaillées ci-dessous.

Stratégies avancées

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

• Workflows API personnalisés: Utilisez l’API public de Capgo pour concevoir des workflows de déploiement adaptés aux besoins spécifiques de votre équipe. Cela permet de proposer des expériences en marque blanche et une intégration fluide avec vos outils actuels. [1].
• Releases par canalOptimisez votre processus de déploiement en utilisant les fonctionnalités de canaux de Capgo pour des mises à jour progressives et contrôlées.
• Performances optimisées: Profitez des mises à jour partielles de Capgo pour réduire la bande passante et accélérer les mises à jour. Avec 23,5 millions de mises à jour livrées sur 750 applications en production [1], le système a prouvé sa capacité à gérer des demandes à grande échelle.

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

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

Si vous utilisez Intégration de Capgo avec GitHub Actions : guide pour planifier la sécurité et la conformité, connectez-l’à Chiffrement pour les détails d'implémentation du chiffrement, Conformité pour les détails d'implémentation de la conformité, Scanner de sécurité Capgo pour le workflow produit dans Capgo Security Scanner, Capgo et la sécurité pour le workflow produit dans Capgo Security, et Capgo Centre de confiance pour le workflow produit dans Capgo Trust Center.