내용으로 건너뛰기
Capgo - Capacitor 앱의 Live 업데이트 Capgo

Bitbucket Pipelines 통합

Bitbucket Pipelines와 Capgo Live Updates를 통합하여 code 변경 사항을 푸시할 때마다 앱 업데이트를 자동으로 배포하세요. 이 가이드는 자동 빌드, 테스트 및 배포 워크플로우를 설정하는 방법을 다룹니다.

설치 전 요구 사항

설치 전 요구 사항 섹션

Bitbucket Pipelines 통합을 설정하기 전에 다음을 확인하세요:

  • Bitbucket 계정과 저장소
  • Capgo 계정과 앱을 구성한 Capgo
  • Node.js와 npm/yarn이 프로젝트에 구성된 경우

Bitbucket Pipelines 설정

Bitbucket Pipelines 설정 섹션

1단계: 저장소 변수 구성

1단계: 저장소 변수 구성 섹션

먼저 Bitbucket 저장소에서 필요한 변수를 설정하세요:

  1. Bitbucket 저장소로 이동하세요
  2. Go to 저장소 설정 → Pipeline → 저장소 변수
  3. 다음 변수를 추가하세요:
변수 이름값보안
CAPGO_TOKENYour Capgo API token✅ Yes

간단

프로덕션으로 배포하는 모든 푸시에 대한 기본 설정:

클립보드에 복사

# 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/**

기능 브랜치 배포

기능 브랜치 배포

기능 브랜치 배포

기능 브랜치 배포

__CAPGO_KEEP_0__의 암호화 기능을 사용 중이라면, CI/CD 환경에서 개인 키를 안전하게 저장해야 합니다.

# 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/**

__CAPGO_KEEP_0__ 암호화

__CAPGO_KEEP_0__ ‘Using Encryption’ 섹션

__CAPGO_KEEP_0__가 __CAPGO_KEEP_0__ 기능을 사용 중이라면, CI/CD 환경에서 개인 키를 안전하게 저장해야 합니다. Capgo 채널을 사용하여 앱을 업데이트하여 테스트하는 방법__CAPGO_KEEP_0__ 앱을 구성하는 방법을 알아보세요.

After 암호화 키를 설정한 후, 비트박스 변수에 개인 키를 추가하세요: 터미널 창

클립보드에 복사
# Display your private key content (copy this output)
cat .capgo_key_v2

클립보드에 복사 CAPGO_PRIVATE_KEY 주의

# 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

다중 채널 구성

다중 채널 구성

다중 배포 채널을 설정하고 관리하는 데 대한 자세한 정보는 채널 문서.

다중 환경 및 pull request 배포와 함께 완전한 구성: 

# 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

스테이징 및 프로덕션 환경과 같은 복잡한 배포 시나리오에 대한:

다중 환경 PIPELINE

# 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/**

__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

# 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/**

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

# 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

__CAPGO_KEEP_7__

__CAPGO_KEEP_8__

__CAPGO_KEEP_9__

__CAPGO_KEEP_0__ Repository Variables
  1. 보호된 변수: 항상 API 토큰을 보호된 변수로 표시합니다
  2. 환경 변수: 필요할 때 사용하는 배포 환경에 맞는 변수를 사용합니다
  3. 액세스 제어: 권한이 있는 팀 멤버만 레포지토리 접근을 제한합니다
  4. 토큰 회전: Capgo API 토큰을 정기적으로 회전합니다

배포 환경

__CAPGO_KEEP_0__ 배포 환경 구성

: 보다 안전한 배포 환경을 위해 배포 환경을 구성합니다

# 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

모니터링 및 알림

모니터링 및 알림

슬랙 통합

슬랙 통합

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

이메일 알림

이메일 알림

Bitbucket 내장 기능을 사용하거나 외부 서비스를 사용하여 이메일 알림을 구성하세요:

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

문제 해결

[Troubleshooting]

일반 문제

[일반 문제]

pipeline이 “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 --version

인증 오류:

# 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}"

빌드 아티팩트가 없습니다.

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

디버그 PIPELINE

[디버그 PIPELINE]

문제를 해결하기 위해 디버깅 정보를 추가하세요:

# 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

pipeline 유효성 검사

pipeline 유효성 검사 섹션

pipeline 유효성 검사를 활성화하여 구성 오류를 잡아내세요:

# 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

다음 단계

섹션 제목 “다음 단계”
  • 알아보기 채널 다양한 배포 환경을 관리하기 위해
  • 탐색 커스텀 스토리지 __CAPGO_KEEP_0__ 배포 시나리오를 위한 고급 설정
  • 설정 암호화 안전한 배포를 위한 설정
  • 설정 업데이트 동작 업데이트가 적용되는 방식을 커스터마이즈하기 위해

Bitbucket Pipelines 통합을 통해 Capgo 배포를 자동화하고 모바일 앱 사용자에게 일관성 있고 신뢰할 수 있는 업데이트를 보장할 수 있습니다.

Bitbucket Pipelines 통합에서 계속하기

Bitbucket Pipelines 통합에서 계속하기

Bitbucket Pipelines 통합을 사용하고 있다면 Bitbucket Pipelines 통합 CI/CD 자동화 계획을 수립하기 위해 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 위한 Capgo 네이티브 빌드 Capgo 네이티브 빌드에서 제품 워크플로우를 위한 Capgo 통합 Capgo 통합에서 제품 워크플로우를 위한 CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항에 대해