Capgo Intégration avec GitHub Actions : Guide

Capgo et GitHub Actions faciliter ensemble le déploiement des mises à jour pour Capacitor Les applications. Voici pourquoi cette intégration vaut la peine de votre attention :

• Économisez de l'argent: 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 qui les reçoivent en 24 heures.
• Déploiements sécurisés: La cryptage de bout en bout garantit que les mises à jour sont sûres.
• Flux de travail simplifié: Automate builds and deployments directly in votre GitHub repository.

Vue d'ensemble rapide

1. Exigences: Un compte GitHub, Un compte Capgo (à partir de 12 $/mois), un projet Capacitor, Node.js.
2. Configuration: Installez Capgo CLI avec npx @capgo/cli init, configurez les 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 sur des canaux de test (par exemple, bêta, é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 Guide de formation - Concepts de base et pipeline CI/CD

Configuration requise

Intégration de Capgo L'intégration de GitHub avec les actions de GitHub nécessite la configuration des outils et des 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 en temps réel automatiques.

Ajouter Capgo à Votre Projet

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

“Exécutez npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ init, voilà !”

GitHub Repository Setup

Prepare your GitHub repository to meet the requirements for CI/CD integration with Capgo.

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

Avant d'ajouter le workflow, 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.

• Capgo plans start at $12/month.
• Les plans __CAPGO_KEEP_0__ commencent à 12 $/mois.
• Le même plan comprend les mises à jour OTA et environ 15 lancements natifs par mois.

Les minutes supplémentaires de build sont facturées par minute à l'aide de crédits.

• Structure du Répertoire: Organisez votre répertoire avec des dossiers séparés pour les sources 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 en place.
• Gestion des Accès: Fixez les permissions du répertoire avec soin pour autoriser Capgo intégration alors que vous maintenez la sécurité.

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

GitHub Actions Flux de Travail de Configuration

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

Créer le Fichier de Flux

Démarrer 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.

Options de déclencheurs de Flux

les GitHub Actions vous permettent 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. Le système de gestion des secrets GitHub Actions offre un système de secrets chiffrés à cet effet.

Étapes pour Configurer une Authentification Sûre:

1. Accéder aux Paramètres du Répertoire
   Allez dans les paramètres de votre répertoire 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 répertoire. Nommez-le CAPGO_TOKEN.

3. Référencer les Secrets dans les Flux de Travail
   Utilisez vos secrets stockés dans le flux de travail 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 à l'aide de CAPGO_TOKEN:

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

Commandes de déploiement

Ici sont présentées 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 }}

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.

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é ce canal de test CapgoCela vous permet de valider les mises à jour avant qu'elles ne soient mises en ligne.

- 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 séparés pour différentes étapes :

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

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

Conseils de maintenance

• Utilisez Capgo analytics pour surveiller les taux de réussite des mises à jour.
• 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.
• Gardez votre workflow à jour avec les derniers commandes Capgo CLI.

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

Key Highlights

Capgo’s intégration avec GitHub Actions simplifie le processus de déploiement pour Capacitor apps, 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 sont présentés quelques-uns des principaux avantages :

• 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.

Ceux-ci ouvrent la voie à des solutions plus personnalisées et à une meilleure performance, comme on peut le voir plus bas.

Stratégies Avancées

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

• Flux de travail personnalisé API: Utilisez le public API de Capgo pour concevoir des flux de déploiement qui correspondent 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].
• Déploiements basés 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 la consommation de bande passante et accélérer les mises à jour. Avec 23,5 millions de mises à jour livrées sur 750 applications de production, le système a prouvé sa capacité à gérer des demandes à grande échelle. [1]Pour des résultats encore meilleurs, considérez l'utilisation des options d'hébergement auto-hébergé de __CAPGO_KEEP_0__ ou des configurations de __CAPGO_KEEP_1__ personnalisées. Consultez les sections précédentes pour obtenir des instructions détaillées de mise en place et de test pour mettre en œuvre pleinement ces stratégies.

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 de Capgo L'intégration avec GitHub Actions: Guide

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