Kết nối tính năng Lưu trữ ứng dụng Firebase với mạng VPC

Phần phụ trợ Firebase App Hosting có thể kết nối với mạng Virtual Private Cloud (VPC). Điều này cho phép phần phụ trợ Firebase App Hosting của bạn truy cập vào các dịch vụ phụ trợ không thể truy cập bằng địa chỉ IP công khai, chẳng hạn như Cloud SQL, Spanner, Cloud Memorystore, Compute Engine hoặc các vi dịch vụ nội bộ của Kubernetes.

Quyền truy cập vào VPC chỉ có trong thời gian chạy (từ vùng chứa Cloud Run), chứ không có trong thời gian tạo (Cloud Build).

Định cấu hình trong apphosting.yaml

Sử dụng ánh xạ vpcAccess trong tệp apphosting.yaml để định cấu hình quyền truy cập. Sử dụng tên mạng đủ điều kiện hoặc mã nhận dạng. Việc sử dụng mã nhận dạng cho phép khả năng di chuyển giữa các môi trường dàn dựng và môi trường phát hành công khai với các trình kết nối/mạng khác nhau.

runConfig:
  vpcAccess:
    egress: PRIVATE_RANGES_ONLY # Default value
    networkInterfaces:
      # Specify at least one of network and/or subnetwork
      - network: my-network-id
        subnetwork: my-subnetwork-id

Ví dụ: kết nối với Memorystore for Redis từ một ứng dụng Next.js

Các hệ thống lưu vào bộ nhớ đệm như Redis hoặc Memcached thường được dùng để tạo một lớp lưu dữ liệu vào bộ nhớ đệm nhanh cho một ứng dụng. Ví dụ này cho bạn biết cách thiết lập Memorystore cho Redis trong cùng một dự án Google Cloud với phần phụ trợ Firebase App Hosting và kết nối với dự án đó bằng Hoạt động truyền dữ liệu trực tiếp ra khỏi VPC.

Bước 0: Tạo một phiên bản Memorystore for Redis

  1. Chuyển đến trang Memorystore cho Redis trong bảng điều khiển Google Cloud.
    • Đảm bảo rằng bạn đã chọn cùng một dự án mà bạn đang dùng cho Firebase App Hosting.
    • Nếu bạn không truy cập được vào trang này, hãy đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án và đã bật Memorystore API.
  2. Chọn Tạo phiên bản.
  3. Định cấu hình phiên bản mới bằng các chế độ cài đặt mà bạn ưu tiên. Dưới đây là một số giá trị mẫu mà bạn có thể sử dụng:
    • Nhập my-redis-cache trong Instance ID (Mã nhận dạng phiên bản).
    • Nhập Redis cache trong mục Tên hiển thị.
    • Chọn Cơ bản trong bộ chọn cấp. Cấp cơ bản chỉ định một nút Redis độc lập, không giống như cấp tiêu chuẩn sử dụng một nút sao chép để sao lưu dữ liệu của bạn.
    • Chọn khu vực của App Hosting phụ trợ trong bộ chọn Khu vực. Hãy nhớ đặt giá trị này sao cho khớp với khu vực của phần phụ trợ.
    • Chọn bất kỳ trong bộ chọn múi giờ.
    • Nhập 5 trong mục Dung lượng. Thao tác này sẽ đặt dung lượng phiên bản của bạn thành 5 GB.
    • Chọn 5.0 trong mục Phiên bản (nên dùng).
    • Chọn mặc định trong bộ chọn Mạng được uỷ quyền.

Bước 1: Cập nhật apphosting.yaml bằng mã nhận dạng mạng VPC

  1. Truy cập vào trang mạng VPC trong bảng điều khiển Google Cloud.
  2. Tìm mã mạng VPC cho phiên bản Memorystore cho Redis (thường là default).

  3. Thiết lập cấu hình lưu lượng truy cập trực tiếp ra khỏi VPC trong apphosting.yaml bằng cách sử dụng mã nhận dạng mạng VPC:

    runConfig:
  vpcAccess:
    egress: PRIVATE_RANGES_ONLY # Default value
  networkInterfaces:
    - network: my-network-id

Bước 2: Thêm các biến môi trường hướng ứng dụng của bạn đến Redis

  1. Tìm thông tin kết nối (máy chủ lưu trữ và cổng) trong thẻ "Connections" (Kết nối) của phiên bản Memorystore for Redis trong bảng điều khiển Google Cloud.

  2. Kết nối với Redis bằng các biến môi trường REDISPORT và REDISHOST. Đặt các giá trị này trong apphosting.yaml bằng cách sử dụng giá trị máy chủ lưu trữ và cổng từ bảng điều khiển Google Cloud:

    env:
  # Sample only. Use actual values provided by Memorystore
  - variable: REDISPORT
    value: 6379
  - variable: REDISHOST
    value: 10.127.16.3

Bước 3: Sử dụng redis từ ứng dụng của bạn

  1. Cài đặt gói npm redis:

    npm install redis@latest

  2. Truy cập vào bộ nhớ đệm redis từ mã của bạn. Sử dụng các biến môi trường được định cấu hình ở bước trước. Ví dụ: dưới đây là cách bạn có thể đọc từ bộ nhớ đệm trong trình xử lý tuyến đường Next.js:

    • src/lib/redis.js

      import { createClient } from "redis";

// Set these environment variables in apphosting.yaml
const REDISHOST = process.env.REDISHOST;
const REDISPORT = process.env.REDISPORT;

let redisClient;

export async function getClient(req, res) {
  // Only connect if a connection isn't already available
  if (!redisClient) {
    redisClient = await createClient(REDISPORT, REDISHOST)
      .on("error", (err) => console.error("Redis Client Error", err))
      .connect();
  }

  return redisClient;
}

    • src/app/counter/route.js

      import { getClient } from "@/lib/redis.js";

export async function GET(request) {
  const redisClient = await getClient();
  const count = await redisClient.get("counter");

  return Response.json({ count });
}

export async function POST(request) {
  const redisClient = await getClient();
  const count = await redisClient.incr("counter");

  return Response.json({ count });
}

Bước 4 (không bắt buộc): Định cấu hình ứng dụng để phát triển cục bộ

Trình mô phỏng Firebase App Hosting có thể ghi đè các giá trị bằng cách dùng apphosting.emulator.yaml. Tại đây, bạn có thể thay đổi giá trị của REDISHOST để trỏ đến localhost, nhờ đó bạn có thể phát triển cục bộ bằng cách sử dụng bản cài đặt Redis cục bộ.

  1. Cài đặt Redis trên máy cục bộ

  2. Tạo hoặc chỉnh sửa apphosting.emulators.yaml để tham chiếu đến phiên bản cục bộ của bạn:

    env:
  - variable: REDISHOST
    value: 127.0.0.1