Giới thiệu

Trước khi bạn xây dựng tích hợp CDEvents, việc thử nghiệm phương pháp của bạn là điều cần thiết. Trong bài viết này, chúng ta sẽ khám phá ba phương pháp giúp bạn hiểu rõ hơn về dòng sự kiện và xác nhận chiến lược của mình trước khi viết mã sản xuất. Những phương pháp này rất hữu ích trong việc mô phỏng để bạn có thể tự tin hơn khi triển khai.

Vấn Đề Kiểm Tra

Bạn đã hiểu tại sao CDEvents lại quan trọng cho khả năng hiển thị quy trình làm việc. Tuy nhiên, bạn đang đối mặt với thách thức tích hợp cổ điển:

• Làm thế nào để tôi biết các sự kiện của mình sẽ hoạt động?
• Tôi nên mong đợi nhận được gì?
• Làm thế nào để tôi kiểm tra mà không cần xây dựng mọi thứ trước?

Việc xây dựng một người tiêu thụ sự kiện mà không hiểu rõ dòng dữ liệu là như việc viết truy vấn SQL mà không xem xét cấu trúc cơ sở dữ liệu. Bạn cần mô phỏng việc nhận sự kiện trước.

Ba Phương Pháp Mô Phỏng Tiêu Thụ CDEvents

Mỗi phương pháp phục vụ cho những nhu cầu và cấp độ kỹ năng khác nhau:

Hãy khám phá từng phương pháp và học khi nào nên sử dụng chúng.

Phương Pháp 1: webhook.site - Kiểm Tra Cấu Trúc Sự Kiện Nhanh

Khi Nào Sử Dụng

Phương pháp này thích hợp để khám phá cấu trúc CDEvents, tạo mẫu nhanh, và học hỏi về các schema sự kiện.

Bước 1: Lấy URL Webhook Độc Nhất Của Bạn

1. Truy cập webhook.site
2. Sao chép URL độc nhất của bạn (trông như https://webhook.site/12345678-abcd-...)
3. Để tab mở để xem các yêu cầu đến

Bước 2: Gửi Một Sự Kiện CDEvent Thử Nghiệm

# Gửi một sự kiện triển khai đến URL webhook.site của bạn
curl -X POST https://webhook.site/YOUR-UNIQUE-ID \
  -H "Content-Type: application/json" \
  -d '{
    "context": {
      "version": "0.4.1",
      "id": "test-123",
      "source": "my-pipeline",
      "type": "dev.cdevents.service.deployed.0.2.0",
      "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"
    },
    "subject": {
      "id": "my-service",
      "type": "service",
      "content": {
        "environment": {"id": "production"},
        "artifactId": "pkg:oci/my-service@v1.2.3"
      }
    }
  }'

Bước 3: Phân Tích Cấu Trúc Sự Kiện

Quay lại webhook.site để xem sự kiện của bạn. Chú ý:

• Headers: Content-Type, tác nhân người dùng, địa chỉ IP
• Body: Cấu trúc CDEvent đầy đủ
• Thời gian: Khi sự kiện được nhận
• Kích thước: Kích thước tải trọng sự kiện

Những Gì Bạn Học Được

✅ Cấu trúc sự kiện: Thấy chính xác CDEvents trông như thế nào
✅ Yêu cầu header: Hiểu các header HTTP cần thiết
✅ JSON schema: Định dạng CDEvent hợp lệ và các trường cần thiết
✅ Lặp lại nhanh: Kiểm tra nhanh các loại sự kiện khác nhau

❌ Không xử lý: Sự kiện chỉ hiển thị, không lưu trữ hay tương quan
❌ Chỉ thủ công: Bạn phải tự gửi sự kiện
❌ Không xác thực: Chỉ đơn giản là HTTP POST

Thực tiễn tốt nhất: Sử dụng webhook.site để hiểu cấu trúc CDEvents trước khi xây dựng logic tiêu thụ của bạn.

Phương Pháp 2: CDviz docker compose - Kiểm Tra Quy Trình Thực Tế

Khi Nào Sử Dụng

Thích hợp để kiểm tra dòng sự kiện hoàn chỉnh, hiểu tích hợp CDviz, và mô phỏng sự kiện thực tế.

Bước 1: Khởi Động Môi Trường Demo CDviz

# Sao chép và khởi động toàn bộ CDviz stack
git clone https://github.com/cdviz-dev/cdviz.git
cd cdviz/demos/stack-compose
docker compose up

Bước 2: Quan Sát Các Sự Kiện Demo Tự Động

Mở localhost:3000 để xem các bảng điều khiển Grafana. Bạn sẽ thấy ngay:

