Belajar GraphQL - Continuous Integration & Deployment

#Pendahuluan

CI/CD mengubah deployment dari acara menegangkan menjadi rutinitas otomatis. Episode 32 membangun pipeline Continuous Integration dan Continuous Deployment khusus untuk project GraphQL — dengan semua gate yang mencegah kesalahan masuk ke production.

Kita akan menyusun pipeline GitHub Actions, menjalankan automated testing, menerapkan schema checks untuk memblokir breaking change, mengotomasi deployment dengan blue-green dan canary, serta mengelola release dengan semantic versioning.

#CI Pipeline Setup

#GitHub Actions

GitHub Actions menjalankan job pada setiap push atau pull request:

name: CI
on:
  push:
    branches: [main]
  pull_request:
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v2
      - run: bun install --frozen-lockfile
      - run: bun run lint
      - run: bun run typecheck
      - run: bun run test
      - run: bun run build

Alternatif yang setara: GitLab CI dengan .gitlab-ci.yml, CircleCI, atau Jenkins — semuanya mengikuti pola yang sama: checkout, install, lint, test, build.

#Automated Testing dalam CI

Jalankan seluruh piramida testing (episode 21) di CI: unit test, integration test dengan database in-memory, dan E2E test untuk alur kritis. Tambahkan juga coverage threshold agar kualitas tidak menurun diam-diam. Untuk project GraphQL, sertakan pula testing schema.

#Schema Checks

#Memblokir Breaking Change

Perubahan schema yang merusak client adalah bug paling berbahaya — karena tidak akan terdeteksi test aplikasi biasa. Solusinya: schema check di CI:

- name: Check schema changes
  env:
    APOLLO_KEY: ${{ secrets.APOLLO_KEY }}
  run: npx rover graph check kalian@current --schema schema.graphql

rover graph check membandingkan schema cabang dengan schema production dan memblokir perubahan yang breaking. Alternatif: GraphQL Inspector di CI:

- name: Schema diff
  run: |
    npx @graphql-inspector/cli diff \
      schema/current.graphql schema/branch.graphql

Dengan schema check otomatis, setiap PR yang mengubah schema wajib melewati review breaking change — mencegah kejutan bagi client di production.

#Deployment Automation

#Blue-Green dan Canary

Deployment otomatis perlu strategi yang aman:

• Blue-green: dua environment identik; traffic dialihkan dari versi lama (blue) ke baru (green) sekaligus, dengan rollback satu langkah.
• Canary: versi baru menerima sebagian kecil traffic dulu (misalnya 5 persen), lalu ditingkatkan bertahap sambil dipantau.
• Rollback: kemampuan kembali ke versi sebelumnya cepat saat metrik memburuk.

deploy:
  needs: [build, schema-check]
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    - run: bun install --frozen-lockfile
    - run: bun run build
    - name: Deploy ke staging
      run: npx vercel deploy --prebuilt --token ${{ secrets.VERCEL_TOKEN }}

Staging selalu di-deploy otomatis; production memerlukan persetujuan manual atau metrik canary yang hijau.

#Code Quality Gates

#Lint, Type Check, dan Security Scanning

Pipeline CI sebaiknya memblokir kode yang tidak memenuhi standar:

• Linting: ESLint dengan aturan GraphQL.
• Type checking: TypeScript --noEmit.
• Security scanning: dependensi berbahaya dengan tools seperti npm audit dan Snyk.
• Code coverage: threshold minimum untuk fitur baru.

- run: bun run lint
- run: bun run typecheck
- run: npm audit --audit-level=high
- run: bun run test -- --coverage

#Release Management

#Semantic Versioning dan Changelog

Untuk rilis yang rapi, terapkan semantic versioning (major.minor.patch) dan jaga changelog otomatis:

• Breaking change: bump major version.
• Fitur baru: bump minor.
• Perbaikan bug: bump patch.

npx semantic-release

Alat seperti semantic-release membaca conventional commits (episode 46) dan otomatis: menentukan versi, membuat changelog, menandai tag, dan memicu deploy. Ini membuat riwayat rilis konsisten dan dapat diaudit — penting saat user kalian bergantung pada perilaku API.

#Penutup

Inti yang harus dibawa pulang:

• Pipeline CI menjalankan lint, typecheck, test, dan build di setiap perubahan.
• Schema checks dengan Rover atau GraphQL Inspector memblokir breaking change.
• Blue-green dan canary deployment dengan rollback menjaga keselamatan rilis.
• Quality gates mencakup keamanan dependensi dan coverage.
• Semantic versioning dan changelog otomatis membuat rilis konsisten.
• Staging otomatis, production dengan gate, mengurangi risiko.

Di episode 33 selanjutnya kalian akan mempelajari GraphQL Gateway dan API Management — arsitektur gateway, Kong Gateway dengan plugins, AWS AppSync sebagai managed service, Hasura untuk instant GraphQL dari database, dan manajemen API dengan API keys serta developer portal. API kalian siap dikelola skala enterprise!