GitLab CI/CD 연동
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Capgo Live Updates를 GitLab CI/CD와 통합하여 code 변경 사항을 push할 때마다 앱 업데이트를 자동으로 배포하세요. 이 가이드에서는 자동화된 빌드, 테스트 및 배포 워크플로우 설정을 다룹니다.
사전 요구사항
“사전 준비 사항” 섹션GitLab CI/CD 연동을 설정하기 전에 다음을 확인하세요:
- 프로젝트 저장소가 있는 GitLab 계정
- 앱이 구성된 Capgo 계정
- 프로젝트에 Node.js 및 npm/yarn 설정
GitLab CI/CD 설정하기
“GitLab CI/CD 설정하기” 섹션1단계: 환경 변수 설정
“1단계: 환경 변수 설정” 섹션먼저 GitLab 프로젝트에 필요한 변수를 설정하세요:
- GitLab 프로젝트로 이동
- 다음으로 이동: 설정 → CI/CD → 변수
- 다음 변수를 추가하세요:
| 변수 이름 | 값 | 보호됨 | 마스킹됨 |
|---|---|---|---|
CAPGO_TOKEN | Capgo API 토큰 | ✅ 예 | ✅ 예 |
간단
“간단” 섹션main 브랜치에 push할 때마다 프로덕션에 배포하는 기본 설정:
# .gitlab-ci.yml - Simple Configurationimage: 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고급
“고급” 섹션Feature Branch 배포
“Feature Branch Deployments” 섹션리뷰 및 테스트를 위해 피처 브랜치를 테스트 채널에 배포하세요:
# Feature branch deploymentdeploy_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 add $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암호화 사용하기
“암호화 사용하기” 섹션사용 중인 경우 Capgo의 암호화 기능을 사용하려면CI/CD 환경에 개인 키를 안전하게 저장해야 합니다.
로컬에서 암호화 키 설정을 마친 후, GitLab 변수에 개인 키를 추가하세요:
# Display your private key content (copy this output)cat .capgo_key_v2다음 내용을 CAPGO_PRIVATE_KEY GitLab 프로젝트 변수에 추가하고(protected 및 masked로 표시), 파이프라인에서 사용하세요:
# Deploy with encryptiondeploy_production: script: - npm install -g @capgo/cli - npx @capgo/cli bundle upload --apikey $CAPGO_TOKEN --key-data-v2 "$CAPGO_PRIVATE_KEY" --channel production멀티 채널 구성
“Multi-Channel Configuration” 섹션여러 배포 채널을 설정하고 관리하는 자세한 내용은 Channels 문서.
여러 환경과 머지 리퀘스트 배포로 구성을 완료하세요:
# .gitlab-ci.yml - Advanced Multi-Channel Configurationimage: node:22
stages: - build - deploy
variables: npm_config_cache: "$CI_PROJECT_DIR/.npm"
# Build stagebuild: stage: build script: - npm ci - npm run test - npm run build artifacts: paths: - dist/ expire_in: 24 hours
# Deploy to development channeldeploy_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 channelsdeploy_mr: stage: deploy script: - npm install -g @capgo/cli - CHANNEL_NAME="mr-$CI_MERGE_REQUEST_IID" - npx @capgo/cli channel add $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 closedcleanup_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 stagingdeploy_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 productiondeploy_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브랜치 기반 배포 전략
“브랜치 기반 배포 전략” 섹션각 브랜치를 적절한 채널에 자동으로 배포합니다:
# Dynamic channel deployment based on branchdeploy: 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보안 모범 사례
“보안 모범 사례” 섹션보호된 변수
“Protected Variables” 섹션- 민감한 변수 표시: 항상 API 토큰을 보호 및 마스킹 상태로 표시하세요
- 브랜치 보호: 프로덕션 배포에는 보호된 변수를 사용하세요
- 접근 제어: 변수 접근 권한을 메인테이너에게만 제한하세요
- 정기적 교체: API 토큰을 정기적으로 교체하세요
보안 파이프라인 설정
“보안 파이프라인 설정” 섹션# Use protected variables for productiondeploy_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"모니터링 및 알림
“모니터링 및 알림” 섹션Slack 연동
“Slack 연동” 섹션파이프라인에 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문제 해결
“문제 해결” 섹션일반적인 이슈
“자주 발생하는 문제” 섹션파이프라인이 “Capgo CLI not found” 오류로 실패:
# Debug CLI installationdebug_cli: script: - npm install -g @capgo/cli - which capgo || echo "Capgo CLI not found" - npx @capgo/cli --version인증 오류:
# Verify token configurationdebug_auth: script: - | if [ -z "$CAPGO_TOKEN" ]; then echo "CAPGO_TOKEN is not set" exit 1 fi echo "Token length: ${#CAPGO_TOKEN}"빌드 아티팩트를 찾을 수 없음:
# List build outputsdebug_build: script: - ls -la dist/ - find dist/ -type f -name "*.js" -o -name "*.html"파이프라인 디버깅
“파이프라인 디버깅” 섹션문제 해결을 위해 디버깅 정보를 추가하세요:
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다음 단계
“다음 단계” 섹션- 자세히 알아보기 채널 다양한 배포 환경을 관리하기 위해
- 둘러보기 커스텀 스토리지 고급 배포 시나리오를 위해
- 설정하기 암호화 안전한 배포를 위해
- 구성하세요: 업데이트 동작 업데이트 적용 방식을 커스텀하려면
GitLab CI/CD 연동을 통해 Capgo 배포를 자동화하고, 모바일 앱 사용자에게 일관되고 신뢰할 수 있는 업데이트를 제공하세요.
GitLab CI/CD 연동 계속하기
“GitLab CI/CD 연동 계속하기” 제목의 섹션사용 중이라면 GitLab CI/CD 연동 CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.