Capgo Integration with GitHub Actions: Guide

Capgo 그리고 GitHub Actions __CAPGO_KEEP_0__ Capacitor .apps를 위한 업데이트를 배포하는 것을 단순화합니다.

• Save Money: 5년 동안 AppFlow와 비교하여 최대 $26,100을 절약할 수 있습니다. Fast Updates.
• : 24시간 이내에 95%의 사용자가 업데이트를 받을 수 있습니다.Secure Deployments
• : 업데이트가 안전하도록 엔드 투 엔드 암호화가 제공됩니다.Streamlined Workflow
• Streamlined Workflow: GitHub에서 빌드 및 배포를 자동화하세요.

빠른 개요

1. 필요 조건: GitHub 계정 Capgo 계정 (월 $12 이상), Capacitor 프로젝트 Node.js.
2. 설정: 설치 Capgo CLI 와 npx @capgo/cli init, YAML 워크플로우를 사용하여 GitHub 액션을 구성하세요.
3. 배포: Live updates product page. Role: Short UI label or navigation item. Message key `live_update_dynamic_label_to` (Live Update Dynamic Label To). npx @capgo/cli deploy 업데이트 테스트.
4. : 테스트 채널 (예: 베타, 스테이징)로 배포하기 전에 프로덕션에 배포합니다.예시 워크플로우 (YAML)

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

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

__CAPGO_KEEP_0__ 액션

GitHub Actions __CAPGO_KEEP_0__ 액션

설정 요구 사항

Integrating Capgo GitHub을 위한 Capgo와 GitHub Actions 통합은 필요한 도구 및 설정을 구성하는 것을 포함합니다.

필요한 도구 및 계정

Capgo와 GitHub Actions 통합을 위해 다음 계정 및 도구가 준비되어야 합니다.

Capgo를 프로젝트에 추가하여 자동화된 실시간 업데이트 기능을 사용할 수 있습니다.

추가 Capgo __CAPGO_KEEP_0__ 프로젝트에 추가

Capgo을 통합하려면 Capacitor 프로젝트에 CLI 도구를 사용하여 설치하세요. 마틴 도나디외(Martin Donadieu) Capgo의 창립자에 따르면:

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

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

GitHub Repository Setup

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

__CAPGO_KEEP_0__ 저장소에는 OTA 릴리즈 프로세스에 필요한 비밀, branch 보호, 배포 트리거가 있어야 합니다.

__CAPGO_KEEP_4__

• Capgo 플랜은 월 $12부터 시작됩니다.
• __CAPGO_KEEP_0__ 플랜은 OTA 업데이트와 월 15개 이상의 네이티브 빌드를 포함합니다.
• __CAPGO_KEEP_0__ 빌드 분량은 분당 요금으로 계산됩니다.

__CAPGO_KEEP_5__

• 저장소 구조: Organize your repository with separate directories for source code, assets, and configuration files to keep everything clean and manageable.
• 환경 설정: 개발, 스테이징, 프로덕션 환경을 별도로 만들어서 적절한 접근 제어 및 보안 조치를 취하세요.
• 접근 관리: 저장소 권한을 신중하게 설정하여 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 배포 자동화 GitHub Actions을 사용하여 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 }}

이 구성은 안전하고 자동화된 배포를 보장합니다. 파일을 설정한 후에는 워크플로우의 트리거를 선택하세요.

워크플로우 트리거 옵션

GitHub Actions은 워크플로우가 실행되는 시기를 맞춤으로써 사용자가 워크플로우를 커스터마이즈할 수 있습니다. 다음은 트리거 옵션입니다.

비밀 키 관리

안전한 배포를 보장하기 위해 비밀 키를 적절히 관리해야 합니다. GitHub Actions는 이 목적으로 암호화된 비밀 키 관리 시스템을 제공합니다.

보안 인증 설정 방법:

1. 저장소 설정에 접근
   저장소 설정에서 '보안' 탭의 '비밀 및 변수' 섹션으로 이동하여

2. 추가 Capgo 자격 증명
   Capgo 인증 토큰을 저장소 비밀로 저장하고 이름을 CAPGO_TOKEN.

3. __CAPGO_KEEP_0__ 워크플로우에서 비밀 참조
   __CAPGO_KEEP_0__ 워크플로우에서 비밀을 참조하는 방법 ${{ 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 액션 워크플로우를 테스트하기 위해 전용 GitHub 채널을 사용할 수 있습니다. Capgo 테스트 채널__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 토큰이 GitHub Secret에 존재하는지 확인합니다. 만약 만료되었다면, 새로 생성하여 인증을 원활하게 하세요.

2. 빌드 오류

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

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

For high-priority deployments, take advantage of Capgo’s error tracking to spot potential issues early. If something goes wrong, the rollback feature allows you to revert to a stable version quickly, minimizing disruption. These practices will help keep your deployments running smoothly as you move closer to production.

결론

주요 특징

Capgo’s integration with GitHub Actions simplifies the deployment process for Capacitor 앱, 업데이트의 글로벌 성공률 82%와 24시간 이내에 업데이트를 받는 활성 사용자 95%를 달성하여 업데이트의 효율성을 제공합니다. [1], this solution stands out for its efficiency.

다음과 같은 특징이 있습니다:

• 자동화된 워크플로우: GitHub Actions에서 워크플로우를 직접 구성하면 외부 CI/CD 호스팅이 필요하지 않습니다. 이 접근 방식은 AppFlow와 같은 대안보다 연산 비용을 절약하여 5년 동안 약 $26,100을 절약할 수 있습니다. [1].
• 빠른 배포: 업데이트를 즉시 푸시하여 앱 스토어 지연을 피할 수 있습니다.
• 강력한 보안: Capgo의 업데이트는 암호화되어 안전하게 전달되며, Capgo의 채널 시스템은 제어되고 단계별로 업데이트를 제공합니다.

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

고급 전략

Capgo와 GitHub Actions 통합을 최대한 활용하기 위해 다음 고급 전략을 살펴보세요:

• 고유 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.

Capgo와 GitHub의 통합: GitHub 액션 가이드

만약 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__의 통합을 사용하고 있다면 Capgo와 GitHub의 통합: GitHub 액션 가이드 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__의 통합을 사용하여 보안 및 규정 준수 계획을 수립하고 암호화 암호화 구현 세부 사항 규정 준수 규정 준수 구현 세부 사항 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로 Capgo 보안 Capgo 보안의 제품 워크플로 Capgo 신뢰 센터 Capgo 제품 워크플로우에 대한 Capgo 신뢰 센터.