Capgo와 GitHub Actions 연동 가이드

Capgo 및 GitHub 작업 함께 업데이트 배포를 단순화합니다 Capacitor 앱에. 왜 이 통합이 주목할 가치가 있는지:

비용 절감: 5년간 CI/CD 비용을 최대 $26,100까지 절감, 비교: AppFlow는.
빠른 업데이트: 업데이트를 즉시 푸시하면 95%의 사용자가 24시간 이내에 받게 됩니다.
안전한 배포: 종단 간 암호화로 업데이트 안전성을 보장합니다.
효율적인 워크플로우: GitHub 저장소에서 빌드와 배포를 직접 자동화하세요.

한눈에 보기

요구 사항: GitHub 계정, Capgo 계정 (월 $12부터), Capacitor 프로젝트, Node.js.
설정: 설치하기 Capgo CLI 포함 npx @capgo/cli init, YAML 워크플로우로 GitHub Actions 설정하기.
배포: 다음 명령어 사용하기 npx @capgo/cli deploy 대상 업데이트 자동화.
테스트: 프로덕션 배포 전 테스트 채널(예: beta, staging)에 배포합니다.

워크플로 예시 (YAML):

name: Capgo Deploy  
on:  
  push:  
    branches:  
      - main  

jobs:  
  deploy:  
    runs-on: ubuntu-latest  
    steps:  
      - uses: actions/checkout@v6  
      - uses: actions/setup-node@v3  
        with:  
          node-version: '24'  
      - name: Install Dependencies  
        run: npm install  
      - name: Deploy to Capgo  
        run: npx @capgo/cli deploy  
        env:  
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

이 통합은 빠르고 안전하며 비용 효율적인 앱 업데이트를 보장하여, 민첩한 개발 팀에 이상적입니다.

GitHub 작업 튜토리얼 - 기본 개념 및 CI/CD 파이프라인

GitHub 작업

설정 요구사항

Capgo 통합 GitHub Actions와 통합하려면 필요한 도구와 설정을 준비해야 합니다.

필요한 도구와 계정

다음 계정과 도구를 준비했는지 확인하세요:

요구 사항	목적	상세 정보
GitHub 계정	버전 관리 및 CI/CD	레포지토리 접근 권한이 있는 활성 계정
Capgo 계정	Live Updates 관리	플랜은 월 $12부터 시작
Capacitor 프로젝트	앱 개발	통합을 위한 준비가 완료된 프로젝트
Node.js	런타임 환경	최신 LTS 버전 사용 권장

이 모든 것이 준비되면, 자동 라이브 업데이트를 위해 프로젝트에 Capgo를 추가할 수 있습니다.

추가하기 Capgo 프로젝트에 추가

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

Capgo를 통합하려면 CLI 도구를 사용하여 Capacitor 프로젝트에 설치하세요. Capgo의 설립자 Martin Donadieu의 말처럼:

“npx @capgo/cli init를 실행하세요!” [1]

이 명령은 플러그인과 필요한 의존성을 설정합니다.

GitHub 리포지토리 설정

Capgo와의 CI/CD 통합 요구 사항을 충족하도록 GitHub 리포지토리를 준비하세요.

워크플로우를 추가하기 전에 OTA 릴리스 프로세스에 필요한 secrets, 브랜치 보호, 배포 트리거가 리포지토리에 설정되어 있는지 확인하세요.

요금제

Capgo 플랜은 월 $12부터 시작합니다.
같은 플랜에 OTA 업데이트와 월 약 15회의 Native Build가 포함됩니다.
추가 빌드 시간은 크레딧으로 분 단위 과금됩니다.

리포지토리 설정 방법은 다음과 같습니다:

리포지토리 구조: 소스 code, 에셋, 설정 파일을 별도 디렉토리로 구성해 깔끔하게 관리하세요.
환경 설정: 개발, 스테이징, 프로덕션 환경을 분리하고 적절한 액세스 제어와 보안 조치를 적용하세요.
액세스 관리: 저장소 권한을 신중하게 설정하여 허용 Capgo 통합 보안을 유지하면서.

이 단계들을 통해 다음 섹션에서 설명할 GitHub Actions 워크플로우에 대비하여 프로젝트가 준비되었는지 확인할 수 있습니다.

