Panduan Integrasi Capgo dengan GitHub Actions

Capgo dan Aksi GitHub bersama-sama mempermudah deployment update untuk Capacitor aplikasi. Berikut alasan integrasi ini layak Anda coba:

• Hemat Biaya: Pangkas biaya CI/CD hingga $26.100 selama 5 tahun dibanding AppFlow.
• Update cepat: Push update instan dengan 95% user menerimanya dalam 24 jam.
• Deployment Aman: End-to-end encryption memastikan update tetap aman.
• Workflow Efisien: Automasi build dan deployment langsung di repositori GitHub Anda.

Ringkasan Cepat

1. Persyaratan: akun GitHub, akun Capgo (mulai $12/bulan), proyek Capacitor, Node.js.
2. Setup: Instal Capgo CLI dengan npx @capgo/cli init, konfigurasi GitHub Actions dengan workflow YAML.
3. Deployment: Gunakan perintah seperti npx @capgo/cli deploy ke otomatiskan update.
4. Pengujian: Deploy ke channel testing (misalnya, beta, staging) sebelum ke production.

Contoh Workflow (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 }}  

Integrasi ini menjamin update aplikasi yang cepat, aman, dan hemat biaya, sangat ideal untuk tim development yang agile.

Aksi GitHub Tutorial - Konsep Dasar dan CI/CD Pipeline

Persyaratan Setup

Integrasi Capgo dengan GitHub Actions memerlukan pengaturan tools dan konfigurasi yang diperlukan.

Tools dan Akun yang Dibutuhkan

Pastikan Anda sudah menyiapkan akun dan tools berikut:

Setelah semua siap, Anda dapat melanjutkan dengan menambahkan Capgo ke proyek Anda untuk otomatisasi Live Update.

Menambahkan Capgo ke Proyek Anda

Untuk mengintegrasikan Capgo, instal di proyek Capacitor Anda menggunakan tool CLI. Menurut Martin Donadieu, founder Capgo:

“Jalankan npx @capgo/cli init dan selesai!” [1]

Perintah ini akan menyiapkan plugin beserta dependensi yang diperlukan.

Setup Repositori GitHub

Siapkan repositori GitHub Anda agar memenuhi persyaratan integrasi CI/CD dengan Capgo.

Sebelum menambahkan workflow, pastikan repositori sudah memiliki secrets, branch protections, dan deployment triggers yang diperlukan untuk proses rilis OTA Anda.

Harga

• Paket Capgo mulai dari $12/bulan.
• Paket yang sama sudah termasuk OTA updates dan sekitar 15 native builds per bulan.
• Tambahan menit build akan ditagih per menit melalui credit.

Berikut cara menyiapkan repositori Anda:

• Struktur Repositori: Atur repositori Anda dengan direktori terpisah untuk source code, aset, dan file konfigurasi agar tetap rapi dan mudah dikelola.
• Konfigurasi Environment: Buat environment berbeda untuk development, staging, dan production, serta pastikan kontrol akses dan langkah keamanan sudah diterapkan.
• Manajemen Akses: Atur izin repositori dengan teliti untuk mengizinkan integrasi Capgo sambil tetap menjaga keamanan.

Langkah-langkah ini akan memastikan proyek Anda siap untuk alur kerja GitHub Actions, yang akan dijelaskan di bagian berikutnya.

Setup Workflow GitHub Actions

Otomatiskan deployment Capgo menggunakan GitHub Actions untuk mempercepat proses CI/CD Anda.

Membuat File Workflow

Mulai dengan membuat file YAML di .github/workflows direktori repositori Anda. Berikut contohnya:

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

Konfigurasi ini memastikan deployment yang aman dan otomatis. Setelah file siap, pilih trigger yang sesuai untuk workflow Anda.

Opsi Trigger Workflow

GitHub Actions memungkinkan Anda mengatur kapan workflow berjalan. Berikut beberapa opsi trigger:

Mengelola Secret Keys

Untuk memastikan deployment yang aman, Anda perlu mengelola secret keys dengan benar. GitHub Actions menyediakan sistem manajemen secrets terenkripsi untuk tujuan ini.

Langkah Setup Autentikasi Aman:

1. Akses Pengaturan Repository
   Buka settings repository Anda dan cari bagian “Secrets and variables” di bawah tab “Security”.

2. Tambah Kredensial Capgo
   Simpan token autentikasi Capgo Anda sebagai repository secret. Beri nama CAPGO_TOKEN.

3. Referensi Secret di Workflow
   Gunakan secret yang telah disimpan di dalam workflow dengan mereferensikannya seperti ini: ${{ secrets.CAPGO_TOKEN }}.

Perintah Capgo di Workflow

Setelah environment GitHub Actions Anda siap, Anda bisa mengotomatisasi deployment dengan mengintegrasikan perintah Capgo CLI GitHub.

Instalasi CLI Capgo

Tambahkan step berikut ke workflow Anda untuk menginstal CLI Capgo:

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Initialize Capgo
    run: npx @capgo/cli init

Authenticating the CLI

Autentikasi CLI secara aman menggunakan CAPGO_TOKEN:

