Integrazione Bitbucket Pipelines
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Integra Capgo Live Updates con Bitbucket Pipelines per distribuire automaticamente gli aggiornamenti della tua app ogni volta che esegui il push di modifiche a code. Questa guida illustra come configurare build automatizzate, test e workflow di deployment.
Prerequisiti
Sezione intitolata “Prerequisiti”Prima di configurare l'integrazione con Bitbucket Pipelines, assicurati di avere:
- Un account Bitbucket con un repository
- Un account Capgo con un'app configurata
- Node.js e npm/yarn configurati nel tuo progetto
Configurazione di Bitbucket Pipelines
Sezione dal titolo “Configurazione di Bitbucket Pipelines”Passaggio 1: Configura le variabili del repository
Sezione intitolata “Passo 1: Configura le variabili del repository”Innanzitutto, configura le variabili necessarie nel tuo repository Bitbucket:
- Vai al tuo repository Bitbucket
- Vai su Impostazioni del repository → Pipeline → Variabili del repository
- Aggiungi le seguenti variabili:
| Nome variabile | Valore | Protetto |
|---|---|---|
CAPGO_TOKEN | Il tuo token Capgo API | ✅ Sì |
Semplice
Sezione dal titolo “Semplice”Configurazione base per il deploy in produzione a ogni push sul branch main:
# bitbucket-pipelines.yml - Simple Configurationimage: 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/**Avanzato
Sezione dal titolo “Avanzata”Deployment su feature branch
Sezione intitolata “Deploy dei feature branch”Deploy dei feature branch sui canali di test per review e testing:
# Feature branch deploymentpipelines: 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 add $CHANNEL_NAME --apikey $CAPGO_TOKEN || true - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME artifacts: - dist/**Utilizzo della crittografia
Sezione intitolata “Utilizzo della crittografia”Se stai usando La funzionalità di crittografia di Capgo, dovrai salvare la tua chiave privata in modo sicuro nel tuo ambiente CI/CD.
Dopo aver configurato le chiavi di crittografia in locale, aggiungi la tua chiave privata alle variabili di Bitbucket:
# Display your private key content (copy this output)cat .capgo_key_v2Aggiungi questo contenuto come CAPGO_PRIVATE_KEY nelle variabili del repository Bitbucket (contrassegnala come secured), quindi usala nelle pipeline:
# 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 productionConfigurazione multi-channel
Sezione intitolata “Configurazione Multi-Channel”Per informazioni dettagliate sulla configurazione e gestione di più canali di deployment, consulta la documentazione sui Channels.
Configurazione completa con più ambienti e deploy delle pull request:
# bitbucket-pipelines.yml - Advanced Multi-Channel Configurationimage: 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 add $CHANNEL_NAME --apikey $CAPGO_TOKEN || true - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME artifacts: - dist/**Pipeline multi-ambiente
Sezione intitolata “Pipeline multi-ambiente”Per scenari di deployment complessi con ambienti di staging e produzione:
# Multi-environment pipelineimage: 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/**Strategia di deployment basata su branch
Sezione: “Strategia di deployment basata su branch”Deploy automatico di branch diversi sui canali appropriati:
# Dynamic channel deploymentimage: 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/**Esecuzione parallela della pipeline
Sezione intitolata “Esecuzione parallela della pipeline”Ottimizza i tempi di build con step paralleli:
# Parallel execution pipelineimage: 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 productionBest practice di sicurezza
Sezione intitolata “Best practice di sicurezza”Variabili del repository
Sezione intitolata “Repository Variables”- Variabili protette: Segna sempre i token API come protetti
- Variabili d'ambiente: Usa variabili specifiche del deployment quando serve
- Controllo degli accessi: Limita l'accesso al repository ai membri autorizzati
- Rotazione dei token: Ruota regolarmente i tuoi token API di Capgo
Ambienti di deployment
Sezione intitolata “Ambienti di deployment”Configura gli ambienti di deployment per una maggiore sicurezza:
# Deployment with environment restrictionspipelines: 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 productionMonitoraggio e notifiche
Sezione intitolata “Monitoraggio e notifiche”Integrazione Slack
Sezione intitolata “Integrazione Slack”Aggiungi le notifiche Slack alla tua pipeline:
# Pipeline with Slack notificationspipelines: 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 fiNotifiche email
Sezione intitolata “Notifiche email”Configura le notifiche email tramite le funzionalità integrate di Bitbucket o utilizzando servizi esterni:
# 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]Risoluzione problemi
Sezione intitolata “Troubleshooting”Problemi comuni
Sezione intitolata “Problemi comuni”La pipeline fallisce con “Capgo CLI not found”:
# Debug CLI installation- step: name: Debug CLI script: - npm install -g @capgo/cli - which capgo || echo "Capgo CLI not found" - npx @capgo/cli --versionErrori di autenticazione:
# 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}"Artefatti di build non trovati:
# List build outputs- step: name: Debug Build script: - ls -la dist/ - find dist/ -type f -name "*.js" -o -name "*.html"Debug della pipeline
Sezione intitolata “Debug della pipeline”Aggiungi informazioni di debug per risolvere i problemi:
# Debug pipelinepipelines: 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 productionValidazione della pipeline
Sezione intitolata “Pipeline Validation”Abilita la validazione della pipeline per intercettare errori di configurazione:
# Enable pipeline validationoptions: docker: true size: 2x
pipelines: branches: main: - step: name: Validate Pipeline script: - echo "Pipeline validation successful" - step: name: Build and Deploy script: # ... deployment stepsProssimi passi
Sezione intitolata “Prossimi passi”- Scopri Canali per gestire diversi ambienti di deployment
- Esplora Storage personalizzato per scenari di deployment avanzati
- Configurazione Crittografia per deployment sicuri
- Configura Comportamento degli aggiornamenti per personalizzare come vengono applicati gli update
Con l'integrazione di Bitbucket Pipelines, puoi automatizzare i tuoi deploy Capgo e garantire aggiornamenti coerenti e affidabili per gli utenti della tua app mobile.
Continua dall'integrazione con Bitbucket Pipelines
Sezione intitolata “Continua con l'integrazione di Bitbucket Pipelines”Se stai usando Integrazione Bitbucket Pipelines per pianificare l'automazione CI/CD e connetterla a CI/CD con Capgo per il workflow del prodotto in Capgo CI/CD, Capgo Native Build per il workflow di prodotto in Capgo Native Builds, Integrazioni Capgo per il workflow di prodotto in Integrazioni Capgo, Integrazione CI/CD per i dettagli implementativi in CI/CD Integration, e Integrazione GitHub Actions per i dettagli implementativi in GitHub Actions Integration.