Capgo와 GitHub의 통합: 가이드

Capgo 및 GitHub Actions __CAPGO_KEEP_0__를 함께 사용하여 앱 업데이트를 배포하는 데 드는 비용을 단순화하세요. Capacitor 이 통합이 당신의 관심을 끌 만한 이유는 무엇인가요?

• 비용 절감CI/CD 비용을 5년간 $26,100까지 절감하세요. 빠른 업데이트.
• 업데이트를 즉시 푸시하여 24시간 이내에 95%의 사용자가 업데이트를 받을 수 있습니다.안전한 배포
• 업데이트가 안전하도록 엔드 투 엔드 암호화가 제공됩니다.순조로운 워크플로우
• Streamlined Workflow: GitHub 자동 빌드 및 배포를 직접 저장소에서 자동화하세요.

빠른 개요

1. 요구 사항: GitHub 계정, Capgo 계정 (월 $12/부터), Capacitor 프로젝트, Node.js.
2. 설치: __CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 설치하고 Capgo CLI 설정 npx @capgo/cli init: GitHub __CAPGO_KEEP_1__을 설치하고
3. 배포: __CAPGO_KEEP_0__ 명령어를 사용하여 npx @capgo/cli deploy 로 자동 업데이트.
4. 테스트: 프로덕션 이전에 테스트 채널 (예: 베타, 스테이징)에서 배포합니다.

예시 워크플로 (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 }}  

이 통합은 빠른, 안전하고 비용 효율적인 앱 업데이트를 보장하여 Agile 개발 팀에게 적합합니다.

GitHub 액션 튜토리얼 - 기본 개념과 CI/CD PIPELINE

설치 요구 사항

Capgo GitHub

필요한 도구 및 계정 설정

다음 계정 및 도구가 준비되어야 합니다:

이러한 설정이 완료되면, 자동화된 실시간 업데이트에 Capgo를 프로젝트에 추가할 수 있습니다.

추가 Capgo 프로젝트에 추가

To integrate Capgo, install it in your Capacitor project using its CLI tool. According to Martin Donadieu, founder of Capgo:

“Run npx @capgo/cli init that it!” [1]

This command will set up the plugin and its required dependencies.

GitHub Repository Setup

Prepare your GitHub repository to meet the requirements for CI/CD integration with Capgo.

__CAPGO_KEEP_0__ 저장소는 __CAPGO_KEEP_1__와 CI/CD 통합을 위한 요구 사항을 충족해야 합니다.

워크플로우를 추가하기 전에 저장소가 필요한 비밀, branch 보호, OTA 릴리즈 프로세스에 대한 배포 트리거를 확인해야 합니다.

• Capgo plans start at $12/month.
• __CAPGO_KEEP_0__ 플랜은 월 $12부터 시작합니다.
• __CAPGO_KEEP_0__ 플랜은 OTA 업데이트와 월 15개 이상의 네이티브 빌드를 포함합니다.

추가 빌드 분량은 분당 크레딧으로 청구됩니다.

• 저장소 구조: 저장소에 소스 code, 자산, 및 구성 파일을 별도의 디렉토리로 분리하여 모든 것을 깨끗하고 관리하기 쉬운 상태로 유지하세요.
• 환경 설정: 개발, 스테이징, 및 프로덕션 환경을 구분하여 적절한 접근 제어 및 보안 조치를 취하세요.
• 접근 관리: 저장소 권한을 신중하게 설정하여 Capgo 통합

These steps will ensure your project is ready for the GitHub Actions workflow, which will be outlined in the next section.

이러한 단계는 프로젝트가 GitHub Actions 워크플로를 사용할 준비가 된 것을 보장합니다. 다음 섹션에서 워크플로 설정 방법을 설명할 것입니다.

__CAPGO_KEEP_0__ Actions 워크플로 설정 Capgo deployments using GitHub 액션을 사용하여 CI/CD 프로세스를 간소화하세요.

워크플로우 파일 만들기

워크플로우 파일을 만들기 위해 먼저 저장소의 디렉토리에 YAML 파일을 생성하세요. 예를 들어: .github/workflows 이 구성은 보안되고 자동화된 배포를 보장합니다. 파일을 설정한 후에, 워크플로우의 트리거를 선택하세요.

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 }}

워크플로우 트리거 옵션

__CAPGO_KEEP_0__ 액션을 사용하여 워크플로우가 실행되는 시기를 맞춤화할 수 있습니다. 다음 트리거 옵션을 참고하세요:

GitHub Actions allows you to customize when workflows run. Here are some trigger options:

비밀 키 관리

GitHub Actions는 이 목적으로 암호화된 비밀 키 관리 시스템을 제공합니다.

Secure Authentication Settings:

1. Repository Settings Access
   repository settings의 'Security' 탭 하단의 'Secrets and variables' 섹션으로 이동하세요.

2. 추가 Capgo 인증 정보
   Capgo 인증 토큰을 저장소 비밀로 저장하세요. 이름을 CAPGO_TOKEN.

