Intégration de Capgo avec GitHub Actions: Guide

Capgo et GitHub Actions faciliter ensemble la mise à jour de déploiements Capacitor Les applications. Voici pourquoi cette intégration vaut la peine de votre attention :

• Save Money: Réduisez les coûts CI/CD de jusqu'à 26 100 $ sur 5 ans par rapport à AppFlow.
• Mises à jour rapides: Envoyez des mises à jour instantanément avec 95 % des utilisateurs les recevant en 24 heures.
• Déploiements sécurisésL'encryption de bout en bout garantit la sécurité des mises à jour.
• Flux de travail simplifié: Automatisez les builds et les déploiements directement dans votre GitHub repository.

Aperçu rapide

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

Flux 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 les GitHub Actions, il s'agit 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 ajouter Capgo à votre projet pour des mises à jour automatiques.

Ajouter Capgo à Votre Projet

Intégrez Capgo, installez-le dans votre projet Capacitor à l'aide de son outil CLI. Selon Martin Donadieu, fondateur de Capgo:

“Exécutez npx @capgo/cli init, voilà !” [1]

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

Configuration du Répertoire de GitHub

Préparez votre GitHub pour qu'il répond aux exigences d'intégration CI/CD avec Capgo.

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

Prix

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

Voici comment configurer votre dépôt.

• Structure de Répertoire: Organize your repository with separate directories for source code, assets, and configuration files to keep everything clean and manageable.
• Structure du dépôt: Organisez votre dépôt avec des dossiers séparés pour les sources __CAPGO_KEEP_0__, les actifs et les fichiers de configuration pour garder tout propre et gérable.
• Gestion d'accès: Fixez les permissions de votre dépôt avec soin pour autoriser Capgo intégration en maintenant la sécurité.

Ces étapes vous aideront à préparer votre projet pour le flux de travail GitHub Actions, qui sera décrit dans la section suivante.

GitHub Flux de travail Actions Setup

Automatisez vos 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 le fichier configuré, sélectionnez les bonnes déclencheurs pour votre workflow.

Options de déclenchement du workflow

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

Gestion des clés secrètes

Pour assurer des déploiements sécurisés, vous devez gérer correctement vos clés secrètes. GitHub Actions propose 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 Répertoire
   Allez dans les paramètres de votre dépôt et trouvez la section « Secrets et variables » sous l'onglet « Security ».

2. Ajouter Capgo Credentials
   Enregistrez votre jeton d'authentification Capgo en tant que secret de votre référentiel. Nommez-le CAPGO_TOKEN.

3. Référencez 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.

Installation de 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

Authentification de CLI

Authentifiez de manière sécurisée 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 }}

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 GitHub garde vos informations d'identification en toute sécurité tout au long du processus.

Tests et corrections

Exécution des workflows de test

Vous pouvez tester votre GitHub workflow d'Actions en utilisant un environnement dédié. Capgo canal de testCela vous permet de valider les mises à jour avant leur mise en ligne.

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

Capgo’s système de chaîne aide à créer des chemins de déploiement séparés pour différentes étapes :

Solutions d'erreurs

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 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é les 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 versions

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

Conseils de maintenance

• Utilisez Capgo analytics suivre les taux de réussite des mises à jour.
• Activez les retours automatiques pour les mises à jour potentiellement problématiques.
• Tester les demandes de tirage (PR) à l'aide de sélecteurs de chaînes pour un meilleur contrôle.
• Maintenez votre workflow à jour avec les derniers commandes Capgo CLI.

Pour les déploiements de haute priorité, profitez des fonctionnalités de suivi des 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

L'intégration de Capgo avec les Actions de GitHub simplifie le processus de déploiement. applications 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 des mises à jour dans les 24 heures. [1]Cette solution se démarque par son efficacité.

Ici, voici quelques fonctionnalités notables :

• Flux de travail automatisé: En configurant les flux de travail directement dans les Actions de GitHub, 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: Updates can be pushed instantly, bypassing app store delays.
• Sécurité renforcée: L'encryption 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.

Ces fonctionnalités ouvrent la voie à des solutions plus personnalisées et à une meilleure performance, comme expliqué ci-dessous.

Stratégies avancées

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

• Flux de travail personnalisé de API: Utilisez le public API de Capgo 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 le canalOptimisez 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ées: Utilisez 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 sur 750 applications de production. [1]La système a démontré sa capacité à gérer des demandes à grande échelle.

For even better results, consider using Capgo’s self-hosting options or custom API setups. Check earlier sections for detailed setup and testing instructions to fully implement these strategies.

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

: Si vous utilisez : l'intégration de Capgo avec GitHub Actions : Guide : pour planifier la sécurité et la conformité, connectez-l’avec : l'Encryption pour les détails d'implémentation dans l'Encryption, Conformité pour les détails d'implémentation dans la 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 Capgo Centre de confiance pour le flux de travail du produit dans Capgo Centre de confiance.