blog.dopana

Quay lại

Khi xây dựng ứng dụng toàn cầu trên Cloudflare Workers, mã nguồn của bạn chạy tại hơn 300 trung tâm dữ liệu trên toàn cầu, đem lại thời gian phản hồi ở mức mili-giây cho người dùng. Tuy nhiên, cơ sở dữ liệu quan hệ như Google Cloud SQL for PostgreSQL lại thường được đặt cố định tại một khu vực cụ thể (ví dụ: us-central1 ở Iowa hoặc asia-southeast1 ở Singapore).

Sự kết hợp giữa serverless phân tán và cơ sở dữ liệu tập trung thường gặp trở ngại lớn: độ trễ kết nối và giới hạn số lượng kết nối (connection exhaustion). Cloudflare Hyperdrive chính là giải pháp giải quyết vấn đề này.

1. Vấn Đề: Tại Sao Edge Kết Nối Với Database Lại Chậm?#

Trong mô hình kiến trúc web truyền thống, máy chủ ứng dụng (backend) và cơ sở dữ liệu thường nằm chung một trung tâm dữ liệu hoặc chung mạng nội bộ (VPC). Kết nối giữa chúng chỉ mất dưới 1ms.

Nhưng với Edge Workers:

  1. Bắt tay kết nối tốn nhiều vòng mạng (Handshake Overhead): Khi một Worker tại Tokyo cần truy vấn Cloud SQL tại Mỹ, nó phải thực hiện:
    • Phân giải DNS.
    • TCP 3-way handshake (1 RTT).
    • TLS/SSL handshake (1–2 RTT).
    • PostgreSQL authentication handshake (MD5 hoặc SCRAM-SHA-256) (1–2 RTT). Tổng cộng mất từ 6 đến 8 lượt round-trips qua lại qua đại dương. Chỉ riêng việc thiết lập kết nối đã ngốn từ 200ms đến 500ms, trước khi câu lệnh SQL đầu tiên được thực thi!
  2. Serverless Connection Exhaustion: Serverless Workers tự động co giãn theo từng request. Nếu có 5.000 người dùng đồng thời, 5.000 worker instances sẽ mở 5.000 kết nối độc lập tới PostgreSQL, làm cạn kiệt bộ nhớ và vượt ngưỡng max_connections của Cloud SQL.
Có Cloudflare HyperdriveCách truyền thống: Không có Hyperdrive1. TCP Handshake2. TLS Handshake3. Postgres SCRAM AuthTốn 6-8 RTTs ~ 300-500ms4. Gửi truy vấn SQLKết nối nội bộ cực nhanh ~1msTrả về kết quả ngay nếu có CacheDuy trì Connection Pool ấm0 RTT bắt tay kết nốiEdge Worker - TokyoGCP Cloud SQL - us-central1Edge Worker - TokyoHyperdrive Edge EngineGCP Cloud SQL - us-central1

2. Giải Thích Như Lớp 5 (ELI5)#

[!TIP] Ẩn dụ ngân hàng và các chi nhánh chuyển phát nhanh: Hãy tưởng tượng bạn sở hữu một chuỗi cửa hàng tiện lợi tại mọi khu phố trên thế giới (Edge Workers). Nhưng sổ cái ghi chép tài chính gốc của bạn chỉ được cất trong một hầm thép an toàn tại một ngân hàng ở Mỹ (GCP Cloud SQL).

  • Khi chưa có Hyperdrive: Cứ mỗi lần khách hàng bước vào tiệm hỏi: “Sản phẩm này còn hàng không?”, nhân viên ở Tokyo phải bay sang Mỹ, xuất trình đủ giấy tờ tùy thân, ký tên mở cửa hầm thép, mở sổ ra xem, rồi bay ngược về Tokyo trả lời khách. Cực kỳ tốn vé máy bay và mất cả ngày trời!
  • Khi có Hyperdrive: Hyperdrive giống như việc bạn cử một đại diện cấp cao túc trực sẵn ngay bên trong hầm ngân hàng với một đường dây điện thoại nóng bảo mật luôn mở suốt 24/7 (Connection Pooling). Đồng thời, mỗi chi nhánh có thêm một cuốn sổ photo lại những câu trả lời quen thuộc (Query Caching). Khách hỏi giá nước suối? Nhân viên nhìn sổ tại quầy trả lời trong tích tắc. Khách mua hàng ghi nợ mới? Nhân viên bấm máy báo cho đại diện trong hầm cập nhật ngay mà không cần bay đi bay lại!