3. 저장소 비밀 참조
   저장소 비밀을 참조하여 워크플로우에서 사용하세요. ${{ secrets.CAPGO_TOKEN }}.

Capgo 워크플로우 명령

GitHub 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의 비밀 관리 시스템은 프로세스 전반에 걸쳐 자격 증명이 안전하게 보관됩니다.

테스트 및 수정

테스트 워크플로우 실행

GitHub 액션 워크플로우를 테스트하려면 전용 Capgo 테스트 채널을 사용할 수 있습니다. 이로 인해 업데이트가 실시간으로 출시되기 전에 유효성을 검사할 수 있습니다.

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

Capgo 채널 시스템은 다양한 단계에 대한 별도의 배포 경로를 만들 수 있도록 도와줍니다:

오류 해결

다음은 일반적인 통합 문제와 해결 방법입니다:

1. 인증 실패

CAPGO_TOKEN이 GitHub Secret에 존재하는지 확인합니다. 만약 만료되었다면, 새로 생성하여 인증을 원활하게 하세요.

2. 빌드 오류

__CAPGO_KEEP_0__ 환경에 맞는 빌드 설정을 확인하세요.

“Capgo OTA 업데이트를 프로덕션에서 +5000 명의 사용자에게 배포했습니다. 거의 모든 사용자가 업데이트가 배포된 후 @Capgo 에서 몇 분 안에 업데이트가 완료되었습니다.” [1]

3. 버전 충돌

버전 충돌을 예방하고 배포 중에 문제가 발생하지 않도록 버전을 올바르게 증가시키고 의미 있는 버전 관리를 유지하세요.

유지 관리 팁

• __CAPGO_KEEP_0__ 분석을 사용하여 업데이트 성공률을 모니터링하세요. Capgo analytics PR(요청)을 채널 선택자로 테스트하여 더 나은 제어를 하세요.
• 최신 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 명령을 사용하여 워크플로를 업데이트하세요.
• 고 우선순위 배포 시, __CAPGO_KEEP_0__ 에러 추적 기능을 사용하여 문제를 일찍 발견하세요. 문제가 발생하면 롤백 기능을 사용하여 안정적인 버전으로 되돌아가서 중단을 최소화하세요. 이러한 방법들은 프로덕션에 가까운 배포를 하면서 배포가 원활하게 진행되도록 도와줍니다.
• Keep your workflow updated with the latest Capgo CLI commands.

Capgo 사용

결론

주요 강점

Capgo’s GitHub Actions와의 통합은 배포 프로세스를 단순화시켜 개발 팀에게 큰 이점을 제공합니다. Capacitor 앱, 전 세계 업데이트의 82% 성공률과 24시간 이내에 업데이트를 받는 활성 사용자의 95%를 기록하고 있는 이 솔루션은 효율성으로 두각을 나타냅니다. [1]다음과 같은 주요 기능이 있습니다:

자동화된 워크플로우

• : __CAPGO_KEEP_0__ Actions에서 워크플로우를 직접 구성하면 외부 CI/CD 호스팅이 필요하지 않습니다. 이 접근 방식은 AppFlow와 같은 대안보다 5년 동안 약 $26,100을 절약할 수 있습니다.: By configuring workflows directly in GitHub Actions, there’s no need for external CI/CD hosting. This approach cuts operational costs, saving about $26,100 over five years compared to alternatives like AppFlow [1].
• : 업데이트를 즉시 푸시할 수 있으며 앱 스토어 지연을 피할 수 있습니다.강력한 보안
• Strong Security: Capgo의 종합 암호화는 업데이트가 안전하게 전달되며, Capgo의 채널 시스템은 제어되고 단계별로 업데이트를 허용합니다.

These features pave the way for more tailored solutions and improved performance, explored further below.

고급 전략

Capgo와 GitHub 액션 통합을 최대한 활용하려면 다음 고급 전략을 살펴보세요:

• 고유 API 워크플로우: Capgo의 공개 API을 사용하여 팀의 특정 요구에 맞는 배포 워크플로우를 설계할 수 있습니다. 이로 인해 백색 레이블 경험과 현재 도구와의 무결성을 제공할 수 있습니다. [1].
• 채널 기반 배포: Capgo의 채널 기능을 사용하여 단계별 및 제어된 업데이트를 위해 배포 프로세스를 최적화하세요.
• 최적화된 성능: Capgo의 부분 업데이트를 사용하여 대역폭 사용량을 줄이고 업데이트를 가속화하세요. 750개의 운영 앱에서 23.5만 건의 업데이트를 전달한 시스템은 대규모 수요를 처리할 수 있는 능력을 입증했습니다. [1]더 나은 결과를 위해, __CAPGO_KEEP_0__의 자체 호스팅 옵션 또는 고유 __CAPGO_KEEP_1__ 설정을 고려하세요. 이전 섹션에서 자세한 설정 및 테스트 지침을 확인하여 이러한 전략을 완전히 구현하세요.

For even better results, consider using Capgo’s self-hosting options or custom API setups. Check earlier sections for detailed setup and testing instructions to fully implement these strategies.