Intégration des pipelines Bitbucket

Intégrez les mises à jour en direct Capgo avec Bitbucket Pipelines pour déployer automatiquement les mises à jour de votre application chaque fois que vous poussez code des modifications. Ce guide couvre la configuration des workflows de build automatique, de test et de déploiement.

Prérequis

Avant de configurer l'intégration Bitbucket Pipelines, assurez-vous d'avoir :

• Un compte Bitbucket avec un dépôt
• Un compte Capgo avec une application configurée
• Node.js et npm/yarn configurés dans votre projet

Configuration de Bitbucket Pipelines

Étape 1 : Configurez les variables de dépôt

Configurez d'abord les variables nécessaires dans votre dépôt Bitbucket :

1. Accédez à votre dépôt Bitbucket
2. Allez à Paramètres de dépôt → Flux de travail → Variables de dépôt
3. Ajoutez les variables suivantes :

Nom de la variable	Valeur	Sécurisé
CAPGO_TOKEN	Votre Capgo API jeton	✅ Oui

Conseil

Obtenez votre jeton Capgo API depuis console.capgo.app/apikeysVotre ID d'application est déjà configuré dans votre capacitor.config.ts fichier.

Simple

Configuration de base qui déploie en production à chaque push vers la branche principale :

# bitbucket-pipelines.yml - Simple Configuration
image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Build and Deploy to Production
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
          artifacts:
            - dist/**

Avancé

Déploiements de branches de fonctionnalité

Déployez les branches de fonctionnalité dans les canaux de test pour la revue et les tests :

# Feature branch deployment
pipelines:
  branches:
    feature/*:
      - step:
          name: Deploy Feature Branch
          script:
            - npm ci
            - npm run test
            - npm run build
            - BRANCH_NAME=$(echo $BITBUCKET_BRANCH | sed 's/[^a-zA-Z0-9-]/-/g')
            - CHANNEL_NAME="feature-$BRANCH_NAME"
            - npm install -g @capgo/cli
            - npx @capgo/cli channel create $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
          artifacts:
            - dist/**

Conseil

Test avec les canaux : Après le déploiement dans un canal de fonctionnalité, vous pouvez tester la mise à jour dans votre application en la configurant pour utiliser ce canal spécifique. En savoir plus sur la configuration des canaux dans votre application Utilisation de l'encryption.

Section intitulée « Utilisation de l'encryption »

Si vous utilisez Capgo's fonction de chiffrement, vous devrez stocker votre clé privée de manière sécurisée dans votre environnement CI/CD.

Après la mise en place des clés de chiffrement en local, ajoutez votre clé privée aux variables Bitbucket :

# Display your private key content (copy this output)
cat .capgo_key_v2

Ajoutez ce contenu comme CAPGO_PRIVATE_KEY dans les variables de votre référentiel Bitbucket (marquez comme sécurisé), puis utilisez-le dans les pipelines :

# Deploy with encryption
- step:
    name: Deploy to Capgo with Encryption
    script:
      - npm install -g @capgo/cli
      - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --key-data-v2 "$CAPGO_PRIVATE_KEY" --channel production

Attention

Meilleures pratiques de sécurité :

• Ne jamais commiter le .capgo_key_v2 fichier à la gestion de version
• Stockez la clé privée uniquement dans une gestion sécurisée de secrets CI/CD
• Utilisez des clés différentes pour différents environnements

Configuration multimédia

Pour obtenir des informations complètes sur la configuration et la gestion de plusieurs canaux de déploiement, consultez la documentation des canaux.

Configuration complète avec plusieurs environnements et déploiements de demande de tirage :

# bitbucket-pipelines.yml - Advanced Multi-Channel Configuration
image: node:22

definitions:
  steps:
    - step: &build-step
        name: Build Application
        script:
          - npm ci
          - npm run test
          - npm run build
        artifacts:
          - dist/**

    - step: &deploy-step
        name: Deploy to Capgo
        script:
          - npm install -g @capgo/cli
          - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

pipelines:
  branches:
    main:
      - step:
          <<: *build-step
      - step:
          <<: *deploy-step
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - export CHANNEL_NAME=production
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

    develop:
      - step:
          <<: *build-step
      - step:
          <<: *deploy-step
          name: Deploy to Development
          deployment: development
          script:
            - export CHANNEL_NAME=development
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME

  pull-requests:
    '**':
      - step:
          <<: *build-step
      - step:
          name: Deploy PR to Test Channel
          script:
            - CHANNEL_NAME="pr-$BITBUCKET_PR_ID"
            - npm install -g @capgo/cli
            - npx @capgo/cli channel create $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
          artifacts:
            - dist/**

Pipeline Multi-Environnement

Pour les scénarios de déploiement complexes avec des environnements de mise en ligne et de production :

# Multi-environment pipeline
image: node:22

pipelines:
  branches:
    main:
      - step:
          name: Build
          script:
            - npm ci
            - npm run test
            - npm run build
          artifacts:
            - dist/**
      - step:
          name: Deploy to Staging
          deployment: staging
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel staging
      - step:
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

    develop:
      - step:
          name: Build and Deploy to Development
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel development
          artifacts:
            - dist/**

Stratégie de déploiement basée sur la branche

Déployer automatiquement différentes branches sur les canaux appropriés :

# Dynamic channel deployment
image: node:22

definitions:
  scripts:
    - script: &determine-channel |
        if [ "$BITBUCKET_BRANCH" = "main" ]; then
          export CHANNEL_NAME="production"
        elif [ "$BITBUCKET_BRANCH" = "develop" ]; then
          export CHANNEL_NAME="staging"
        else
          export CHANNEL_NAME="development"
        fi
        echo "Deploying to channel: $CHANNEL_NAME"

pipelines:
  default:
    - step:
        name: Build and Deploy
        script:
          - npm ci
          - npm run test
          - npm run build
          - *determine-channel
          - npm install -g @capgo/cli
          - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
        artifacts:
          - dist/**

Exécution parallèle de la pipeline

Optimiser les temps de construction avec des étapes parallèles :

# Parallel execution pipeline
image: node:22

pipelines:
  branches:
    main:
      - parallel:
          - step:
              name: Run Tests
              script:
                - npm ci
                - npm run test
          - step:
              name: Lint Code
              script:
                - npm ci
                - npm run lint
      - step:
          name: Build Application
          script:
            - npm ci
            - npm run build
          artifacts:
            - dist/**
      - step:
          name: Deploy to Production
          deployment: production
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

Pratiques de Sécurité

Variables du Répertoire

1. : Toujours marquer les jetons __CAPGO_KEEP_0__ comme sécurisés: Always mark API tokens as secured
2. : Utilisez les variables spécifiques à la mise en production lorsque cela est nécessaireContrôle d'Accès
3. : Limitez l'accès au répertoire aux membres de l'équipe autorisésRotation de Jetons
4. : Rotez régulièrement vos jetons __CAPGO_KEEP_0__ __CAPGO_KEEP_1__: Regularly rotate your Capgo API tokens

Environnements de déploiement

Configurez les environnements de déploiement pour une meilleure sécurité :

# Deployment with environment restrictions
pipelines:
  branches:
    main:
      - step:
          name: Deploy to Production
          deployment: production
          trigger: manual
          script:
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

Surveillance et Notifications

Intégration Slack

Ajoutez des notifications Slack à votre pipeline :

# Pipeline with Slack notifications
pipelines:
  branches:
    main:
      - step:
          name: Build and Deploy
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
          after-script:
            - |
              if [ $BITBUCKET_EXIT_CODE -eq 0 ]; then
                curl -X POST -H 'Content-type: application/json' \
                  --data '{"text":"✅ Capgo deployment successful for '$BITBUCKET_BRANCH'"}' \
                  $SLACK_WEBHOOK_URL
              else
                curl -X POST -H 'Content-type: application/json' \
                  --data '{"text":"❌ Capgo deployment failed for '$BITBUCKET_BRANCH'"}' \
                  $SLACK_WEBHOOK_URL
              fi

Notifications par e-mail

Configurez les notifications par e-mail à l'aide des fonctionnalités intégrées de Bitbucket ou en utilisant des services externes :

# Email notification step
- step:
    name: Send Notification
    script:
      - |
        curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "to": "team@yourcompany.com",
            "subject": "Capgo Deployment Status",
            "body": "Deployment of '$BITBUCKET_BRANCH' completed with status: '$BITBUCKET_EXIT_CODE'"
          }' \
          $EMAIL_SERVICE_URL
    condition:
      result: [successful, failed]

Résolution des problèmes

Problèmes courants

La pipeline échoue avec « Capgo CLI non trouvé » :

# Debug CLI installation
- step:
    name: Debug CLI
    script:
      - npm install -g @capgo/cli
      - which capgo || echo "Capgo CLI not found"
      - npx @capgo/cli --version

Erreurs d'authentification :

# Verify token configuration
- step:
    name: Debug Auth
    script:
      - |
        if [ -z "$CAPGO_TOKEN" ]; then
          echo "CAPGO_TOKEN is not set"
          exit 1
        fi
        echo "Token length: ${#CAPGO_TOKEN}"

Les artefacts de construction ne sont pas trouvés :

# List build outputs
- step:
    name: Debug Build
    script:
      - ls -la dist/
      - find dist/ -type f -name "*.js" -o -name "*.html"

Pipelines de Débogage

Ajoutez des informations de débogage pour résoudre les problèmes :

# Debug pipeline
pipelines:
  branches:
    main:
      - step:
          name: Debug Information
          script:
            - echo "Branch: $BITBUCKET_BRANCH"
            - echo "Commit: $BITBUCKET_COMMIT"
            - echo "Build: $BITBUCKET_BUILD_NUMBER"
            - env | grep BITBUCKET_ | sort
      - step:
          name: Build and Deploy
          script:
            - npm ci
            - npm run test
            - npm run build
            - npm install -g @capgo/cli
            - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production

Validation de la Pipeline

Activez la validation de la pipeline pour détecter les erreurs de configuration :

# Enable pipeline validation
options:
  docker: true
  size: 2x

pipelines:
  branches:
    main:
      - step:
          name: Validate Pipeline
          script:
            - echo "Pipeline validation successful"
      - step:
          name: Build and Deploy
          script:
            # ... deployment steps

Étapes suivantes

• Apprenez-en plus sur Canaux pour gérer différents environnements de déploiement
• Explore Stockage personnalisé pour des scénarios de déploiement avancés
• Configurer Chiffrement pour des déploiements sécurisés
• Configurer Mise à jour de comportement pour personnaliser la façon dont les mises à jour sont appliquées

Avec l'intégration de Bitbucket Pipelines, vous pouvez automatiser vos Capgo déploiements et vous assurer d'une mise à jour cohérente et fiable pour vos utilisateurs de l'application mobile.