Capgo와 GitHub의 통합: 가이드

Capgo 및 GitHub Actions Capgo와 함께 Live Update Platform을 사용하면 앱을 배포하는 업데이트를 단순화할 수 있습니다. Capacitor 비용 절감

• : 5년 동안 CI/CD 비용을 $26,100에서 절감할 수 있습니다.AppFlow 빠른 업데이트.
• : 24시간 이내에 95%의 사용자가 업데이트를 받을 수 있습니다.안전한 배포
• __CAPGO_KEEP_0__: __CAPGO_KEEP_0__ 암호화는 업데이트가 안전하도록 보장합니다.
• Streamlined Workflow: GitHub 저장소에서 직접 빌드 및 배포를 자동화합니다.

Quick Overview

1. Requirements: GitHub 계정 Capgo 계정 (월 $12 이상), Capacitor 프로젝트 Node.js.
2. __CAPGO_KEEP_0__ 설정: 설치 Capgo CLI 과 npx @capgo/cli init, GitHub Actions을 YAML 워크플로우와 함께 구성합니다.
3. 배포: npx @capgo/cli deploy Live updates product page의 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `live_update_dynamic_label_to` (Live Update Dynamic Label To). 자동화.
4. 테스트:

테스트 채널 (예: 베타, 스테이징)으로부터 프로덕션 이전에 배포합니다.:

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

예시 워크플로우 (YAML)

GitHub Actions __CAPGO_KEEP_0__ Actions

설정 요구 사항

Capgo과 GitHub Actions 통합 GitHub과 GitHub Actions 통합에는 필요한 도구와 설정을 구성하는 것이 포함됩니다.

필요한 도구 및 계정

다음 계정과 도구가 준비되어 있는지 확인하세요.

이러한 준비가 끝나면 Capgo을 프로젝트에 추가하여 자동화된 실시간 업데이트 기능을 사용할 수 있습니다

추가 Capgo 프로젝트에

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

“Capgo를 설치하세요! npx @capgo/cli init” [1]

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

GitHub Repository Setup

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

CI/CD 통합을 위해 Capgo 프로젝트를 준비하기 전에, repository에 필요한 비밀, branch 보호, OTA 릴리즈 프로세스에 대한 배포 트리거가 있는지 확인하세요.

가격

• Capgo의 가격은 1달에 12달러부터 시작됩니다.
• 같은 가격에 OTA 업데이트와 1달에 15개의 네이티브 빌드가 포함됩니다.
• 분당 빌드 시간이 __CAPGO_KEEP_0__을 통해 분당 요금으로 청구됩니다.

다음 단계를 통해 리포지토리를 설정하세요:

• 리포지토리 구조: Organize your repository with separate directories for source code, assets, and configuration files to keep everything clean and manageable.
• 환경 설정: 개발, 스테이징, 프로덕션 환경을 별도로 구분하여 적절한 접근 권한 및 보안 조치를 취하세요.
• 권한 관리: 리포지토리 권한을 신중하게 설정하여 __CAPGO_KEEP_0__ 통합을 허용하면서 보안을 유지하세요. 다음 단계를 통해 프로젝트가 Capgo Actions 워크플로에 준비되도록 하세요. __CAPGO_KEEP_0__ Actions 워크플로 설정

분당 빌드 시간이 GitHub을 통해 분당 요금으로 청구됩니다.

GitHub Actions Workflow Setup

자동화 Capgo 배포 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:

비밀 키 관리

To ensure secure deployments, you need to manage your secret keys properly. GitHub Actions offers an encrypted secrets management system for this purpose.

보안 인증 설정하기:

1. 저장소 설정으로 이동
   저장소 설정으로 이동하여 '보안' 탭의 '비밀 키 및 변수' 섹션을 찾으세요.

2. 추가 Capgo Credentials
   Save your Capgo authentication token as a repository secret. Name it CAPGO_TOKEN.

3. 워크플로우에서 비밀 키 참조
   저장된 비밀 키를 워크플로우에서 참조하세요. ${{ secrets.CAPGO_TOKEN }}.

Capgo Commands in Workflows

Once your GitHub Actions environment is set up, you can automate deployments by integrating Capgo CLI commands.

