Capgo와 GitHub Actions 통합 가이드

Capgo 및 GitHub 액션 함께 업데이트 배포를 간소화하여 Capacitor 앱을 관리하세요. 이 통합이 주목받는 이유는 다음과 같습니다:

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

개요

1. 요구 사항: GitHub 계정, Capgo 계정 (월 $12부터), Capacitor 프로젝트, Node.js.
2. 설정: 설치하기 Capgo CLI 함께 npx @capgo/cli init, YAML 워크플로우로 GitHub Actions 설정하기.
3. 배포: 다음 명령어 사용하기 npx @capgo/cli deploy 로 업데이트 자동화.
4. 테스트: 프로덕션 배포 전 테스트 채널(예: 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 파이프라인

설정 요구사항

Capgo 통합하기 GitHub Actions와 연동하려면 필요한 도구와 설정을 구성해야 합니다.

필수 도구 및 계정

다음 계정 및 도구가 준비되었는지 확인하세요:

준비가 완료되면, 자동화된 Live Update를 위해 프로젝트에 Capgo를 추가할 수 있습니다.

프로젝트에 Capgo 추가하기

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 워크플로우 설정

CI/CD 프로세스를 효율화하기 위해 Capgo 배포를 GitHub Actions로 자동화하세요.

워크플로우 파일 생성하기

먼저 저장소의 .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를 사용하면 워크플로우 실행 시점을 커스텀할 수 있습니다. 주요 트리거 옵션은 다음과 같습니다:

Secret Key 관리

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

보안 인증 설정 단계:

1. Repository Settings 접속
   Repository의 Settings로 이동한 뒤, “Security” 탭 아래의 “Secrets and variables” 섹션을 찾으세요.

2. 추가 Capgo 인증 정보
   Capgo 인증 토큰을 repository secret으로 저장하세요. 이름은 다음과 같이 설정합니다: CAPGO_TOKEN.

3. 워크플로에서 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 }}

배포 명령어

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

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

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의 채널 시스템을 사용하면 단계별로 별도의 배포 경로를 구축할 수 있습니다:

오류 해결 방법

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

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의 partial updates를 사용하여 대역폭 사용량을 줄이고 업데이트 속도를 높이세요. 750개의 프로덕션 앱에서 2,350만 건의 업데이트를 처리하며 [1], 대규모 수요를 처리할 수 있는 성능을 이미 입증했습니다.

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

계속 읽기: Capgo와 GitHub Actions 통합 가이드

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