GitLab CI/CD 통합

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

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

사전 요구 사항

GitLab CI/CD 통합을 설정하기 전에 다음을 확인하세요:

GitLab 계정과 프로젝트 저장소
Capgo 계정과 앱이 설정된 Capgo
Node.js 및 npm/yarn이 프로젝트에 설정된 경우

GitLab CI/CD 설정

설치

1단계: 환경 변수 설정
먼저 GitLab 프로젝트에서 필요한 변수를 설정하세요: 프로젝트로 이동하세요. 설정 → CI/CD → 변수
다음 변수를 추가하세요:

변수 이름	값	보호	가리기
`CAPGO_TOKEN`	Capgo API 토큰	✅ 예	✅ 예

__CAPGO_KEEP_2__

Copy to clipboard

# .gitlab-ci.yml - Simple Configuration
image: node:22

stages:
  - build
  - deploy

variables:
  npm_config_cache: "$CI_PROJECT_DIR/.npm"

build:
  stage: build
  script:
    - npm ci
    - npm run test
    - npm run build
  artifacts:
    paths:
      - dist/
    expire_in: 1 hour
  only:
    - main

deploy_production:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
    # For encrypted uploads, add: --key-data-v2 "$CAPGO_PRIVATE_KEY"
  dependencies:
    - build
  only:
    - main

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

기능 branch를 테스트 채널에 배포하여 검토 및 테스트:

# Feature branch deployment
deploy_feature:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - CHANNEL_NAME="feature-$(echo $CI_COMMIT_REF_NAME | sed 's/[^a-zA-Z0-9-]/-/g')"
    - npx @capgo/cli channel create $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
  dependencies:
    - build
  only:
    - /^feature\/.*$/
  environment:
    name: feature/$CI_COMMIT_REF_NAME
    url: https://your-app.com/channels/$CHANNEL_NAME

기능 제목 “Using Encryption”

__CAPGO_KEEP_0__의 암호화 기능 Capgo’s encryption feature, __CAPGO_KEEP_0__을 저장하기 위해 CI/CD 환경에서 개인 키를 안전하게 보관해야 합니다.

After 암호화 키를 설정한 후 로컬 환경에서 개인 키를 GitLab 변수에 추가하십시오:

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

GitLab 프로젝트 변수에 다음 내용을 추가하십시오 (보호 및 가려진 항목으로 표시): CAPGO_PRIVATE_KEY 복사

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

다중 채널 구성

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

다중 환경 및 병합 요청 배포:

# .gitlab-ci.yml - Advanced Multi-Channel Configuration
image: node:22

stages:
  - build
  - deploy

variables:
  npm_config_cache: "$CI_PROJECT_DIR/.npm"

# Build stage
build:
  stage: build
  script:
    - npm ci
    - npm run test
    - npm run build
  artifacts:
    paths:
      - dist/
    expire_in: 24 hours

# Deploy to development channel
deploy_development:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel development
  dependencies:
    - build
  only:
    - develop
  environment:
    name: development

# Deploy merge requests to test channels
deploy_mr:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - CHANNEL_NAME="mr-$CI_MERGE_REQUEST_IID"
    - npx @capgo/cli channel create $CHANNEL_NAME --apikey $CAPGO_TOKEN || true
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL_NAME
  dependencies:
    - build
  only:
    - merge_requests
  environment:
    name: review/$CI_MERGE_REQUEST_IID
    url: https://your-app.com/channels/mr-$CI_MERGE_REQUEST_IID
    on_stop: cleanup_mr

# Cleanup MR channels when MR is closed
cleanup_mr:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli channel delete mr-$CI_MERGE_REQUEST_IID --apikey $CAPGO_TOKEN || true
  when: manual
  environment:
    name: review/$CI_MERGE_REQUEST_IID
    action: stop
  only:
    - merge_requests

# Deploy to staging
deploy_staging:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel staging
  dependencies:
    - build
  only:
    - develop
  environment:
    name: staging

# Deploy to production
deploy_production:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
  dependencies:
    - build
  only:
    - main
  environment:
    name: production

수동 승인과 함께 다중 환경

프로덕션 배포에 대한 수동 승인 요구가 있는 경우:

deploy_production:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
  dependencies:
    - build
  only:
    - main
  when: manual
  environment:
    name: production

