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.

📖 Bài trước: Phần 7, Docker Compose

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.

II. GitHub App Integration (Recommended)

Bước 1: Tạo GitHub App

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

1. Chọn “GitHub App”
2. Coolify redirect đến GitHub → tạo GitHub App mới
3. Đặt tên cho app (VD: “Coolify Deploy”)
4. Chọn repositories muốn cho phép (tất cả hoặc chọn cụ thể)
5. 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

1. New Resource → “Private Repository (with GitHub App)”
2. Chọn GitHub App vừa tạo
3. Coolify hiển thị danh sách repos → chọn repo muốn deploy
4. 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.

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

IV. GitLab & Bitbucket

GitLab

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

Bitbucket

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

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:

1. Vào resource → tab “Deployments”
2. Tìm deployment trước (đang chạy OK)
3. 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.