GitHub Actions 워크플로우 설정

귀하의 Capgo 배포를 GitHub Actions를 사용하여 CI/CD 프로세스를 간소화하세요.

워크플로 파일 만들기

리포지토리의 .github/workflows 디렉터리에 YAML 파일을 만들어 시작하세요. 예시는 다음과 같습니다:

name: Capgo Deploy
on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v3
        with:
          node-version: '24'
      - name: Install Dependencies
        run: npm install
      - name: Build App
        run: npm run build
      - name: Deploy to Capgo
        run: npx @capgo/cli deploy
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

이 설정을 통해 안전하고 자동화된 배포가 가능합니다. 파일 설정이 완료되면 워크플로우에 적합한 트리거를 선택하세요.

워크플로우 트리거 옵션

GitHub Actions를 사용하면 워크플로우 실행 시점을 커스텀할 수 있습니다. 주요 트리거 옵션은 다음과 같습니다:

트리거 유형	사용 사례	설정
Push 이벤트	code 변경 시 배포	특정 브랜치에 code가 push될 때 활성화
수동 실행	온디맨드 업데이트	워크플로우를 수동으로 시작할 수 있습니다
일정	예약된 릴리스	설정된 간격으로 배포를 실행합니다
Pull Request	업데이트 테스트	메인 브랜치에 머지하기 전 변경 사항을 테스트합니다

Secret Key 관리

안전한 배포를 위해 Secret Key를 적절히 관리해야 합니다. GitHub Actions는 이를 위해 암호화된 Secret 관리 시스템을 제공합니다.

보안 인증 설정 단계:

Repository Settings 접속
Repository의 Settings로 이동한 뒤, “Security” 탭 아래의 “Secrets and variables” 섹션을 찾으세요.
추가 Capgo 인증 정보
Capgo 인증 토큰을 repository secret으로 저장하세요. 이름은 다음과 같이 지정합니다: CAPGO_TOKEN.
워크플로에서 Secret 참조하기
저장한 secret을 워크플로에서 다음과 같이 참조해 사용하세요: ${{ secrets.CAPGO_TOKEN }}.

워크플로 내 Capgo 명령어

GitHub Actions 환경 설정이 완료되면 Capgo CLI 명령어를 통합해 배포를 자동화할 수 있습니다.

Capgo CLI 설치하기

Capgo CLI를 설치하려면 워크플로에 다음 단계를 추가하세요:

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Initialize Capgo
    run: npx @capgo/cli init

CLI 인증하기

CLI를 안전하게 인증하려면 다음을 사용하세요: CAPGO_TOKEN:

- name: Authenticate Capgo CLI
  run: npx @capgo/cli login
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

배포 명령어

업데이트의 빌드, 버전 관리, 배포를 처리하는 주요 명령어는 다음과 같습니다:

명령어	목적	사용 예시
`build`	다음을 생성: 프로덕션용 bundle	`npx @capgo/cli build`
`deploy`	Capgo로 업데이트 푸시	`npx @capgo/cli deploy`
`version`	업데이트 버전 설정	`npx @capgo/cli version 1.2.0`

전체 배포 프로세스를 자동화하려면 다음 명령어를 함께 사용하세요:

steps:
  - name: Build and Deploy
    run: |
      npx @capgo/cli build
      npx @capgo/cli version ${{ github.ref_name }}
      npx @capgo/cli deploy
    env:
      CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

이 설정을 통해 워크플로우가 실행될 때마다 업데이트가 자동으로 빌드, 버전 관리 및 배포됩니다. GitHub의 secret 관리 시스템이 프로세스 전반에 걸쳐 자격 증명을 안전하게 보호합니다.

테스트 및 수정

테스트 워크플로우 실행

전용 도구를 사용하여 GitHub Actions 워크플로우를 테스트할 수 있습니다. Capgo 테스트 채널. 이를 통해 업데이트를 실제 배포하기 전에 검증할 수 있습니다.

- name: Test Build Deployment
  run: |
    npx @capgo/cli build
    npx @capgo/cli deploy --channel beta
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Capgo의 채널 시스템을 사용하면 각 단계별로 별도의 배포 경로를 생성할 수 있습니다:

채널	목적	대상 사용자
베타	릴리스 전 테스트	내부 팀
스테이징	QA 검증	테스트 사용자
프로덕션	라이브 배포	모든 사용자

오류 해결 방법

자주 발생하는 통합 이슈와 해결 방법은 다음과 같습니다:

1. 인증 실패

GitHub Secrets에서 CAPGO_TOKEN을 확인하세요. 만료된 경우 원활한 인증을 위해 다시 생성하세요.

2. 빌드 오류

빌드 설정이 배포 환경의 요구 사항과 일치하는지 확인하세요.

“프로덕션 환경에서 5,000명 이상의 사용자에게 Capgo OTA 업데이트를 배포했습니다. 운영이 매우 원활하며, @Capgo에 OTA가 배포된 후 몇 분 안에 거의 모든 사용자가 최신 상태입니다.” [1]

3. 버전 충돌

배포 중 충돌을 방지하려면 시맨틱 버저닝을 준수하고 버전을 적절히 올려주세요.

유지보수 팁

사용 Capgo 분석 업데이트 성공률을 모니터링하세요.
문제가 발생할 수 있는 업데이트에 대해 자동 롤백을 활성화하세요.
채널 선택자를 사용해 pull request(PR)를 테스트하고 더 나은 제어를 하세요.
워크플로우를 최신 Capgo CLI 명령으로 유지하세요.

높은 우선순위의 배포에서는 Capgo의 에러 추적을 활용하여 잠재적인 문제를 조기에 발견하세요. 문제가 발생하면 롤백 기능을 통해 안정된 버전으로 빠르게 되돌려 중단 시간을 최소화할 수 있습니다. 이러한 관행은 프로덕션 환경에 가까워질수록 배포가 원활하게 유지되도록 돕습니다.

마치며

핵심 요약

Capgo의 GitHub Actions 통합은 배포 프로세스를 단순화합니다 Capacitor 앱, 개발 팀에 큰 이점을 제공합니다. 업데이트의 전 세계 성공률이 82%에 달하며, 활성 사용자의 95%가 24시간 이내에 업데이트를 받습니다 [1], 이 솔루션은 효율성에서 두각을 나타냅니다.

주요 기능은 다음과 같습니다:

자동화 워크플로: GitHub Actions에서 워크플로를 직접 구성하므로 외부 CI/CD 호스팅이 필요 없습니다. 이 방식은 AppFlow와 같은 대안 대비 5년간 약 26,100달러의 운영 비용을 절감합니다 [1].
빠른 배포: 앱 스토어 지연을 우회하여 즉시 업데이트를 배포할 수 있습니다.
강력한 보안: 끝에서 끝까지 암호화를 통해 업데이트가 안전하게 전달되며, Capgo의 채널 시스템은 제어된 단계별 롤아웃을 허용합니다.

이러한 기능은 더 맞춤형 솔루션과 향상된 성능의 기반을 마련하며, 아래에서 자세히 살펴봅니다.

고급 전략

Capgo과 GitHub Actions 통합의 잠재력을 최대한 끌어올리기 위해, 다음 고급 전술을 확인해 보세요:

커스텀 API 워크플로: Capgo의 공개 API을 활용하여 팀의 요구사항에 맞는 배포 워크플로를 설계하세요. 이를 통해 화이트라벨 경험과 기존 도구와의 원활한 통합이 가능합니다. [1].
채널 기반 릴리스: Capgo의 채널 기능을 활용하여 단계적이고 통제된 업데이트를 통해 배포 프로세스를 최적화하세요.
최적화된 성능: Capgo의 부분 업데이트를 활용하여 대역폭 사용량을 줄이고 업데이트 속도를 높입니다. 750개의 프로덕션 앱에 2,350만 건의 업데이트를 전달하며 [1], 대규모 수요 처리 능력을 입증했습니다.

더 나은 결과를 위해 Capgo의 셀프호스팅 옵션이나 커스텀 API 설정을 고려해 보세요. 이러한 전략을 완전히 구현하려면 이전 섹션의 상세 설정 및 테스트 지침을 확인하세요.

Capgo과 GitHub Actions 통합: 가이드에서 계속

사용 중이라면 Capgo와 GitHub Actions 연동 가이드 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: