Capacitor CI/CD 파이프라인 구축 가이드

더 빠른 업데이트를 앱 업데이트 최소한의 노력으로 원하시나요? 앱을 위한 CI/CD 파이프라인을 설정하면 Capacitor 빌드, 테스트, 배포가 자동화되어 시간을 절약하고 오류를 줄일 수 있습니다. 다음과 같은 이점을 얻을 수 있습니다:

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

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

설정 요구 사항

사전 요구사항

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

Node.js LTS, Capacitor CLI, 그리고 Git
선호하는 CI 플랫폼 계정 (예: GitHub 액션, GitLab CI, 또는 Jenkins)
A Capgo 계정 Live Update 관리를 위한

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

Appflow를 CICD 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 대시보드 인터페이스

build 및 deploy 단계를 모두 설정했다면, 이제 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 앱에 다음과 같은 이점을 제공합니다:

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

Capgo 요금제 및 가격

Capgo는 다양한 요구 사항에 맞춘 유연한 요금제를 제공합니다:

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

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

파이프라인 관리

상태 추적

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

빌드 상태 및 배포 진행 상황
업데이트 성공률
사용자 채택 지표
에러 리포트 및 crash logs

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

문서화 가이드

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

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

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

플랫폼 가이드라인

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

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

요약

설정 단계 개요

시작하려면 CLI를 설치하고, 빌드 및 환경 변수를 구성하며, 보안 비밀(secrets)을 관리하고, 모니터링을 활성화한 뒤 업데이트를 배포해야 합니다. 이 프로세스는 모니터링 및 롤백 도구와 원활하게 통합되어 앱의 다운타임을 최소화하고 안정적인 서비스를 유지합니다.

CI/CD의 장점

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

Capacitor CI/CD 파이프라인 설정 가이드 계속 읽기

사용 중인 경우 Capacitor CI/CD 파이프라인 설정 가이드 CI/CD 자동화를 계획하고, Capgo CI/CD와 Capgo CI/CD를 통한 제품 워크플로우를 위해, Capgo Native Build Capgo Native Build 제품 워크플로우를 위해, Capgo 연동 서비스 Capgo Integrations 제품 워크플로우를 위해, CI/CD 통합 CI/CD Integration 구현 세부 사항과, GitHub Actions 연동 GitHub Actions Integration 구현 세부 사항을 위해.