• Triển khai dịch vụ trên các môi trường khác nhau
• Thực thi pipeline với các mẫu thành công/thất bại
• Thăng chức artifact qua staging đến sản xuất
• Biểu đồ thời gian cho thấy sự tương quan giữa các sự kiện

Bước 3: Gửi Các Sự Kiện Của Bạn

CDviz collector chấp nhận các sự kiện tại http://localhost:8080/webhook/000-cdevents:

# Gửi một sự kiện triển khai tùy chỉnh
curl -X POST http://localhost:8080/webhook/000-cdevents \
  -H "Content-Type: application/json" \
  -d '{
    "context": {
      "version": "0.4.1",
      "id": "my-test-deployment",
      "source": "my-testing",
      "type": "dev.cdevents.service.deployed.0.2.0",
      "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"
    },
    "subject": {
      "id": "my-namespace/my-test-service/my-container",
      "type": "service",
      "content": {
        "environment": {"id": "testing"},
        "artifactId": "pkg:oci/my-test-service@v2.1.0"
      }
    }
  }'

Bước 4: Khám Phá Sự Tương Quan Giữa Các Sự Kiện

Duyệt qua các bảng điều khiển Grafana khác nhau để hiểu:

• Thời gian dịch vụ: Cách sự kiện của bạn phù hợp vào quy trình triển khai
• Xem Môi Trường: Tương quan sự kiện giữa các môi trường
• Dòng Hoạt Động: Dòng thời gian sự kiện
• Cơ sở dữ liệu trực tiếp: Truy vấn PostgreSQL trực tiếp để phân tích tùy chỉnh

Những Gì Bạn Học Được

✅ Tích hợp hoàn chỉnh: Toàn bộ quy trình xử lý sự kiện
✅ Phản hồi hình ảnh: Thấy sự kiện trong các bảng điều khiển thực tế
✅ Tương quan sự kiện: Hiểu cách các sự kiện liên quan đến nhau
✅ Mô hình lưu trữ: Sự kiện được lưu trữ trong PostgreSQL để phân tích
✅ Mô phỏng sản xuất: Hành vi xử lý sự kiện thực tế

❌ Tốn tài nguyên: Cần Docker và nhiều container
❌ Thiết lập phức tạp: Nhiều phần chuyển động hơn so với kiểm tra webhook đơn giản

Thực tiễn tốt nhất: Sử dụng CDviz docker compose khi đánh giá CDEvents cho đội ngũ của bạn hoặc kiểm tra các mẫu tích hợp.

Phương Pháp 3: cdviz-collector connect - Được Khuyên Dùng Cho Phát Triển ⭐

Khi Nào Sử Dụng

Thích hợp cho phát triển cục bộ, gỡ lỗi tích hợp, và xác nhận dòng sự kiện.

Bước 1: Cài Đặt cdviz-collector CLI

Tất cả các tùy chọn cài đặt được tài liệu hóa trong Hướng Dẫn Cài Đặt CDviz Collector

brew install cdviz-dev/tap/cdviz-collector

Bước 2: Khởi Động Với Cấu Hình Gỡ Lỗi Cục Bộ

Tạo một cấu hình với webhook làm nguồn (đầu vào) và một sink gỡ lỗi (đầu ra)

# cdviz-collector-debug.toml
[http]
host = "0.0.0.0"
port = 8080

[sinks.debug]
enabled = true
type = "debug"
format = "json"
destination = "stdout"

[sources.cdevents_webhook]
enabled = true

[sources.cdevents_webhook.extractor]
type = "webhook"
id = "000-cdevents"

Bước 3: Khởi Chạy

cdviz-collector connect -v --config ./cdviz-collector-debug.toml

Những Gì Điều Này Thực Hiện

• Khởi động một phiên bản CDviz collector cục bộ
• Hiển thị sự kiện theo thời gian thực khi chúng đến trên stdout
• Xác nhận định dạng CDEvent và từ chối các sự kiện không hợp lệ
• Cung cấp một môi trường phát triển nhẹ nhàng mà không cần Docker

Bước 4: Gửi Các Sự Kiện Của Bạn

# Gửi một sự kiện triển khai tùy chỉnh
curl -X POST http://localhost:8080/webhook/000-cdevents \
  -H "Content-Type: application/json" \
  -d '{
    "context": {
      "version": "0.4.1",
      "id": "my-test-deployment",
      "source": "my-testing",
      "type": "dev.cdevents.service.deployed.0.2.0",
      "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"
    },
    "subject": {
      "id": "my-namespace/my-test-service/my-container",
      "type": "service",
      "content": {
        "environment": {"id": "testing"},
        "artifactId": "pkg:oci/my-test-service@v2.1.0"
      }
    }
  }'

