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

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

실시간 업데이트: 앱 스토어 지연 없이 즉시 업데이트를 푸시할 수 있습니다. 사용자의 95%가 24시간 이내에 업데이트를 받습니다.
파이프라인 필수 요소: 브랜치 활동(main, staging, feature/*)에 의해 트리거되는 빌드를 자동화하고 스테이징과 프로덕션을 위한 별도의 환경을 정의합니다.
Capgo 통합: Capgo를 사용하여 안전하고 암호화된 업데이트를 배포하고, 업데이트 채널을 관리하며, 성능을 모니터링합니다.
합리적인 요금제: 실시간 업데이트와 분석을 위한 요금제는 월 12달러부터 시작합니다.

Capacitor CI/CD 파이프라인은 워크플로우를 단순화하고, 효율성을 향상시키며, 앱이 원활하게 최신 상태를 유지하도록 보장합니다. 자세한 내용을 살펴보겠습니다.

설정 요구사항

전제 조건

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

Node.js LTS, Capacitor CLI, 그리고 Git
선호하는 CI 플랫폼(GitHub Actions, GitLab CI, 또는 Jenkins)의 계정
실시간 업데이트 관리를 위한 Capgo 계정

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

Appflow를 CICD 파이프라인과 통합하기

파이프라인 설정 단계

전제 조건을 처리했으니 이제 파이프라인의 트리거와 환경 설정을 구성할 차례입니다.

빌드 트리거 및 단계

특정 브랜치 활동을 기반으로 자동으로 빌드를 트리거하도록 CI/CD 파이프라인을 설정하세요. 구성 방법은 다음과 같습니다:

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

환경 설정

체계적이고 안전한 관리를 위해 스테이징과 프로덕션용 별도의 환경 구성 파일을 정의하세요. 다음은 설정 예시입니다:

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 플랫폼의 보안 관리 시스템에 안전하게 저장하세요. 이를 통해 파이프라인의 기능성과 보안성을 모두 유지할 수 있습니다.

Capgo 통합 가이드

Capgo

빌드 및 배포 단계를 설정한 후에는 Capgo를 통합할 차례입니다. 이를 통해 앱 스토어 승인 지연을 우회하여 앱에 직접 실시간 업데이트를 푸시할 수 있습니다.

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 플랫폼을 사용하여 다음에 대한 자동화된 알림을 설정하세요:

빌드 상태 및 배포 진행 상황
업데이트 성공률
사용자 채택 지표
오류 보고서 및 크래시 로그

원활한 모니터링과 신속한 문제 해결을 위해 이러한 알림을 명확한 문서화와 함께 사용하세요.

문서화 가이드

좋은 문서화는 팀이 같은 페이지를 보고 운영이 원활하게 진행되도록 합니다. 문서화에 다음 내용이 포함되어야 합니다:

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

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

플랫폼 가이드라인

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

베타 테스팅: 작은 사용자 그룹에 업데이트 릴리스하여 변경사항을 검증합니다.
단계적 출시: 점진적으로 업데이트를 출시하여 초기에 문제를 포착합니다.
긴급 수정: 문제가 발생하면 클릭 한 번으로 빠르게 업데이트를 롤백합니다.

요약

설정 단계 개요

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

CI/CD 이점

설정과 결과 사이의 연결은 Capgo가 어떻게 효율성을 높이는지 보여줍니다: 업데이트가 24시간 이내에 95%의 사용자에게 도달합니다. 또한, Capgo의 가격 - 월 12달러에서 83달러 - 은 월 500달러 이상을 청구할 수 있는 기존 서비스에 비해 막대한 비용 이점을 제공합니다. 현재 Capgo는 1,900개 이상의 프로덕션 앱을 지원하고 있습니다 [1].