설치 Capgo CLI

Capgo CLI를 설치하기 위해 workflow에 다음 단계를 추가하세요.

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 액션 워크플로우를 테스트하려면 전용 GitHub 테스트 채널을 사용하십시오. Capgo testing channel__CAPGO_KEEP_0__ 채널 시스템은 다양한 단계에 대한 별도의 배포 경로를 만들 수 있도록 도와줍니다:

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

Capgo’s channel system helps you create separate deployment paths for different stages:

오류 해결

다음과 같은 일반적인 통합 문제와 해결 방법이 있습니다:

1. 인증 실패

CAPGO_TOKEN을 GitHub Secret에 확인하세요. 만약 만료되었다면, 인증을 원활하게 하기 위해 다시 생성하세요.

2. 빌드 오류

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

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

3. 버전 충돌

버전 관리를 위해 semantic 버전을 사용하고 버전을 올바르게 증가시키세요. 배포 중에 충돌을 방지하세요.

유지 관리 팁

• 사용 Capgo 분석 업데이트 성공률을 모니터링하세요.
• 업데이트가 문제를 일으킬 수 있는 경우 자동 롤백을 활성화하세요.
• Pull Request(Pull Request) 테스트를 위해 채널 선택기를 사용하세요. 더 나은 제어를 위해.
• 최신 Capgo CLI 명령을 사용하여 워크플로우를 최신 상태로 유지하세요.

고급 배포를 위해 Capgo의 오류 추적 기능을 사용하여 잠재적인 문제를 빠르게 식별하세요. 문제가 발생하면 롤백 기능을 사용하여 안정적인 버전으로 빠르게 되돌아가서 중단을 최소화하세요. 이러한 방법은 프로덕션에 가까운 상태에서 배포를 원활하게 유지하는 데 도움이 됩니다.

결론

주요 특징

Capgo의 GitHub Actions 통합은 Capgo 앱의 배포 프로세스를 단순화하여 개발 팀에게 큰 이점을 제공합니다. Capacitor 앱의 배포 프로세스를 단순화하여 개발 팀에게 큰 이점을 제공합니다.__CAPGO_KEEP_0__의 통합은 업데이트의 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].
• __CAPGO_KEEP_0__ 앱의 배포 프로세스를 단순화하여 개발 팀에게 큰 이점을 제공합니다.: 업데이트는 즉시 푸시 될 수 있으며 앱 스토어 지연을 피할 수 있습니다.
• 강력한 보안: 업데이트가 안전하게 전달되도록 엔드 투 엔드 암호화가 보장되며 Capgo의 채널 시스템은 제어된 단계별 롤아웃을 허용합니다.

이러한 기능은 더 세련된 솔루션과 향상된 성능을 위한 길을 열어두고 있습니다. 아래에서 더 자세히 살펴보겠습니다.

고급 전략

To get the most out of your Capgo and GitHub Actions integration, explore these advanced tactics:

• Custom API Workflows: Use Capgo’s public API to design deployment workflows that fit your team’s specific needs. This can enable white-label experiences and seamless integration with your current tools [1].
• 채널 기반 릴리스: Optimize your deployment process by using Capgo’s channel features for staged and controlled updates.
• 최적화된 성능: Utilize Capgo’s partial updates to reduce bandwidth usage and speed up updates. With 23.5 million updates delivered across 750 production apps [1], 시스템은 대규모 수요를 처리할 수 있는 능력을 입증했습니다.

더 나은 결과를 위해, Capgo의 자체 호스팅 옵션 또는 API의 커스텀 설정을 고려하십시오. 이전 섹션을 참조하여 세부 설정 및 테스트 지침을 확인하여 이러한 전략을 완전히 구현하십시오.

Capgo와 GitHub Actions: 가이드를 계속 진행하십시오.

만약 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용중이라면 Capgo와 GitHub Actions: 가이드를 사용하여 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 Capgo와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 Capgo와 __CAPGO_KEEP_1__ Actions: 가이드를 사용하여 Capgo 보안 제품 워크플로우에서 Capgo 보안 Capgo 신뢰 센터 제품 워크플로우에서 Capgo 신뢰 센터.