Capgo Intégration avec GitHub Actions : Guide

Capgo et GitHub Actions et simplifier le déploiement des mises à jour pour Capacitor En économisant de l'argent

• : Économisez 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és
• apps. Voici pourquoi cette intégration vaut la peine de votre attention :Chiffrement de bout en bout garantit la sécurité des mises à jour.
• Flux de travail simplifié.Automatiser les builds et les déploiements directement dans votre GitHub.

Vue d'ensemble rapide.

1. Exigences.Un compte GitHub (à partir de 12 $/mois), un projet GitHub Capgo account (from $12/month), Capacitor project, context : Page/zone : Capgo Builder / produit de construction native dans la nuage. Rôle : Sujet de section ou tagline. Clé de message `native_build_builder_setup_eyebrow` (Configuration de la construction native Builder Eyebrow). | Page/zone : Capgo Builder / produit de construction native dans la nuage. Rôle : Étiquette de navigation ou élément de navigation court. Vu dans : page native-build.astro. Clé de message `native_build_v2_strip_setup_k` (Configuration de la construction native V2 Strip Setup K)..
2. : Installer: __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 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 contexte : Page/zone : Page de produit de mises à jour en temps réel. Rôle : Étiquette de navigation ou élément de l'IHM court. Clé de message `live_update_dynamic_label_to` (Étiquette dynamique de mise à jour en temps réel)..
4. automatiser les mises à jourTest

: Déployez dans 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 }}  

Exemple de flux de travail (YAML)

GitHub Actions __CAPGO_KEEP_0__ Actions

Exigences de configuration

Integrating Capgo with GitHub Actions involves setting up the necessary tools and configurations.

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

Pour intégrer 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 cela !” [1]

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

GitHub Paramétrage de la référence

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

Avant d'ajouter le flux de travail, confirmez que la référence dispose des secrets requis, des protections de branchement et des déclencheurs de déploiement pour votre processus d'actualisation OTA.

Prix

• Les plans Capgo commencent à 12 $/mois.
• Le même plan comprend les mises à jour OTA et environ 15 constructions natives par mois.
• Les minutes de construction supplémentaires sont facturées par minute à l'aide de crédits.

Voici comment configurer votre dépôt :

• Structure du dépôt: Organisez votre dépôt en utilisant des dossiers séparés pour le code source code, les ressources 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 production et la production, en veillant à ce que les contrôles d'accès et les mesures de sécurité soient corrects.
• Gestion des accès: Définissez les permissions du dépôt avec soin pour autoriser Capgo intégration en maintenant la sécurité.

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

Configuration du flux de travail GitHub Actions

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

Créer le Fichier de Flux

Démarrer 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 le fichier configuré, 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 vos clés secrètes de manière appropriée. GitHub Actions offre un système de gestion de secrets chiffrés à cette fin.

Étapes pour Configurer une Authentification Sécure :

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

Once your GitHub Actions environment is set up, you can automate deployments by integrating Capgo CLI commands.

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 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 GitHub Actions en utilisant un canal dédié Capgo testing channelLe 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

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

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) à l'aide de sélecteurs de canal pour un meilleur contrôle.
• Maintenez 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 des erreurs de Capgo pour détecter les problèmes potentiels en amont. Si quelque chose se produit mal, la fonctionnalité de reversion vous permet de revenir à une version stable rapidement, minimisant ainsi les perturbations. Ces pratiques aideront à maintenir vos déploiements en cours de manière fluide 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 applications, 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é.

Voici quelques fonctionnalités phares :

• Flux de travail automatisé: En configurant les flux de travail directement dans GitHub Actions, il n'est pas nécessaire d'héberger les CI/CD externes. 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 envoyées instantanément, en contournant les délais des magasins d'applications.
• Fortes Sécurités: 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.

Stratégies Avancées

Pour obtenir le meilleur de votre intégration __CAPGO_KEEP_0__ et __CAPGO_KEEP_1__ d'Actions, explorez ces stratégies avancées :

To get the most out of your Capgo and GitHub Actions integration, explore these advanced tactics:

• : Utilisez le __CAPGO_KEEP_1__ public de 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.: Use Capgo’s public API to design deployment workflows that fit your team’s specific needs. This can enable white-label experiences and seamless integration with your current tools [1].
• : Optimisez votre processus de déploiement en utilisant les fonctionnalités de canal de __CAPGO_KEEP_0__ pour des mises à jour étalées et contrôlées.: Optimize your deployment process by using Capgo’s channel features for staged and controlled updates.
• : Utilisez les mises à jour partielles de __CAPGO_KEEP_0__ 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 productionCapgo [1]Pour un meilleur résultat, envisagez d'utiliser les options d'hébergement auto-hôte de __CAPGO_KEEP_0__ ou des configurations personnalisées de __CAPGO_KEEP_1__. 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.

Intégration de Capgo avec API Actions : Guide

Keep going from Capgo Integration with GitHub Actions: Guide

Intégration de __CAPGO_KEEP_0__ avec __CAPGO_KEEP_1__ Actions : Guide Capgo Integration with GitHub Actions: Guide Chiffrement pour le détail d'implémentation dans Chiffrement Conformité pour le détail d'implémentation dans Conformité Scanner de sécurité de __CAPGO_KEEP_0__ pour le flux de travail du produit dans Scanner de sécurité de Capgo for the product workflow in Capgo Security Scanner, 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.