Capacitor CI/CD 파이프라인 설정 가이드

앱 스토어 심사 없이 앱 업데이트를 최소한의 노력으로 가능할까요? CI/CD 파이프라인을 설정하면 Capacitor 앱의 빌드, 테스트, 배포가 자동화되어 시간을 절약하고 오류를 줄입니다. 얻을 수 있는 결과는 다음과 같습니다:

Live Update: 앱 스토어 심사 대기 없이 즉시 업데이트를 푸시하세요. 사용자의 95%가 24시간 이내에 업데이트를 받습니다.
파이프라인 필수 요소: 브랜치 활동에 따라 빌드를 자동화하고 (main, staging, feature/*) 스테이징과 프로덕션 환경을 분리하여 정의합니다.
Capgo 통합: Capgo를 사용하여 보안이 강화된 암호화 업데이트를 배포하고, 업데이트 채널관리 및 성능을 모니터링하세요.
합리적인 요금제: Live Update, 분석 기능, 월 약 15회의 Native Build를 포함한 요금제가 월 $12부터 시작합니다.

Capacitor CI/CD 파이프라인을 사용하면 워크플로우를 단순화하고 효율성을 높이며, 앱을 끊김 없이 최신 상태로 유지할 수 있습니다. 자세한 내용을 살펴보겠습니다.

설정 요구사항

사전 요구사항

먼저 다음 항목들이 설치 및 설정되어 있는지 확인하세요:

Node.js LTS, Capacitor CLI, 그리고 Git
선호하는 CI 플랫폼 계정 (예: GitHub 작업, GitLab CI, 또는 Jenkins를)
어떤 Capgo 계정 라이브 업데이트 관리를 위해

준비가 완료되면, 사용 중인 CI 플랫폼에서 빌드 트리거와 단계를 정의하세요.

Appflow를 CI/CD Pipeline에 통합하기

Pipeline 설정 단계

사전 준비를 마쳤다면, 이제 파이프라인의 트리거와 환경 설정을 구성할 차례입니다.

빌드 트리거 및 단계

특정 브랜치 활동에 따라 빌드가 자동으로 트리거되도록 CI/CD pipeline을 설정하세요. 설정 방법은 다음과 같습니다:

브랜치 트리거:
- 사용 main 프로덕션 빌드용.
- 사용 staging 테스트용.
- 사용 feature/* 개발 작업용.
빌드 단계:
- 필요한 모든 의존성 설치.
- code 품질 보장을 위해 유닛 테스트 실행.
- 애플리케이션용 웹 에셋 빌드.
- 모바일 또는 데스크톱 플랫폼용 네이티브 바이너리 생성.
- 추가 검증을 위해 빌드를 테스트 환경에 배포하세요.

환경 설정

관리 효율성과 보안을 위해 staging 및 production용 환경 설정 파일을 각각 정의하세요. 설정 예시는 다음과 같습니다:

# staging.env
ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

API 키와 인증서와 같은 민감한 데이터는 CI 플랫폼의 secrets 관리 시스템에 안전하게 저장해야 합니다. 그래야 파이프라인의 기능과 보안을 모두 유지할 수 있습니다.

Capgo 연동 가이드

Capgo Live Update 대시보드 인터페이스

빌드 및 배포 단계를 설정했다면, 이제 Capgo를 통합할 차례입니다. 이를 통해 앱 스토어 심사 대기 시간 없이 앱에 Live Update를 직접 푸시할 수 있습니다.

Capgo 설정 단계

CI/CD 파이프라인 준비가 완료되었다면, 다음 단계에 따라 프로젝트에 Capgo를 추가하세요:

먼저, Capgo CLI:

npx @capgo/cli init

그 다음, 아래 명령어를 실행하세요:

앱 빌드: npm install && npm run build
업데이트 배포: npx @capgo/cli deploy
업데이트 롤백: npx @capgo/cli rollback

업데이트 배포를 위한 GitHub Actions 작업 예시입니다:

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Capgo의 주요 기능

Capgo를 Capacitor 앱에 도입하면 다음과 같은 이점이 있습니다:

안전하고 효율적인 업데이트: 암호화된 차분 업데이트(differential updates)를 통해 보안을 유지하면서 페이로드 크기를 줄입니다.
채널 관리: 스테이징 및 프로덕션 채널을 생성하여 업데이트 배포 방식을 제어합니다.
Analytics 대시보드: 상세한 인사이트를 통해 업데이트 성공률을 추적하고 사용자 채택률을 모니터링하세요.

Capgo 요금제 및 가격

Capgo는 다양한 요구 사항에 맞춘 유연한 플랜을 제공합니다:

SOLO: 월 $12 (1,000 MAU, 2 GB 스토리지, 50 GB 대역폭)
메이커: 월 $33 (10,000 MAU, 5 GB 스토리지, 500 GB 대역폭)
팀: 월 $83 (100,000 MAU, 10 GB 스토리지, 2,000 GB 대역폭)
종량제: 월 $249부터 시작하며, 커스텀 스케일링, API 액세스 및 커스텀 도메인 옵션을 제공합니다.

현재 Capgo는 1,900개 이상의 앱이 프로덕션 환경에서 사용 중이며, 지속적 배포를 위한 신뢰할 수 있는 선택지입니다. [1].

파이프라인 관리

상태 추적

파이프라인을 면밀히 모니터링하는 것은 앱 품질을 유지하고 사용자 만족도를 높이는 핵심입니다. CI/CD 플랫폼을 사용하여 다음 항목에 대한 자동 알림을 설정하세요:

빌드 상태 및 배포 진행 상황
업데이트 성공률
사용자 채택 지표
에러 리포트 및 크래시 로그

이러한 알림을 명확한 문서와 함께 활용하면 원활한 모니터링과 신속한 문제 해결이 가능합니다.

문서화 가이드

잘 정리된 문서는 팀의 협업을 돕고 운영을 원활하게 만듭니다. 문서에 다음 내용을 반드시 포함하세요:

파이프라인 설정: 빌드 트리거, 환경 변수, 보안 설정 등의 세부 사항.
업데이트 절차: 배포 단계, 롤백 지침 및 업데이트 채널 관리.
모니터링 설정: 알림 설정, 메트릭 추적 및 이슈 대응 방법.
컴플라이언스 가이드라인: 플랫폼별 규칙, 업데이트 제한 사항 및 기타 요구 사항.

모든 문서를 버전 관리에 저장하고 파이프라인이 변경될 때마다 업데이트하세요. 문제가 발생했을 때 시간을 절약할 수 있도록 일반적인 오류에 대한 트러블슈팅 단계를 포함하세요.

플랫폼 가이드라인

Capgo의 채널 시스템을 사용해 Apple 및 Android 업데이트 정책을 따르고, 원활하고 규정을 준수하는 롤아웃을 보장하세요:

베타 테스트: 소규모 사용자 그룹에 업데이트 배포 변경 사항을 검증하기 위해.
단계적 배포: 업데이트를 점진적으로 배포해 문제를 조기에 발견하세요.
긴급 수정: 문제가 발생하면 클릭 한 번으로 업데이트를 빠르게 롤백하세요.

요약

설정 단계 개요

시작하려면 CLI를 설치하고, 빌드와 환경 변수를 구성하고, secrets를 안전하게 보관하고, 모니터링을 활성화한 뒤 업데이트를 배포해야 합니다. 이 과정은 모니터링 및 롤백 도구와 원활하게 연동되어 앱이 최소한의 다운타임으로 계속 온라인 상태를 유지하도록 합니다.

CI/CD의 장점

설정과 결과의 연결은 Capgo가 효율성을 어떻게 높이는지 보여줍니다: 업데이트가 단 24시간 내에 사용자의 95%에게 도달합니다. 또한, Capgo의 요금은 월 $12, 월 $500 이상의 비용을 청구하는 기존 서비스와 비교해 압도적인 비용 절감 효과를 제공합니다. 월 $500. 현재 Capgo는 다음을 지원합니다: 1,900개 이상의 프로덕션 앱 [1].

Capacitor CI/CD Pipeline Setup Guide 계속 읽기

사용 중이라면 Capacitor 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의 구현 세부 사항을 참고하세요.