CI/CD trên Coolify – Tích hợp GitHub, GitLab, Bitbucket

Để quy trình deploy thật sự tự động, bạn cần kết nối Coolify với Git provider. Push code → tự deploy. Mở PR → có preview URL. Bài này hướng dẫn tích hợp GitHub, GitLab và Bitbucket với Coolify.

I. Các phương pháp kết nối Git

Phương pháp	Auto-deploy	Preview PRs	Private repos	Độ phức tạp
Public Repository	Polling only	❌	❌	Đơn giản nhất
Deploy Key	✅ Webhook	❌	✅	Trung bình
GitHub App	✅ Webhook	✅	✅	Cần setup 1 lần

💡 GitHub App là lựa chọn tốt nhất: hỗ trợ đầy đủ: auto-deploy, preview deployments, private repos, và quản lý quyền chi tiết.

Trang Sources trên Coolify — *Sources — kết nối GitHub App, GitLab hoặc Bitbucket để auto-deploy.*

II. GitHub App Integration (Recommended)

Bước 1: Tạo GitHub App

Trong Coolify, vào Sources → click “+ Add”

Thêm Git source mới trên Coolify — *Thêm GitHub App — tạo kết nối để auto-deploy khi push code.*

Chọn “GitHub App”
Coolify redirect đến GitHub → tạo GitHub App mới
Đặt tên cho app (VD: “Coolify Deploy”)
Chọn repositories muốn cho phép (tất cả hoặc chọn cụ thể)
Click “Create GitHub App”

Bước 2: Install GitHub App

Sau khi tạo, GitHub hỏi install app vào account/organization. Chọn repos muốn Coolify truy cập → Install.

Bước 3: Deploy từ Private Repo

New Resource → “Private Repository (with GitHub App)”
Chọn GitHub App vừa tạo
Coolify hiển thị danh sách repos → chọn repo muốn deploy
Chọn branch → Configure → Deploy

ℹ️ GitHub App tự động cấu hình webhook, mỗi push lên branch được chọn sẽ trigger redeploy. Không cần config thêm gì.

III. Deploy Key Method

Deploy Key dùng SSH key để truy cập private repos. Đơn giản hơn GitHub App nhưng không có preview deployments.

New Resource → “Private Repository (with Deploy Key)”
Coolify tạo SSH key và hiển thị public key
Copy public key → vào GitHub repo → Settings → Deploy Keys → Add
Quay lại Coolify → paste repo URL (SSH format: git@github.com:user/repo.git)
Check repository → chọn branch → Deploy

IV. GitLab & Bitbucket

GitLab

Vào Sources → Add → GitLab
Tạo Personal Access Token trên GitLab (Settings → Access Tokens)
Scope cần: api, read_repository
Paste token vào Coolify → Save
Deploy: chọn GitLab source → chọn repo → deploy

Bitbucket

Sources → Add → Bitbucket
Tạo App Password trên Bitbucket (Settings → App Passwords)
Permissions: Repository read, Webhooks read/write
Paste credentials vào Coolify

Webhooks configuration trên Coolify — *Webhooks — trigger deploy từ bên ngoài hoặc GitHub Actions.*

V. GitHub Actions + Coolify API

Nếu bạn đã có CI/CD pipeline trên GitHub Actions, có thể trigger Coolify deploy qua API:

# .github/workflows/deploy.yml
name: Deploy to Coolify
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Coolify Deploy
        run: |
          curl -X POST \
            "${{ secrets.COOLIFY_URL }}/api/v1/deploy" \
            -H "Authorization: Bearer ${{ secrets.COOLIFY_TOKEN }}" \
            -H "Content-Type: application/json" \
            -d '{"uuid": "${{ secrets.COOLIFY_APP_UUID }}"}'

Tạo API token trong Coolify: Security → API Tokens → Create.

VI. Preview Deployments chi tiết

Preview Deployments tự tạo URL cho mỗi Pull Request, team review trước khi merge:

Yêu cầu: GitHub App integration (Deploy Key không hỗ trợ)
Bật trong resource → tab “Previews”
URL format: pr-123.app.example.com (cần wildcard DNS)
Mỗi PR tạo container riêng → tách biệt hoàn toàn
PR closed/merged → container tự xoá, giải phóng resource

VII. Rollback

Mỗi deployment tạo 1 bản ghi. Nếu version mới lỗi:

Vào resource → tab “Deployments”
Tìm deployment trước (đang chạy OK)
Click “Redeploy” → Coolify rollback về version đó

VIII. Tổng kết

CI/CD trên Coolify không phức tạp, kết nối GitHub App 1 lần, sau đó push code là tự deploy. Preview deployments giúp team review an toàn, rollback 1 click khi lỗi. Bài tiếp: Database trên Coolify, tạo, quản lý và backup.

Tags: