Tự động hóa workflow với Supabase và GitHub Actions

Tự động hóa workflow với Supabase và GitHub Actions

Trong bối cảnh phát triển phần mềm hiện đại, việc tự động hóa các quy trình lặp đi lặp lại không chỉ giúp tiết kiệm thời gian mà còn giảm thiểu lỗi do con người. Khi kết hợp Supabase - một nền tảng backend toàn diện - với GitHub Actions - công cụ CI/CD mạnh mẽ của GitHub, chúng ta có thể xây dựng một pipeline tự động hoàn chỉnh cho ứng dụng của mình.

Supabase và GitHub Actions: Tại sao nên kết hợp?

Supabase cung cấp cơ sở dữ liệu PostgreSQL, authentication, storage, và real-time subscriptions chỉ với vài cú nhấp chuột. Tuy nhiên, trong quá trình phát triển, việc deploy database schema, seeding dữ liệu, hoặc chạy test trên môi trường thực tế thường đòi hỏi thao tác thủ công. Đây chính là lúc GitHub Actions phát huy tác dụng.

GitHub Actions cho phép chúng ta tự động hóa các workflow dựa trên sự kiện trong repository. Khi kết hợp với Supabase, chúng ta có thể tự động chạy test, deploy migration, hoặc thậm chí reset database sau mỗi lần deploy.

Các workflow tự động phổ biến

Một trong những workflow cơ bản nhất là tự động chạy database migration mỗi khi có pull request mới. Thay vì phải thủ công apply schema lên database staging, GitHub Actions có thể lắng nghe sự kiện pull_request và trigger một job để apply migration lên database test của Supabase.

Một workflow khác hữu ích là seeding dữ liệu test. Khi cần kiểm tra tính năng mới, việc có sẵn dataset mẫu sẽ tiết kiệm rất nhiều thời gian. Chúng ta có thể viết một script seeding và để GitHub Actions chạy nó sau mỗi lần deploy thành công.

Ngoài ra, việc tự động reset database về trạng thái sạch trước mỗi lần test integration cũng rất quan trọng. GitHub Actions có thể kết nối đến Supabase, drop toàn bộ schema, rồi apply lại từ đầu, đảm bảo môi trường test luôn nhất quán.

Cấu hình GitHub Actions cho Supabase

Để bắt đầu, chúng ta cần tạo một workflow file trong thư mục .github/workflows/. Ví dụ, tạo file supabase-migrate.yml:

name: Supabase Migration
on:
  pull_request:
    branches: [main]
jobs:
  migrate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Apply migrations
        uses: supabase/setup-cli@v1
        with:
          version: latest
      - name: Run migration
        run: |
          supabase db push
        env:
          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}

Ở đây, chúng ta sử dụng action supabase/setup-cli để cài đặt CLI, sau đó chạy lệnh supabase db push để apply migration. Các secrets SUPABASE_URL và SUPABASE_SERVICE_ROLE_KEY cần được lưu trữ an toàn trong repository settings.

Bảo mật và quản lý secrets

Khi làm việc với database, bảo mật là yếu tố then chốt. GitHub Actions cho phép lưu trữ secrets một cách an toàn và chỉ có thể truy cập trong workflow. Đối với Supabase, chúng ta cần lưu trữ URL project và service role key. Service role key có quyền cao nhất, vì vậy không bao giờ commit nó vào source code.

Ngoài ra, nếu cần kết nối đến nhiều môi trường (development, staging, production), chúng ta có thể tạo các secrets riêng biệt và điều kiện chạy workflow dựa trên branch hoặc tag.

Mẹo và lưu ý khi triển khai

Khi tự động hóa với Supabase, cần lưu ý rằng mỗi workflow chạy trong container riêng biệt. Việc khởi tạo CLI và kết nối đến database có thể mất vài giây. Nếu workflow thất bại do timeout, hãy xem xét tăng giới hạn thời gian trong cấu hình.

Ngoài ra, nên tách biệt database cho từng môi trường. Không nên chạy migration production tự động mà không có review, vì một lỗi nhỏ có thể ảnh hưởng đến toàn bộ hệ thống.

Cuối cùng, luôn kiểm tra log output của workflow. GitHub Actions cung cấp giao diện trực quan để theo dõi từng bước chạy, giúp dễ dàng debug khi có sự cố.

Kết luận

Tự động hóa workflow với Supabase và GitHub Actions không chỉ giúp tối ưu quy trình phát triển mà còn nâng cao chất lượng sản phẩm. Từ việc tự động apply migration, seeding dữ liệu test, đến reset database trước mỗi lần test, tất cả đều có thể được thực hiện một cách nhất quán và an toàn. Điều quan trọng là bắt đầu từ những workflow nhỏ, test kỹ lưỡng, và mở rộng dần theo nhu cầu thực tế của dự án.