Những Gì Bạn Học Được

✅ Xác nhận CDEvent: Phản hồi ngay lập tức về định dạng và cấu trúc sự kiện
✅ Phát triển nhẹ nhàng: Không cần Docker, khởi động nhanh
✅ Gỡ lỗi theo thời gian thực: Thấy sự kiện khi chúng đến với phản hồi xác nhận
✅ Linh hoạt cấu hình: Dễ dàng thay đổi hành vi qua cấu hình TOML

❌ Chỉ dòng lệnh: Không có giao diện hình ảnh như Grafana
❌ Chỉ cục bộ: Các sự kiện không được lưu trữ hoặc tổng hợp

Thực tiễn tốt nhất: Sử dụng cdviz-collector connect như công cụ phát triển chính của bạn cho tích hợp CDEvents.

Chọn Phương Pháp Kiểm Tra

Khung Quyết Định

Bắt đầu với webhook.site nếu:

• Bạn mới bắt đầu với CDEvents và muốn hiểu cấu trúc sự kiện
• Bạn cần thử nghiệm nhanh với các định dạng sự kiện khác nhau
• Bạn đang tạo mẫu và không cần mô phỏng quy trình toàn bộ

Sử dụng CDviz docker compose nếu:

• Bạn đang đánh giá CDviz cho tổ chức của mình
• Bạn muốn thấy các dòng sự kiện và tương quan thực tế
• Bạn cần kiểm tra các mẫu tích hợp trước khi triển khai sản xuất
• Bạn muốn khám phá bảng điều khiển Grafana và hình ảnh hóa sự kiện

Sử dụng cdviz-collector connect nếu (⭐ Được Khuyên Dùng):

• Bạn đang phát triển tích hợp CDEvents cục bộ
• Bạn muốn phản hồi nhanh về xác nhận sự kiện
• Bạn thích công cụ nhẹ nhàng mà không có overhead Docker
• Bạn cần linh hoạt trong cấu hình cho các kịch bản khác nhau

Chiến Lược Tiến Triển

Lộ trình học tập được khuyến nghị:

1. webhook.site (5 phút) → Hiểu cấu trúc CDEvent
2. cdviz-collector connect (10 phút) → Xác nhận và gỡ lỗi cục bộ ⭐
3. CDviz docker compose (15 phút) → Thấy tích hợp hoàn chỉnh với bảng điều khiển

Đối với hầu hết các nhà phát triển, cdviz-collector connect cung cấp sự cân bằng tốt nhất giữa tính đơn giản và chức năng cho công việc phát triển tiếp theo.

Lộ trình này cung cấp kiến thức lý thuyết, kinh nghiệm thực tiễn, và kỹ năng gỡ lỗi sản xuất.

Bước Tiếp Theo: Từ Người Tiêu Thụ Đến Người Sản Xuất

Giờ đây, khi bạn hiểu cách nhận và kiểm tra CDEvents, bạn đã sẵn sàng để học cách gửi chúng từ các công cụ và quy trình của riêng bạn.

Hãy thử những thí nghiệm này:

1. Chọn một phương pháp mô phỏng ở trên và thử nghiệm
2. Gửi các loại CDEvent khác nhau (service.deployed, taskrun.finished, artifact.published)
3. Lưu ý những gì bạn đã học về cấu trúc và thời gian của sự kiện

Nền tảng này sẽ giúp bạn xây dựng tích hợp CDEvents vững chắc trong hệ thống của riêng bạn.

Những Điều Chính

🎯 Kiểm tra trước: Mô phỏng việc nhận sự kiện trước khi xây dựng người sản xuất
🔧 Nhiều công cụ: Các phương pháp khác nhau phục vụ cho các nhu cầu kiểm tra khác nhau
⭐ Phương pháp được khuyên dùng: cdviz-collector connect cho hầu hết công việc phát triển
📊 Tích hợp hình ảnh: CDviz docker compose cho hình ảnh hóa quy trình hoàn chỉnh
📈 Học tập tiến bộ: Bắt đầu đơn giản (webhook.site) rồi xây dựng kỹ năng thực tiễn

Hiểu cách tiêu thụ CDEvents là điều cần thiết trước khi sản xuất chúng. Những phương pháp mô phỏng này sẽ cung cấp cho bạn nền tảng để xây dựng tích hợp CDEvents vững chắc.

Tài Nguyên

• webhook.site - Kiểm tra webhook ngay lập tức
• CDviz Demo Setup - Toàn bộ docker compose stack
• CDEvents Specification - Tài liệu tham chiếu tiêu chuẩn sự kiện đầy đủ
• CDviz Documentation - Hướng dẫn cài đặt và cấu hình đầy đủ