- name: Authenticate Capgo CLI
  run: npx @capgo/cli login
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Perintah Deployment

Berikut adalah perintah utama untuk menangani build, versioning, dan deployment update Anda:

Untuk mengotomatiskan seluruh proses deployment, gunakan perintah-perintah ini secara bersamaan seperti ini:

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

Setup ini memastikan update Anda otomatis di-build, di-versioning, dan di-deploy setiap kali workflow berjalan. Sistem secret management GitHub menjaga kredensial Anda tetap aman selama proses berlangsung.

Testing dan Perbaikan

Menjalankan Workflow Test

Anda dapat menguji workflow GitHub Actions dengan menggunakan channel testing Capgo. Ini memungkinkan Anda memvalidasi update sebelum dirilis ke publik.

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

Sistem channel Capgo membantu Anda membuat jalur deployment terpisah untuk tiap tahap:

Solusi error

Berikut beberapa masalah integrasi umum dan cara mengatasinya:

1. Kegagalan autentikasi

Periksa CAPGO_TOKEN di GitHub Secrets. Jika sudah kedaluwarsa, buat ulang token tersebut agar autentikasi berjalan lancar.

2. Error build

Pastikan konfigurasi build Anda sesuai dengan persyaratan lingkungan deployment Anda.

“Kami merilis Capgo OTA updates di produksi untuk lebih dari 5000 pengguna. Operasinya sangat lancar; hampir semua pengguna kami mendapatkan update dalam hitungan menit setelah OTA di-deploy ke @Capgo.” [1]

3. Konflik versi

Gunakan semantic versioning dan naikkan versi dengan benar untuk mencegah konflik saat deployment.

Tips Maintenance

• Gunakan analitik Capgo untuk memantau tingkat keberhasilan update.
• Aktifkan rollback otomatis untuk update yang berpotensi menimbulkan masalah.
• Uji pull request (PR) dengan channel selector agar kontrol lebih baik.
• Pastikan workflow Anda selalu update dengan perintah Capgo CLI terbaru.

Untuk deployment prioritas tinggi, manfaatkan error tracking dari Capgo untuk mendeteksi masalah lebih awal. Jika terjadi kesalahan, fitur rollback memungkinkan Anda kembali ke versi stabil dengan cepat guna meminimalkan gangguan. Praktik ini akan membantu deployment Anda berjalan lancar saat mendekati tahap production.

Kesimpulan

Poin Penting

Integrasi Capgo dengan GitHub Actions menyederhanakan proses deployment untuk aplikasi Capacitor, memberikan manfaat besar bagi tim developer. Dengan tingkat keberhasilan update global sebesar 82% dan 95% pengguna aktif menerima update dalam 24 jam [1], solusi ini menonjol karena efisiensinya.

Berikut adalah beberapa fitur unggulannya:

• Workflow otomatis: Dengan mengonfigurasi workflow langsung di GitHub Actions, Anda tidak perlu hosting CI/CD eksternal. Pendekatan ini memangkas biaya operasional, menghemat sekitar $26.100 selama lima tahun dibanding alternatif seperti AppFlow [1].
• Deployment cepat: Update bisa langsung dikirim, melewati penundaan app store.
• Keamanan kuat: Enkripsi end-to-end memastikan update terkirim dengan aman, sementara sistem channel Capgo memungkinkan rollout bertahap yang terkontrol.

Fitur-fitur ini membuka jalan bagi solusi yang lebih kustom dan performa yang lebih baik, yang akan dibahas lebih lanjut di bawah.

Strategi lanjutan

Untuk memaksimalkan integrasi Capgo dan GitHub Actions Anda, pelajari taktik tingkat lanjut berikut:

• Workflow API Kustom: Gunakan API publik milik Capgo untuk merancang workflow deployment yang sesuai kebutuhan tim Anda. Ini memungkinkan pengalaman white-label dan integrasi mulus dengan tools Anda saat ini [1].
• Rilis Berbasis Channel: Optimalkan proses deployment Anda dengan fitur channel Capgo untuk update yang bertahap dan terkendali.
• Performa Teroptimasi: Manfaatkan partial updates dari Capgo untuk mengurangi penggunaan bandwidth dan mempercepat update. Dengan 23,5 juta update yang dikirim ke 750 aplikasi produksi [1], sistem ini telah terbukti mampu menangani permintaan skala besar.

Untuk hasil lebih baik, pertimbangkan opsi self-hosting Capgo atau setup API kustom. Cek bagian sebelumnya untuk instruksi setup dan testing detail guna menerapkan strategi ini sepenuhnya.

Lanjut ke Capgo Integration with GitHub Actions: Guide

Jika Anda menggunakan Panduan Integrasi Capgo dengan GitHub Actions untuk merencanakan keamanan dan kepatuhan, hubungkan dengan Enkripsi untuk detail implementasi pada Encryption, Kepatuhan untuk detail implementasi pada Compliance, Capgo Pemindai Keamanan untuk alur kerja produk di Capgo Security Scanner, Keamanan Capgo untuk alur kerja produk di Capgo Security, dan Capgo Pusat Kepercayaan untuk workflow produk di Capgo Trust Center.