Capgo GitHub과 통합하는 방법: 가이드

Capgo 그리고 GitHub 액션 을 함께 사용하여 업데이트를 배포하는 과정을 단순화하세요. Capacitor 앱을 통합하는 이유는 무엇인가요?:

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

빠른 개요

1. 요구 사항: GitHub 계정, Capgo 계정 (월 $12/회), Capacitor 프로젝트, Node.js.
2. 설치: 설치 Capgo CLI 와 함께 npx @capgo/cli init, GitHub Actions를 YAML 워크플로와 함께 구성합니다.
3. 배포: 명령어를 사용하여 npx @capgo/cli deploy __CAPGO_KEEP_0__ 업데이트를 자동화하는 방법.
4. Testing: 프로덕션 이전에 테스트 채널 (예: 베타, 스테이징)으로 배포합니다.

예시 워크플로 (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 Actions 튜토리얼 - 기본 개념과 CI/CD PIPELINE

설정 요구 사항

Capgo 통합 GitHub 액션은 필요한 도구 및 설정을 구성하는 것을 포함합니다.

필수 도구 및 계정

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

이러한 설정이 완료되면 Capgo을 프로젝트에 추가하여 자동화된 실시간 업데이트 기능을 사용할 수 있습니다.

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

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

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

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

GitHub 저장소 설정

GitHub 저장소를 CI/CD 통합을 위해 Capgo과 호환되도록 준비하세요.

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

가격

• Capgo 플랜은 1달에 12달러부터 시작합니다.
• 같은 플랜에는 OTA 업데이트 및 1달에 15개 정도의 네이티브 빌드가 포함됩니다.
• 추가 빌드 분량은 분당 크레딧으로 청구됩니다.

저장소를 설정하는 방법은 다음과 같습니다.

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

이러한 단계는 프로젝트가 다음 섹션에서 설명할 GitHub Actions 워크플로우에 준비되도록 합니다.

GitHub Actions 워크플로우 설정

자동화된 Capgo 배포 GitHub Actions를 사용하여 CI/CD 프로세스를 간소화하는 데 도움이 됩니다.

워크플로 파일 생성

시작하기 위해서는 repository의 디렉토리에 YAML 파일을 생성하세요. 예를 들어: .github/workflows 이 설정은 보안 및 자동화된 배포를 보장합니다. 파일을 설정한 후에, workflow의 올바른 트리거를 선택하세요.

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는 이 목적으로 암호화된 비밀 키 관리 시스템을 제공합니다.

보안 인증 설정 방법:

1. 저장소 설정에 접근합니다.
   레포지토리의 설정으로 이동하여 '보안' 탭 하단의 '비밀 및 변수' 섹션을 찾으세요.

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

배포 명령어

업데이트를 처리하는 데 필요한 주요 명령어는 다음과 같습니다.

이 설정은 워크플로우가 실행될 때마다 업데이트를 자동으로 빌드, 버전, 배포하도록 보장합니다. __CAPGO_KEEP_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 }}

This setup ensures that your updates are automatically built, versioned, and deployed whenever the workflow runs. GitHub’s secret management system keeps your credentials safe throughout the process.

__CAPGO_KEEP_0__

테스트 워크플로우 실행

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 토큰이 GitHub Secret에 존재하는지 확인합니다. 만약 만료되었다면, 새로 생성하여 인증을 원활하게 하세요.

2. 빌드 오류

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

“We rolled out Capgo OTA updates in production for our user base of +5000. We’re seeing very smooth operation almost all our users are upto date within minutes of the OTA being deployed to @Capgo.” [1]

3. 버전 충돌

배포 시 충돌을 예방하기 위해 버전을 올바르게 증가시키고 의미 있는 버전 관리를 유지하세요.

유지 보수 팁

• 업데이트 성공률을 모니터링하기 위해 Capgo 분석을 사용하세요. 업데이트가 문제를 일으킬 수 있는 경우 자동 롤백을 활성화하세요.
• 채널 선택자로 더 나은 제어를 위해 PR 테스트를 진행하세요.
• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 명령어를 최신 상태로 유지하기 위해 워크플로우를 업데이트하세요.
• 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_KEEP_0__

Capgo의 통합 GitHub Actions은 배포 프로세스를 단순화하고 Capacitor 앱, 개발 팀에게 주요 이점을 제공하는 [1]배포 프로세스의 효율성을 높인다. 업데이트의 글로벌 성공률 82%와 24시간 이내에 업데이트를 받는 활성 사용자 95%를 기록한

이 솔루션은 효율성에서 우수하다.

• 다음과 같은 특징이 있습니다.: 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__ Actions에서 워크플로우를 직접 구성하면 외부 CI/CD 호스팅이 필요하지 않다. AppFlow와 같은 대안과 비교하여 5년 동안 약 $26,100을 절약할 수 있다.빠른 배포
• : 업데이트를 즉시 푸시할 수 있으며 앱 스토어 지연을 피할 수 있다.: End-to-end encryption ensures updates are delivered securely, while Capgo’s channel system allows for controlled, staged rollouts.

: 업데이트가 안전하게 전달되도록 엔드 투 엔드 암호화가 제공되고 __CAPGO_KEEP_0__의 채널 시스템은 제어된 스테이지 롤아웃을 허용한다.

고급 전략

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

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

Capgo와 API 액션 통합: 가이드

Keep going from Capgo Integration with GitHub Actions: Guide

__CAPGO_KEEP_0__ Capgo GitHub 연동 가이드 __CAPGO_KEEP_0__와 연결하여 보안 및 규정 준수 계획을 수립하세요. __CAPGO_KEEP_0__ 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 사항에 대한 구현 세부 사항입니다. __CAPGO_KEEP_0__ 규정 준수 __CAPGO_KEEP_0__ 규정 준수 구현 세부 사항에 대한 구현 세부 사항입니다. Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로에 대한 제품 워크플로입니다. Capgo 보안 Capgo 보안의 제품 워크플로에 대한 제품 워크플로입니다. Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로에 대한 제품 워크플로입니다.