如果您在构建服务器端渲染的 Angular 或 Next.js 应用，不妨试试我们新一代的 Firebase App Hosting，这是一款适用于现代 Web 框架的全栈解决方案。

此页面由 Cloud Translation API 翻译。

使用 Cloud Run 提供动态内容和托管微服务

将 Cloud Run 与 Firebase Hosting 配对，以生成并提供您的动态内容或构建 REST API 作为微服务。

借助Cloud Run，您可以：部署封装在容器映像中的应用然后，使用 Firebase Hosting，您可以定向 HTTPS 请求以触发您的容器化应用

Cloud Run 支持多种语言（包括 Go、Node.js、Python 和 Java），让您可以灵活地使用编程语言和框架
Cloud Run 自动和水平扩缩用于处理收到的请求，然后在需要处理时需求也会随之降低
您只需为在处理请求期间消耗的 CPU、内存和网络资源付费。

例如，与以下产品集成的 Cloud Run 的使用场景和示例： Firebase Hosting，请访问我们的无服务器概览。

本指南将介绍如何执行以下操作：

编写一个简单的 Hello World 应用
将应用容器化并将其上传到 Container Registry
将容器映像部署到 Cloud Run
将 Hosting 请求定向到您的容器化应用

请注意，为改善提供动态内容时的性能，您可以选择调整缓存设置。

准备工作

在使用 Cloud Run 之前，您需要完成一些初始任务。包括设置 Cloud Billing 账号、启用 Cloud Run API 以及安装 gcloud 命令行工具。

为您的项目设置结算功能

Cloud Run 提供免费用量配额，但仍需设置 Cloud Billing 个账号与您的 Firebase 项目关联，以便使用或试用 Cloud Run。

。

启用 API 并安装 SDK

在 Google API 控制台中启用 Cloud Run API：
1. 打开 Cloud Run API 页面。
2. 出现提示时，选择您的 Firebase 项目。
3. 点击 Cloud Run API 页面上的启用。
安装并初始化 Cloud SDK。
确认 gcloud 工具已配置为关联到正确的项目：
```
gcloud config list
```

第 1 步：编写示例应用

请注意，Cloud Run 支持许多其他语言。

Go

新建一个名为 helloworld-go 的目录，然后切换到此目录：
```
mkdir helloworld-go
```
```
cd helloworld-go
```

新建一个名为 helloworld.go 的文件，然后添加以下代码：

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func handler(w http.ResponseWriter, r *http.Request) {
	log.Print("helloworld: received a request")
	target := os.Getenv("TARGET")
	if target == "" {
		target = "World"
	}
	fmt.Fprintf(w, "Hello %s!\n", target)
}

func main() {
	log.Print("helloworld: starting server...")

	http.HandleFunc("/", handler)

	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}

	log.Printf("helloworld: listening on port %s", port)
	log.Fatal(http.ListenAndServe(fmt.Sprintf(":%s", port), nil))
}
helloworld.go

这些代码会创建一个基本 Web 服务器，监听由 PORT 环境变量定义的端口。

您的应用已编写完毕，可以进行容器化并上传到 Container Registry。

Node.js

新建一个名为 helloworld-nodejs 的目录，然后切换到此目录：
```
mkdir helloworld-nodejs
```
```
cd helloworld-nodejs
```

创建一个包含以下内容的 package.json 文件：

{
  "name": "knative-serving-helloworld",
  "version": "1.0.0",
  "description": "Simple hello world sample in Node",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "express": "^4.19.2"
  }
}
package.json

新建一个名为 index.js 的文件，然后添加以下代码：

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  console.log('Hello world received a request.');

  const target = process.env.TARGET || 'World';
  res.send(`Hello ${target}!\n`);
});

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log('Hello world listening on port', port);
});
index.js

这些代码会创建一个基本 Web 服务器，监听由 PORT 环境变量定义的端口。

您的应用已编写完毕，可以进行容器化并上传到 Container Registry。

Python

新建一个名为 helloworld-python 的目录，然后切换到此目录：
```
mkdir helloworld-python
```
```
cd helloworld-python
```

新建一个名为 app.py 的文件，然后添加以下代码：

import os

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    target = os.environ.get('TARGET', 'World')
    return 'Hello {}!\n'.format(target)

if __name__ == "__main__":
    app.run(debug=True,host='0.0.0.0',port=int(os.environ.get('PORT', 8080)))
app.py