3. Kiến Trúc Mạng: Public IP vs Private IP (VPC)#

Khi tích hợp Cloudflare Hyperdrive với GCP Cloud SQL, bạn có hai mô hình triển khai chính tùy thuộc vào cấu hình mạng của cơ sở dữ liệu:

Phương án 2: Private IP / VPCPhương án 1: Public IPCloudflare Global NetworkKết nối TLS mã hóa qua PublicInternetCloudflare Tunnel TCPVPC Private IP 10.x.x.xCloudflare WorkerHyperdriveCloud SQL - Public IPAuthorized NetworksGCE Instancecloudflared daemonCloud SQL - Private IP

Phương án 1: Cloud SQL có Public IP#

  • Đặc điểm: Đơn giản nhất để cài đặt.
  • Bảo mật: Bắt buộc bật SSL/TLS trên Cloud SQL và thêm các dải IP Egress của Cloudflare/Hyperdrive vào danh sách mạng được cấp phép (Authorized Networks). Mọi lưu lượng kết nối qua internet đều được mã hóa bằng TLS.

Phương án 2: Cloud SQL dùng Private IP (VPC) qua Cloudflare Tunnel / GCE Proxy#

  • Đặc điểm: Cloud SQL không mở bất kỳ cổng nào ra internet công cộng (chỉ có IP nội bộ như 10.x.x.x).
  • Cách triển khai: Triển khai một máy ảo nhẹ (Google Compute Engine e2-micro hoặc e2-small) bên trong cùng mạng VPC. Trên máy ảo này, cài đặt cloudflared để tạo Cloudflare Tunnel (hoặc chạy Cloud SQL Auth Proxy). Hyperdrive sẽ định tuyến lưu lượng qua Tunnel trực tiếp vào mạng riêng.

4. Hướng Dẫn Từng Bước Cài Đặt#

Bước 1: Chuẩn bị GCP Cloud SQL PostgreSQL#

  1. Đảm bảo phiên bản PostgreSQL (14, 15 hoặc 16) đã sẵn sàng.
  2. Tạo người dùng cơ sở dữ liệu chuyên dụng:
    CREATE USER worker_app WITH PASSWORD 'mat_khau_sieu_bao_mat_o_day';
    GRANT CONNECT ON DATABASE my_production_db TO worker_app;
    GRANT USAGE ON SCHEMA public TO worker_app;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO worker_app;
    sql
  3. Nếu sử dụng Public IP, mở Google Cloud Console > Cloud SQL > Chọn Instance > Connections > Networking:
    • Tích chọn Public IP.
    • Bật Allow only SSL connections (Bắt buộc mã hóa).
    • Thêm dải IP Egress của Hyperdrive vào phần Authorized Networks.

[!NOTE] Bạn có thể xem danh sách dải IP Egress của Cloudflare tại tài liệu chính thức hoặc chỉ định CIDR theo khu vực của Cloudflare.

Bước 2: Tạo cấu hình Hyperdrive bằng Wrangler CLI#

Cài đặt hoặc cập nhật công cụ wrangler lên phiên bản mới nhất, sau đó chạy lệnh khởi tạo cấu hình Hyperdrive:

Terminal
wrangler hyperdrive create gcp-postgres-hyperdrive \
  --connection-string="postgres://worker_app:mat_khau_sieu_bao_mat_o_day@34.123.45.67:5432/my_production_db?sslmode=require"
bash

Khi lệnh thành công, Wrangler sẽ hiển thị thông tin cấu hình cùng với id:

Output
✅ Successfully created Hyperdrive configuration
📋 Details:
  ID: fc7a9b12c3454e6789a0bcdef1234567
  Name: gcp-postgres-hyperdrive
  Host: 34.123.45.67
  Port: 5432
  Database: my_production_db
  User: worker_app
bash

Bước 3: Cấu hình Binding trong wrangler.toml#

Khai báo Hyperdrive binding trong tệp cấu hình của Cloudflare Worker:

wrangler.toml
name = "my-fast-api"
main = "src/index.ts"
compatibility_date = "2026-09-01"
compatibility_flags = ["nodejs_compat"]

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "fc7a9b12c3454e6789a0bcdef1234567"
toml

[!IMPORTANT] Cờ compatibility_flags = ["nodejs_compat"] là bắt buộc để các thư viện PostgreSQL chuẩn của hệ sinh thái Node.js (như pg hoặc postgres.js) chạy mượt mà trên môi trường runtime V8 của Cloudflare Workers.

