Chuyển tới nội dung chính

Cấu hình Trigger

Auto Trigger tự khởi chạy Pipeline khi có sự kiện GitLab, thay vì bạn phải nhấn Run Pipeline mỗi lần. Cấu hình Trigger nằm trong phần cài đặt Pipeline Source, không phải bước riêng. Tutorial này hướng dẫn cấu hình 1 Trigger, sau đó cách quản lý nó.

Điều kiện tiên quyết​

  • Có tài khoản trên FPT Cloud DevOps Platform.
  • Đã tạo và lưu ít nhất 1 Pipeline. Xem Tạo và cấu hình Pipeline.
  • Đã cấu hình GitLab Connection.
  • Có quyền admin trên repository GitLab.
cảnh báo

Auto Trigger hiện chỉ hỗ trợ GitLab. GitHub và Bitbucket sẽ được hỗ trợ sau.

Bật Auto Trigger​

Update Pipeline Source with trigger enabled

  1. Khi đang cấu hình Pipeline, mở card Pipeline Source, hoặc nhấn icon Edit trên phần tóm tắt bước Triggers.
  2. Ở Update Pipeline Source, xác nhận Git account đang kết nối là repository GitLab.
  3. Bật Enable code source trigger(s).

Toggle luôn tắt kèm ghi chú "coming soon" nếu repository đang kết nối là GitHub hoặc Bitbucket. Khi bật, các tuỳ chọn event và branch filter hiện ra ngay trong panel đó.

Chọn loại event​

Cần chọn ít nhất 1 loại event ở mục Enable triggers for. Xem Tài liệu tham khảo Trigger để có bảng đầy đủ.

Pipeline chạy mỗi khi event đã chọn xảy ra — ví dụ Push cho continuous integration, hoặc Tag push cho Pipeline release.

Cấu hình Branch Filter​

Sau khi chọn loại event, chọn cách Trigger áp dụng cho branch ở mục Applied to branches:

  • All branches — mặc định. Mọi branch khớp event đã chọn đều trigger Pipeline.

  • Filtered branches by name — thêm tên branch vào Name included và Name excluded (nhấn Enter sau mỗi tên). Để trống Name included để khớp mọi branch trừ các branch trong Name excluded.

    Filtered branches by name

  • Filtered branches by regex — nhập pattern vào Source Branch Regex và, nếu cần, Target Branch Regex. Xem Tài liệu tham khảo Trigger để có ví dụ pattern.

    Filtered branches by regex

Chỉ 1 tuỳ chọn áp dụng tại 1 thời điểm — chuyển sang tuỳ chọn khác sẽ thay thế filter hiện tại.

mẹo

Các field regex không validate pattern khi gõ. Kiểm tra kỹ cú pháp trước khi lưu.

Đăng ký Webhook trên GitLab​

Webhook url token

Hệ thống tự sinh Webhook URL và Token ngay trong panel — bạn không sửa trực tiếp được.

  1. Copy Webhook URL.
  2. Copy Token.
  3. Mở repository GitLab, vào Settings → Webhooks.
  4. Tạo Webhook mới, dán URL và Token vào.
  5. Chọn các event liên quan.
  6. Nhấn Add Webhook.

GitLab giờ có thể gửi event tới FPT Cloud DevOps Platform, Pipeline tự trigger khi có event khớp.

Quản lý Trigger đã có​

Triggers step summary

Bước Triggers hiển thị tóm tắt cấu hình hiện tại (chỉ xem) — Auto Trigger đang bật hay tắt, kèm lối tắt để đổi. Không có màn quản lý trigger riêng.

Sửa Trigger​

Update Pipeline Source panel opened from the Triggers step

  1. Ở bước Triggers, nhấn icon Edit.
  2. Panel Update Pipeline Source — cùng panel dùng lúc cấu hình ban đầu — mở ra.
  3. Cập nhật loại event, branch filter, hoặc toggle.
  4. Nhấn Save, rồi Save Pipeline.

Tạo lại Token​

  1. Mở Update Pipeline Source qua icon Edit ở bước Triggers.
  2. Nhấn Regenerate token cạnh field Secret token, xác nhận nếu được hỏi.
cảnh báo

Token cũ bị vô hiệu ngay lập tức. Cập nhật Token mới vào Webhook trên GitLab ngay, nếu không Webhook sẽ ngừng hoạt động.

Bước tiếp theo​