这些代码会创建一个基本 Web 服务器，监听由 PORT 环境变量定义的端口。

您的应用已编写完毕，可以进行容器化并上传到 Container Registry。

Java

安装 Java SE 8 或更高版本的 JDK 和 CURL。

请注意，我们只需执行此操作，即可在下一步中创建新的 Web 项目。后面介绍的 Dockerfile 会将所有依赖项加载到容器中。

在控制台中，依次使用 cURL 和 unzip 命令，新建一个空 Web 项目：

curl https://start.spring.io/starter.zip \
    -d dependencies=web \
    -d name=helloworld \
    -d artifactId=helloworld \
    -o helloworld.zip

unzip helloworld.zip

这将创建一个 SpringBoot 项目。

更新 src/main/java/com/example/helloworld/HelloworldApplication.java 中的 SpringBootApplication 类，具体做法是添加 @RestController 以处理 / 映射，同时添加 @Value 字段以提供 TARGET 环境变量：

package com.example.helloworld;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class HelloworldApplication {

  @Value("${TARGET:World}")
  String target;

  @RestController
  class HelloworldController {
    @GetMapping("/")
    String hello() {
      return "Hello " + target + "!";
    }
  }

  public static void main(String[] args) {
    SpringApplication.run(HelloworldApplication.class, args);
  }
}
HelloworldApplication.java

这些代码会创建一个基本 Web 服务器，监听由 PORT 环境变量定义的端口。

您的应用已编写完毕，可以进行容器化并上传到 Container Registry。

第 2 步：将应用容器化并上传到 Container Registry

在源文件所在的目录中新建一个名为 Dockerfile 的文件，对示例应用进行容器化。将以下内容复制到您的文件中。

Go

# Use the official Golang image to create a build artifact.
# This is based on Debian and sets the GOPATH to /go.
FROM golang:latest as builder

ARG TARGETOS
ARG TARGETARCH

# Create and change to the app directory.
WORKDIR /app

# Retrieve application dependencies using go modules.
# Allows container builds to reuse downloaded dependencies.
COPY go.* ./
RUN go mod download

# Copy local code to the container image.
COPY . ./

# Build the binary.
# -mod=readonly ensures immutable go.mod and go.sum in container builds.
RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -mod=readonly -v -o server

# Use the official Alpine image for a lean production container.
# https://hub.docker.com/_/alpine
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM alpine:3
RUN apk add --no-cache ca-certificates

# Copy the binary to the production image from the builder stage.
COPY --from=builder /app/server /server

# Run the web service on container startup.
CMD ["/server"]
Dockerfile

Node.js

# Use the official lightweight Node.js 12 image.
# https://hub.docker.com/_/node
FROM node:12-slim

# Create and change to the app directory.
WORKDIR /usr/src/app

# Copy application dependency manifests to the container image.
# A wildcard is used to ensure both package.json AND package-lock.json are copied.
# Copying this separately prevents re-running npm install on every code change.
COPY package*.json ./

# Install production dependencies.
RUN npm install --only=production

# Copy local code to the container image.
COPY . ./

# Run the web service on container startup.
CMD [ "npm", "start" ]
Dockerfile

Python

# Use the official lightweight Python image.
# https://hub.docker.com/_/python
FROM python:3.7-slim

# Allow statements and log messages to immediately appear in the Knative logs
ENV PYTHONUNBUFFERED True

# Copy local code to the container image.
ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./

# Install production dependencies.
RUN pip install Flask gunicorn

# Run the web service on container startup. Here we use the gunicorn
# webserver, with one worker process and 8 threads.
# For environments with multiple CPU cores, increase the number of workers
# to be equal to the cores available.
CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 app:app
Dockerfile

Java

# Use the official maven/Java 8 image to create a build artifact: https://hub.docker.com/_/maven
FROM maven:3.5-jdk-8-alpine as builder

# Copy local code to the container image.
WORKDIR /app
COPY pom.xml .
COPY src ./src

# Build a release artifact.
RUN mvn package -DskipTests

# Use the Official OpenJDK image for a lean production stage of our multi-stage build.
# https://hub.docker.com/_/openjdk
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM openjdk:8-jre-alpine

# Copy the jar to the production image from the builder stage.
COPY --from=builder /app/target/helloworld-*.jar /helloworld.jar

# Run the web service on container startup.
CMD ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/helloworld.jar"]
Dockerfile