Bước 4: Viết Mã Nguồn Worker#

Hyperdrive cung cấp thuộc tính env.HYPERDRIVE.connectionString. Chuỗi kết nối này tự động trỏ đến proxy Hyperdrive gần nhất tại trung tâm dữ liệu cục bộ thay vì bắt tay trực tiếp với máy chủ GCP.

Cách 1: Sử dụng node-postgres (pg)#

Cài đặt package:

Terminal
npm install pg
npm install --save-dev @types/pg
bash

Mã nguồn xử lý request:

Cách 2: Sử dụng thư viện postgres.js (Rất nhanh và gọn nhẹ)#

Bước 5: Cấu hình Private IP VPC qua Cloudflare Tunnel (Tùy chọn nâng cao)#

Nếu cơ sở dữ liệu Cloud SQL của bạn nằm hoàn toàn trong mạng riêng (Private IP) mà không có Public IP:

  1. Khởi tạo GCE Instance: Tạo một máy ảo Compute Engine nhỏ (e2-micro) nằm trong cùng Subnet VPC của Cloud SQL.
  2. Cài đặt cloudflared trên GCE:
    curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
    sudo dpkg -i cloudflared.deb
    cloudflared tunnel login
    cloudflared tunnel create gcp-sql-tunnel
    bash
  3. Cấu hình định tuyến TCP: Trong tệp cấu hình config.yml của cloudflared:
    /etc/cloudflared/config.yml
    tunnel: <TUNNEL_UUID>
    credentials-file: /etc/cloudflared/<TUNNEL_UUID>.json
    
    ingress:
      - hostname: db-private.yourdomain.com
        service: tcp://10.128.0.5:5432 # IP nội bộ của Cloud SQL
      - service: http_status:404
    yaml
  4. Khởi chạy Tunnel:
    sudo systemctl enable --now cloudflared
    bash
  5. Khi đó, chuỗi kết nối trong Hyperdrive sẽ trỏ tới hostname an toàn của Cloudflare:
    Terminal
    wrangler hyperdrive create gcp-postgres-hyperdrive \
      --connection-string="postgres://worker_app:mat_khau@db-private.yourdomain.com:5432/my_production_db" \
      --access-client-id="<CLIENT_ID>" \
      --access-client-secret="<CLIENT_SECRET>"
    bash

5. Cơ Chế Query Caching Của Hyperdrive Hoạt Động Như Thế Nào?#

Hyperdrive không chỉ đơn thuần là bộ giữ kết nối (pooler) như PgBouncer; nó còn sở hữu tính năng thông minh về giao thức PostgreSQL:

  • Tự động Cache câu lệnh đọc (SELECT): Hyperdrive nhận biết các câu lệnh truy vấn dữ liệu thuần túy và có thể cache kết quả ngay tại biên mạng Cloudflare.
  • Bảo toàn tính nhất quán (Read-Your-Own-Writes): Nếu Worker bắt đầu một transaction (BEGIN ... COMMIT) hoặc vừa thực thi câu lệnh ghi (INSERT, UPDATE, DELETE), Hyperdrive sẽ tự động chuyển hướng câu truy vấn kế tiếp trực tiếp về cơ sở dữ liệu gốc để đảm bảo dữ liệu không bao giờ bị lỗi thời.
  • Tùy chỉnh thời gian sống (TTL): Bạn có thể cấu hình caching max-age cho Hyperdrive để kiểm soát độ tươi mới của dữ liệu theo nhu cầu kinh doanh.

6. Kết Luận#

Bằng việc kết hợp Cloudflare Hyperdrive với Google Cloud SQL for PostgreSQL, bạn tận dụng được điểm mạnh nhất của cả hai thế giới:

  1. Lớp tính toán siêu tốc ở rìa mạng: Cloudflare Workers phục vụ người dùng khắp thế giới với độ trễ thấp.
  2. Loại bỏ độ trễ bắt tay mạng: Thời gian kết nối tới database giảm từ hàng trăm mili-giây xuống chỉ còn vài mili-giây.
  3. Bảo vệ hệ thống cơ sở dữ liệu: Tránh tình trạng cạn kiệt kết nối (connection exhaustion) và giảm tải CPU cho máy chủ Cloud SQL nhờ khả năng tái sử dụng pool và query caching.

Tài liệu tham khảo#