Ghép nối Cloud Run với Firebase Hosting để tạo và phân phát nội dung động hoặc xây dựng API REST dưới dạng các dịch vụ vi mô.
Khi sử dụng Cloud Run, bạn có thể triển khai một ứng dụng được đóng gói trong một hình ảnh vùng chứa. Sau đó, bằng cách sử dụng Firebase Hosting, bạn có thể chuyển các yêu cầu HTTPS để kích hoạt ứng dụng được chứa trong vùng chứa.
- Cloud Run hỗ trợ nhiều ngôn ngữ (bao gồm Go, Node.js, Python và Java), giúp bạn linh hoạt sử dụng ngôn ngữ lập trình và khung mà bạn chọn.
- Cloud Run tự động và mở rộng theo chiều ngang hình ảnh vùng chứa để xử lý các yêu cầu nhận được, sau đó giảm quy mô khi nhu cầu giảm.
- Bạn chỉ trả tiền cho CPU, bộ nhớ và mạng được sử dụng trong quá trình xử lý yêu cầu.
Để xem các trường hợp sử dụng và mẫu ví dụ cho Cloud Run được tích hợp với Firebase Hosting, hãy truy cập vào bài tổng quan về mô hình không máy chủ của chúng tôi.
Hướng dẫn này sẽ cho bạn biết cách:
- Viết một ứng dụng Hello World đơn giản
- Đóng gói ứng dụng vào vùng chứa và tải ứng dụng đó lên Artifact Registry
- Triển khai hình ảnh vùng chứa đến Cloud Run
- Chuyển các yêu cầu Hosting đến ứng dụng nằm trong vùng chứa của bạn
Xin lưu ý rằng để cải thiện hiệu suất phân phát nội dung động, bạn có thể điều chỉnh chế độ cài đặt bộ nhớ đệm (không bắt buộc).
Trước khi bắt đầu
Trước khi sử dụng Cloud Run, bạn cần hoàn tất một số việc ban đầu, bao gồm cả việc thiết lập tài khoản Cloud Billing, bật API Cloud Run và cài đặt công cụ dòng lệnh gcloud
.
Thiết lập thông tin thanh toán cho dự án của bạn
Cloud Run cung cấp hạn mức sử dụng miễn phí, nhưng bạn vẫn phải có tài khoản Cloud Billing được liên kết với dự án Firebase để sử dụng hoặc dùng thử Cloud Run.
Bật API và cài đặt SDK
Bật API Cloud Run trong Bảng điều khiển API Google:
Mở trang Cloud Run API trong Google API Console.
Khi được nhắc, hãy chọn dự án Firebase của bạn.
Nhấp vào Bật trên trang API Cloud Run.
Cài đặt và khởi chạy Cloud SDK.
Kiểm tra để đảm bảo công cụ
gcloud
được định cấu hình cho đúng dự án:gcloud config list
Bước 1: Viết ứng dụng mẫu
Xin lưu ý rằng Cloud Run hỗ trợ nhiều ngôn ngữ khác ngoài những ngôn ngữ xuất hiện trong mẫu sau.
Tìm
Tạo một thư mục mới có tên là
helloworld-go
, sau đó thay đổi thư mục thành thư mục này:mkdir helloworld-go
cd helloworld-go
Tạo một tệp mới có tên là
helloworld.go
, sau đó thêm mã sau:Đoạn mã này tạo một máy chủ web cơ bản, lắng nghe trên cổng do biến môi trường
PORT
xác định.
Ứng dụng của bạn đã hoàn tất và sẵn sàng được đóng gói vào vùng chứa và tải lên Artifact Registry.
Node.js
Tạo một thư mục mới có tên
helloworld-nodejs
, sau đó thay đổi thư mục thành thư mục đó:mkdir helloworld-nodejs
cd helloworld-nodejs
Tạo tệp
package.json
có các nội dung sau:Tạo một tệp mới có tên là
index.js
, sau đó thêm mã sau:Đoạn mã này tạo một máy chủ web cơ bản, lắng nghe trên cổng do biến môi trường
PORT
xác định.
Ứng dụng của bạn đã hoàn tất và sẵn sàng được đóng gói vào vùng chứa và tải lên Artifact Registry.
Python
Tạo một thư mục mới có tên
helloworld-python
, sau đó thay đổi thư mục thành thư mục đó:mkdir helloworld-python
cd helloworld-python
Tạo một tệp mới có tên là
app.py
, sau đó thêm mã sau:Đoạn mã này tạo một máy chủ web cơ bản, lắng nghe trên cổng do biến môi trường
PORT
xác định.
Ứng dụng của bạn đã hoàn tất và sẵn sàng được đóng gói vào vùng chứa và tải lên Artifact Registry.
Java
Cài đặt JDK Java SE 8 trở lên và CURL.
Xin lưu ý rằng chúng ta chỉ cần làm việc này để tạo dự án web mới ở bước tiếp theo. Dockerfile (được mô tả sau) sẽ tải tất cả các phần phụ thuộc vào vùng chứa.
Trên bảng điều khiển, hãy tạo một dự án web trống mới bằng cách sử dụng cURL rồi giải nén các lệnh:
curl https://start.spring.io/starter.zip \ -d dependencies=web \ -d name=helloworld \ -d artifactId=helloworld \ -o helloworld.zip
unzip helloworld.zip
Thao tác này sẽ tạo một dự án SpringBoot.
Cập nhật lớp
SpringBootApplication
trongsrc/main/java/com/example/helloworld/HelloworldApplication.java
bằng cách thêm một@RestController
để xử lý mối liên kết/
, đồng thời thêm một trường@Value
để cung cấp biến môi trườngTARGET
:Đoạn mã này tạo một máy chủ web cơ bản, lắng nghe trên cổng do biến môi trường
PORT
xác định.
Ứng dụng của bạn đã hoàn tất và sẵn sàng được đóng gói vào vùng chứa và tải lên Artifact Registry.
Bước 2: Đóng gói ứng dụng vào vùng chứa và tải ứng dụng đó lên Artifact Registry
Tạo vùng chứa cho ứng dụng mẫu bằng cách tạo một tệp mới có tên
Dockerfile
trong cùng thư mục với các tệp nguồn. Sao chép nội dung sau vào tệp của bạn.Tìm
Node.js
Python
Java
Tạo hình ảnh vùng chứa bằng cách sử dụng Cloud Build bằng cách chạy lệnh sau từ thư mục chứa Dockerfile:
gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld
Khi thành công, bạn sẽ thấy thông báo THÀNH CÔNG có chứa tên hình ảnh
(gcr.io/PROJECT_ID/helloworld
).
Giờ đây, hình ảnh vùng chứa được lưu trữ trong Artifact Registry và có thể được dùng lại nếu muốn.
Xin lưu ý rằng thay vì Cloud Build, bạn có thể sử dụng phiên bản Docker được cài đặt cục bộ để tạo vùng chứa cục bộ.
Bước 3: Triển khai hình ảnh vùng chứa đến Cloud Run
Triển khai bằng lệnh sau:
gcloud run deploy --image gcr.io/PROJECT_ID/helloworld
Khi được nhắc:
- Chọn một khu vực (ví dụ:
us-central1
) - Xác nhận tên dịch vụ (ví dụ:
helloworld
) - Phản hồi
Y
để cho phép các lệnh gọi chưa được xác thực
- Chọn một khu vực (ví dụ:
Chờ một lát để quá trình triển khai hoàn tất. Khi thành công, dòng lệnh sẽ hiển thị URL của dịch vụ. Ví dụ:
https://helloworld-RANDOM_HASH-us-central1.a.run.app Truy cập vào vùng chứa đã triển khai bằng cách mở URL dịch vụ trong một trình duyệt web.
Bước tiếp theo sẽ hướng dẫn bạn cách truy cập vào ứng dụng được chứa trong vùng chứa này từ một Firebase HostingURL để ứng dụng có thể tạo nội dung động cho trang web được lưu trữ trên Firebase.
Bước 4: Chuyển trực tiếp các yêu cầu lưu trữ đến ứng dụng được đóng gói trong vùng chứa
Với quy tắc viết lại, bạn có thể chuyển các yêu cầu khớp với các mẫu cụ thể đến một đích đến duy nhất.
Ví dụ sau đây cho biết cách chuyển hướng tất cả các yêu cầu từ trang /helloworld
trên trang web Hosting của bạn để kích hoạt quá trình khởi động và chạy phiên bản vùng chứa helloworld
.
Hãy đảm bảo rằng:
Bạn đang dùng phiên bản mới nhất của Firebase CLI.
Bạn đã khởi động Firebase Hosting.
Để biết hướng dẫn chi tiết về cách cài đặt CLI và khởi động Hosting, hãy xem Hướng dẫn bắt đầu sử dụng cho Hosting.
Thêm cấu hình
rewrite
sau đây trong phầnhosting
:"hosting": { // ... // Add the "rewrites" attribute within "hosting" "rewrites": [ { "source": "/helloworld", "run": { "serviceId": "helloworld", // "service name" (from when you deployed the container image) "region": "us-central1", // optional (if omitted, default is us-central1) "pinTag": true // optional (see note below) } } ] }
Triển khai cấu hình lưu trữ cho trang web của bạn bằng cách chạy lệnh sau từ gốc của thư mục dự án:
firebase deploy --only hosting
Giờ đây, bạn có thể truy cập vào vùng chứa của mình thông qua các URL sau:
Các miền phụ Firebase của bạn:
PROJECT_ID.web.app/
vàPROJECT_ID.firebaseapp.com/
Mọi miền tuỳ chỉnh được kết nối:
CUSTOM_DOMAIN/
Truy cập vào trang cấu hình Hosting để biết thêm thông tin chi tiết về các quy tắc viết lại. Bạn cũng có thể tìm hiểu về thứ tự ưu tiên của các phản hồi cho nhiều cấu hình Hosting.
Kiểm thử cục bộ
Trong quá trình phát triển, bạn có thể chạy và kiểm thử hình ảnh vùng chứa cục bộ. Để biết hướng dẫn chi tiết, hãy truy cập vào tài liệu về Cloud Run.
Các bước tiếp theo
Thiết lập tính năng lưu vào bộ nhớ đệm cho nội dung động của bạn trên một CDN toàn cầu.
Tương tác với các dịch vụ khác của Firebase bằng Firebase Admin SDK.
Tìm hiểu thêm về Cloud Run, bao gồm cả các hướng dẫn chi tiết về cách thiết lập, quản lý và định cấu hình vùng chứa.
Xem mức giá cũng như hạn mức và giới hạn đối với Cloud Run.