运行以下命令，使用 Cloud Build 构建容器映像命令：
```
gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld
```
成功完成后，您将看到一条包含映像名称
(gcr.io/PROJECT_ID/helloworld) 的 SUCCESS 消息。

容器映像现在存储在 Container Registry 中，如果存在以下情况，可以重复使用：。

请注意，您可以使用本地安装的版本，而不是 Cloud Build 使用 Docker 在本地构建容器。

第 3 步：将容器映像部署到 Cloud Run

使用以下命令进行部署：

gcloud run deploy --image gcr.io/PROJECT_ID/helloworld

当系统提示时：
- 选择区域（例如 us-central1）
- 确认服务名称（例如 helloworld）
- 回复 Y 以允许未经身份验证的调用
重要提示：请记住区域和服务名称，以便稍后使用这些值在 firebase.json 重写规则中分别定义 region 和 serviceID。

为获得最佳性能，请使用以下区域将您的 Cloud Run 服务与 Hosting 共置：

us-west1
us-central1
us-east1
europe-west1
asia-east1

以下版本支持从 Hosting 重写 Cloud Run 以下区域：

asia-east1
asia-east2
asia-northeast1
asia-northeast2
asia-northeast3
asia-south1
asia-south2
asia-southeast1
asia-southeast2
australia-southeast1
australia-southeast2
europe-central2
europe-north1
europe-southwest1
europe-west1
europe-west12
europe-west2
europe-west3
europe-west4
europe-west6
europe-west8
europe-west9
me-central1
me-west1
northamerica-northeast1
northamerica-northeast2
southamerica-east1
southamerica-west1
us-central1
us-east1
us-east4
us-east5
us-south1
us-west1
us-west2
us-west3
us-west4
us-west1
us-central1
us-east1
europe-west1
asia-east1

请等待部署完成。成功完成时，命令行会显示服务网址。例如：https://helloworld-RANDOM_HASH-us-central1.a.run.app。
在网络浏览器中打开该服务网址，访问部署的容器。

下一步将向您介绍如何从 Firebase Hosting网址，以便为您的广告资源生成动态内容。 Firebase 托管的网站。

第 4 步：将 Hosting 收到的请求定向到您的容器化应用

通过重写规则，您可以将与特定格式匹配的请求定向到单个目标。

以下示例展示了如何定向来自网页的所有请求 /helloworld 触发Hosting网站的启动和运行您的 helloworld 容器实例。

请确保：
- 您拥有最新版本的 Firebase CLI。
- 您已初始化 Firebase Hosting。
有关安装 CLI 和初始化的详细说明 Hosting，请参阅 Hosting 入门指南。
打开您的 firebase.json 文件。

在 hosting 部分下添加以下 rewrite 配置：

"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)
    }
  } ]
}

在项目的根目录中运行以下命令，将 Hosting 的配置部署到您的网站：
```
firebase deploy --only hosting
```

run 块中的 pinTag 的作用方式

借助此功能，您可以确保 Cloud Run 的修订版本用于生成网站动态内容的服务与您的静态 Hosting 资源和 Hosting 配置。此外，通过此功能您可在 Hosting 预览中预览对 Cloud Run 的重写渠道。

如果您将 "pinTag": true 添加到 hosting.rewrites 的 run 代码块中配置，您的静态 Hosting 资源和配置将固定到 Cloud Run 服务的最新修订版本，时间部署。如果您回滚网站的某个版本，“固定的” Cloud Run 服务也会回滚。

此功能依赖于 Cloud Run 标记、每个服务最多 1,000 个代码，每个区域最多 2,000 个代码。这意味着，在进行数百次部署后，网站最早的一些版本可能会停止运行。

现在，您可以通过以下网址访问容器：

您的 Firebase 子网域：
PROJECT_ID.web.app/ 和 PROJECT_ID.firebaseapp.com/
任何关联的自定义网域：
CUSTOM_DOMAIN/

。

访问 Hosting 配置页面有关重写规则的更多详情。您可以还可以了解响应的优先顺序 Hosting。

在本地测试

开发期间，您可以在本地运行和测试容器映像。对于请访问 Cloud Run 文档。

后续步骤

在遍布全球的 CDN 上为动态内容设置缓存。
使用 Firebase Admin SDK 与其他 Firebase 服务进行交互。
详细了解 Cloud Run，包括详细方法指南设置、管理和配置容器。
查看价格和配额和限制 Cloud Run。