Ghép nối Cloud Run với Firebase Hosting để tạo và phân phát nội dung động của bạn hoặc xây dựng API REST dưới dạng vi dịch vụ.
Sử dụng Cloud Run , bạn có thể triển khai ứng dụng được đóng gói trong hình ảnh bộ chứa. Sau đó, bằng cách sử dụng Dịch vụ lưu trữ Firebase, bạn có thể chuyển hướng các yêu cầu HTTPS để kích hoạt ứng dụng được chứa trong vùng chứa của mình.
- Cloud Run hỗ trợ một số ngôn ngữ (bao gồm Go, Node.js, Python và Java), cho phép bạn linh hoạt sử dụng ngôn ngữ lập trình và khung tùy chọn.
- Cloud Run tự động chia tỷ lệ theo chiều ngang và hình ảnh vùng chứa của bạn để xử lý các yêu cầu đã nhận, sau đó giảm tỷ lệ khi nhu cầu giảm.
- Bạn chỉ trả tiền cho CPU, bộ nhớ và kết nối mạng đã tiêu thụ trong quá trình xử lý yêu cầu.
Ví dụ: các trường hợp sử dụng và mẫu cho Cloud Run được tích hợp với Lưu trữ Firebase, hãy truy cập tổng quan về serverless của chúng tôi.
Hướng dẫn này chỉ cho bạn cách:
- Viết ứng dụng Hello World đơn giản
- Chứa một ứng dụng và tải nó lên Container Registry
- Triển khai hình ảnh vùng chứa lên Cloud Run
- Yêu cầu lưu trữ trực tiếp tới ứng dụng được đóng gói của bạn
Lưu ý rằng để cải thiện hiệu suất phục vụ nội dung động, bạn có thể tùy ý điều chỉnh cài đặt bộ đệm của mình .
Trước khi bắt đầu
Trước khi sử dụng Cloud Run, bạn cần hoàn thành một số tác vụ ban đầu, bao gồm thiết lập tài khoản Thanh toán qua đám mây, bật API Cloud Run và cài đặt công cụ dòng lệnh gcloud
.
Thiết lập 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 Thanh toán qua đám mây được liên kết với dự án Firebase của mình để sử dụng hoặc dùng thử Cloud Run.
Kích hoạt API và cài đặt SDK
Kích hoạt Cloud Run API trong bảng điều khiển Google API:
Mở trang Cloud Run API trong bảng điều khiển Google API.
Khi được nhắc, hãy chọn dự án Firebase của bạn.
Nhấp vào Bật trên trang Cloud Run API.
Cài đặt và khởi tạo Cloud SDK.
Kiểm tra xem công cụ
gcloud
có được định cấu hình cho đúng dự án không:gcloud config list
Bước 1 : Viết đơn xin việc mẫu
Lưu ý rằng Cloud Run hỗ trợ nhiều ngôn ngữ khác ngoài các ngôn ngữ được hiển thị trong mẫu sau.
Đi
Tạo một thư mục mới có tên
helloworld-go
, sau đó thay đổi thư mục vào đó:mkdir helloworld-go
cd helloworld-go
Tạo một tệp mới có tên
helloworld.go
, sau đó thêm đoạn mã sau:Mã này tạo một máy chủ web cơ bản lắng nghe trên cổng được xác định bởi biến môi trường
PORT
.
Ứng dụng của bạn đã hoàn tất và sẵn sàng để được chứa và tải lên Cơ quan đăng ký vùng chứa.
Node.js
Tạo một thư mục mới có tên
helloworld-nodejs
, sau đó thay đổi thư mục vào đó:mkdir helloworld-nodejs
cd helloworld-nodejs
Tạo tệp
package.json
với nội dung sau:Tạo một tệp mới có tên
index.js
, sau đó thêm đoạn mã sau:Mã này tạo một máy chủ web cơ bản lắng nghe trên cổng được xác định bởi biến môi trường
PORT
.
Ứng dụng của bạn đã hoàn tất và sẵn sàng để được chứa và tải lên Cơ quan đăng ký vùng chứa.
con trăn
Tạo một thư mục mới có tên
helloworld-python
, sau đó thay đổi thư mục vào đó:mkdir helloworld-python
cd helloworld-python
Tạo một tệp mới có tên
app.py
, sau đó thêm đoạn mã sau:Mã này tạo một máy chủ web cơ bản lắng nghe trên cổng được xác định bởi biến môi trường
PORT
.
Ứng dụng của bạn đã hoàn tất và sẵn sàng để được chứa và tải lên Cơ quan đăng ký vùng chứa.
Java
Cài đặt Java SE 8 trở lên JDK và CURL .
Lưu ý rằng chúng ta chỉ cần làm điều này để tạo dự án web mới trong bước tiếp theo. Dockerfile, được mô tả sau, sẽ tải tất cả các phụ thuộc vào vùng chứa.
Từ bảng điều khiển, tạo một dự án web trống mới bằng cách sử dụng cURL sau đó 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
Điều này tạo ra 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@RestController
để xử lý ánh xạ/
và cũng thêm trường@Value
để cung cấp biến môi trườngTARGET
:Mã này tạo một máy chủ web cơ bản lắng nghe trên cổng được xác định bởi biến môi trường
PORT
.
Ứng dụng của bạn đã hoàn tất và sẵn sàng để được chứa và tải lên Cơ quan đăng ký vùng chứa.
Bước 2 : Containerize một ứng dụng và tải nó lên Container Registry
Chứa ứ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.Đi
Node.js
con trăn
Java
Xây dựng hình ảnh bộ chứa của bạn bằng Cloud Build bằng cách chạy lệnh sau từ thư mục chứa Dockerfile của bạn:
gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld
Khi thành công bạn sẽ thấy thông báo SUCCESS chứa tên ảnh
(gcr.io/ PROJECT_ID /helloworld
).
Hình ảnh bộ chứa hiện được lưu trữ trong Cơ quan đăng ký bộ chứa và có thể được sử dụng lại nếu muốn.
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ộ để xây dựng vùng chứa của mình cục bộ .
Bước 3 : Triển khai hình ảnh vùng chứa lê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
) - Trả lời
Y
để cho phép các yêu cầu không được xác thực
- Chọn một khu vực (ví dụ
Đợi 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 dịch vụ. Ví dụ:
https://helloworld- RANDOM_HASH -us-central1.a.run.appTruy cập vùng chứa đã triển khai của bạn bằng cách mở URL dịch vụ trong trình duyệt web.
Bước tiếp theo sẽ hướng dẫn bạn cách truy cập ứng dụng được chứa trong bộ chứa này từ URL Lưu trữ Firebase để ứng dụng có thể tạo nội dung động cho trang web được lưu trữ trên Firebase của bạn.
Bước 4: Yêu cầu lưu trữ trực tiếp đến ứng dụng được đóng gói của bạn
Với quy tắc viết lại , bạn có thể hướng các yêu cầu khớp với các mẫu cụ thể đến một đích duy nhất.
Ví dụ sau đây cho thấy cách điều hướng tất cả các yêu cầu từ trang /helloworld
trên Trang web lưu trữ của bạn để kích hoạt khởi động và chạy phiên bản bộ chứa helloworld
của bạn.
Đảm bảo rằng:
Bạn có phiên bản mới nhất của Firebase CLI .
Bạn đã khởi tạo Dịch vụ lưu trữ Firebase.
Để biết hướng dẫn chi tiết về cách cài đặt CLI và khởi chạy Dịch vụ lưu trữ, hãy xem hướng dẫn Bắt đầu cho Dịch vụ lưu trữ .
Mở tệp
firebase.json
của bạn.Thêm cấu hình
rewrite
sau 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ừ thư mục gốc của thư mục dự án của bạn:
firebase deploy --only hosting
Với tính năng này, bạn có thể đảm bảo rằng bản sửa đổi dịch vụ Cloud Run để tạo nội dung động cho trang web của bạn được đồng bộ hóa với tài nguyên Lưu trữ tĩnh và cấu hình Lưu trữ. Ngoài ra, tính năng này cho phép bạn xem trước các lần viết lại của mình lên Cloud Run trên các kênh xem trước của Dịch vụ lưu trữ.
Nếu bạn thêm
"pingTag": true
vào một khốirun
của cấu hìnhhosting.rewrites
, thì cấu hình và tài nguyên Lưu trữ tĩnh của bạn sẽ được ghim vào bản sửa đổi gần đây nhất của dịch vụ Cloud Run, tại thời điểm triển khai. Nếu bạn khôi phục phiên bản trang web của mình, bản sửa đổi của dịch vụ Cloud Run "được ghim" cũng sẽ được khôi phục.Tính năng này dựa trên thẻ Cloud Run , có giới hạn 1000 thẻ cho mỗi dịch vụ và 2000 thẻ cho mỗi khu vực. Điều này có nghĩa là sau hàng trăm lần triển khai, các phiên bản cũ nhất của trang web có thể ngừng hoạt động.
Vùng chứa của bạn hiện có thể truy cập được qua các URL sau:
Tên miền phụ Firebase của bạn:
PROJECT_ID .web.app/
vàPROJECT_ID .firebaseapp.com/
Mọi miền tùy chỉnh được kết nối :
CUSTOM_DOMAIN /
Truy cập trang cấu hình Hosting để biết thêm chi tiết về quy tắc viết lại . Bạn cũng có thể tìm hiểu về thứ tự ưu tiên phản hồi đối với các cấu hình Dịch vụ lưu trữ khác nhau.
Kiểm tra tại địa phương
Trong quá trình phát triển, bạn có thể chạy và kiểm tra cục bộ hình ảnh bộ chứa của mình. Để biết hướng dẫn chi tiết, hãy truy cập tài liệu Cloud Run .
Bước tiếp theo
Thiết lập bộ nhớ đệm cho nội dung động của bạn trên CDN toàn cầu.
Tương tác với các dịch vụ Firebase khác bằng SDK quản trị Firebase .
Tìm hiểu thêm về Cloud Run, bao gồm hướng dẫn cách thực hiện chi tiết để thiết lập, quản lý và định cấu hình vùng chứa.
Xem lại giá cũng như hạn ngạch và giới hạn cho Cloud Run.