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
- 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.
- Chọn Tạo phiên bản.
- Đị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.
- Nhập
Bước 1: Cập nhật apphosting.yaml
bằng mã nhận dạng mạng VPC
- Truy cập vào trang mạng VPC trong bảng điều khiển Google Cloud.
- Tìm mã mạng VPC cho phiên bản Memorystore cho Redis (thường là
default
). 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
- 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.
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 trongapphosting.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
Cài đặt gói npm redis:
npm install redis@latest
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ộ.
- Cài đặt Redis trên máy cục bộ
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