Branch-Based 배포 전략

다양한 branch를 자동으로 적절한 채널에 배포:

# Dynamic channel deployment based on branch
deploy:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - |
      if [ "$CI_COMMIT_REF_NAME" = "main" ]; then
        CHANNEL="production"
      elif [ "$CI_COMMIT_REF_NAME" = "develop" ]; then
        CHANNEL="staging"
      else
        CHANNEL="development"
      fi
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel $CHANNEL
  dependencies:
    - build
  environment:
    name: $CHANNEL

보안 최적화

보호 변수

Sensitive 변수를 표시API 변수는 항상 보호 및 가리기
Branch Protection: 프로덕션 배포에 사용되는 변수를 보호하기 위해 보호 변수를 사용하십시오.
Access Control: 유지관리자만 변수에 접근할 수 있도록 제한하십시오.
Regular Rotation: API 토큰을 정기적으로 회전하십시오.

Secure Pipeline Configuration

# Use protected variables for production
deploy_production:
  stage: deploy
  script:
    - npm install -g @capgo/cli
    - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --channel production
  only:
    refs:
      - main
    variables:
      - $CI_COMMIT_REF_PROTECTED == "true"

Monitoring and Notifications

Slack Integration

pipeline에 Slack 알림을 추가하세요:

notify_success:
  stage: .post
  image: alpine:latest
  before_script:
    - apk add --no-cache curl
  script:
    - |
      curl -X POST -H 'Content-type: application/json' \
        --data '{"text":"✅ Capgo deployment successful for '"$CI_COMMIT_REF_NAME"'"}' \
        $SLACK_WEBHOOK_URL
  when: on_success

notify_failure:
  stage: .post
  image: alpine:latest
  before_script:
    - apk add --no-cache curl
  script:
    - |
      curl -X POST -H 'Content-type: application/json' \
        --data '{"text":"❌ Capgo deployment failed for '"$CI_COMMIT_REF_NAME"'"}' \
        $SLACK_WEBHOOK_URL
  when: on_failure

이메일 알림

GitLab 프로젝트 설정에서 이메일 알림을 구성하거나 API:를 사용하세요.

notify_email:
  stage: .post
  script:
    - |
      curl --request POST \
        --header "PRIVATE-TOKEN: $GITLAB_API_TOKEN" \
        --form "to=team@yourcompany.com" \
        --form "subject=Capgo Deployment Status" \
        --form "body=Deployment of $CI_COMMIT_REF_NAME completed with status: $CI_JOB_STATUS" \
        "https://gitlab.com/api/v4/projects/$CI_PROJECT_ID/emails"
  when: always

문제 해결

일반적인 문제

pipeline이 “Capgo CLI not found”와 같은 오류를 발생시키면:

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

인증 오류:

# Verify token configuration
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
debug_build:
  script:
    - ls -la dist/
    - find dist/ -type f -name "*.js" -o -name "*.html"

디버그 PIPELINE

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

debug:
  stage: build
  script:
    - echo "Branch: $CI_COMMIT_REF_NAME"
    - echo "Commit: $CI_COMMIT_SHA"
    - echo "Build: $CI_PIPELINE_ID"
    - env | grep CI_ | sort
  only:
    - branches

다음 단계

알아보기 채널 다양한 배포 환경을 관리하기 위해
Explore 고급 배포 시나리오를 위해 Custom Storage 배포를 위한 설정
보안을 위한 암호화 배포를 위한 설정 업데이트를 위한 설정
업데이트를 위한 설정 업데이트를 위한 설정 GitLab CI/CD와의 통합을 통해 __CAPGO_KEEP_0__ 배포를 자동화하고, 안정적이고 신뢰할 수 있는 업데이트를 사용자에게 제공할 수 있습니다.

Capgo

GitLab CI/CD 통합에서 계속

GitLab CI/CD 통합을 사용 중이라면 GitLab CI/CD 통합 CI/CD 자동화 계획을 위해 GitLab CI/CD 통합을 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 위해 Capgo 네이티브 빌드 Capgo 네이티브 빌드에서 제품 워크플로우를 위해 Capgo 통합 Capgo 통합에서 제품 워크플로우를 위해 CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해, GitHub 액션 통합 CI/CD 통합 구현 세부 사항에 대해 GitHub 액션 통합