快速入门：将 Shell 服务部署到 Cloud Run

将 Shell 服务部署到 Cloud Run

了解如何创建简单的 Hello World 应用，将该应用打包到容器映像中，然后将该容器映像上传到 Artifact Registry 并部署到 Cloud Run。除了所示语言之外，您还可以使用其他语言。

准备工作

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Note: If you installed the gcloud CLI previously, make sure you have the latest version by running

gcloud components
      update

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Note: If you installed the gcloud CLI previously, make sure you have the latest version by running

gcloud components
      update

要为 Cloud Run 服务设置默认项目，请使用以下命令：
```
 gcloud config set project PROJECT_ID
```
将 PROJECT_ID 替换为您为此快速入门创建的项目的名称。

如果您通过网域限制组织政策来限制项目的未经身份验证的调用，则您需要按照测试专用服务中的说明访问已部署的服务。

编写示例应用

如需编写 Shell 应用，请执行以下操作：

创建名为 helloworld-shell 的新目录，并转到此目录中：
```
mkdir helloworld-shell
cd helloworld-shell
```
初始化 go.mod 文件以声明 go 模块：

helloworld-shell/go.mod

在 GitHub 上查看
```
module github.com/GoogleCloudPlatform/cloud-run-samples/helloworld-shell

go 1.19
```
您可以按上述格式直接创建 go.mod 文件，也可以使用以下命令从项目目录初始化此文件：
```
go mod init
```
创建一个包含以下内容的 script.sh 文件：

helloworld-shell/script.sh

在 GitHub 上查看反馈
```
set -e
echo "Hello ${NAME:-World}!"
```
为了对每个传入请求执行此 shell 脚本，本示例使用一个小型 Go 程序，该程序会启动一个基本 Web 服务器并侦听 PORT 环境变量定义的端口。

创建一个包含以下内容的 invoke.go 文件：

helloworld-shell/invoke.go

在 GitHub 上查看反馈


// Sample helloworld-shell is a Cloud Run shell-script-as-a-service.
package main

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

func main() {
	http.HandleFunc("/", scriptHandler)

	// Determine port for HTTP service.
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
		log.Printf("Defaulting to port %s", port)
	}

	// Start HTTP server.
	log.Printf("Listening on port %s", port)
	if err := http.ListenAndServe(":"+port, nil); err != nil {
		log.Fatal(err)
	}
}

func scriptHandler(w http.ResponseWriter, r *http.Request) {
	cmd := exec.CommandContext(r.Context(), "/bin/bash", "script.sh")
	cmd.Stderr = os.Stderr
	out, err := cmd.Output()
	if err != nil {
		w.WriteHeader(500)
	}
	w.Write(out)
}

在源文件所在的目录中创建一个名为 Dockerfile 的新文件：

helloworld-shell/Dockerfile

在 GitHub 上查看反馈


# Use the offical golang image to create a binary.
# This is based on Debian and sets the GOPATH to /go.
# https://hub.docker.com/_/golang
FROM golang:1.20-buster as builder

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

# Retrieve application dependencies.
# This allows the container build to reuse cached dependencies.
# Expecting to copy go.mod and if present go.sum.
COPY go.* ./
RUN go mod download

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

# Build the binary.
RUN go build -mod=readonly -v -o server

# Use the official Debian slim image for a lean production container.
# https://hub.docker.com/_/debian
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM debian:buster-slim
RUN set -x && apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    --no-install-recommends \
    ca-certificates && \
    rm -rf /var/lib/apt/lists/*

# Create and change to the app directory.
WORKDIR /

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

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

您的应用已编写完毕，可以进行部署。

从来源部署到 Cloud Run

重要提示：本快速入门假定您在快速入门中使用的项目中拥有所有者或编辑者角色。否则，请参阅 Cloud Run 部署权限、Cloud Build 权限和 Artifact Registry 权限，获取需要的权限。

从源代码部署会自动从源代码构建容器映像并进行部署。

如需从源代码部署，请执行以下操作：

在源代码目录中，使用以下命令从源代码进行部署：
```
gcloud run deploy
```
如果系统提示您启用 API，请回复 y 进行启用。
1. 当系统提示您输入源代码位置时，请按 Enter 键部署当前文件夹。
2. 当系统提示您输入服务名称时，请按 Enter 键接受默认名称，例如 helloworld。
3. 如果系统提示您启用 Artifact Registry API 或允许创建 Artifact Registry 代码库，请按 y 进行响应。
4. 当系统提示您输入区域时：请选择您选择的区域，例如 us-central1。
5. 系统会提示您允许未通过身份验证的调用：响应 y。
然后等待部署完成。成功完成时，命令行会显示服务网址。
在 Web 浏览器中打开该服务网址，访问部署的服务。

Cloud Run 位置

Cloud Run 是区域级的，这意味着运行 Cloud Run 服务的基础架构位于特定区域，并且由 Google 代管，以便在该区域内的所有可用区以冗余方式提供。

选择用于运行 Cloud Run 服务的区域时，主要考虑该区域能否满足您的延迟时间、可用性或耐用性要求。通常，您可以选择距离用户最近的区域，但除此之外，您还应该考虑 Cloud Run 服务使用的其他 Google Cloud 产品的位置。跨多个位置使用 Google Cloud 产品可能会影响服务的延迟时间和费用。

Cloud Run 可在以下区域使用：

基于层级 1 价格

asia-east1（台湾）
asia-northeast1（东京）
asia-northeast2（大阪）
europe-north1（芬兰）二氧化碳排放量低
europe-southwest1（马德里）
europe-west1（比利时）二氧化碳排放量低
europe-west4（荷兰）
europe-west8（米兰）
europe-west9（巴黎）二氧化碳排放量低
me-west1（特拉维夫）
us-central1（爱荷华）二氧化碳排放量低
us-east1（南卡罗来纳）
us-east4（北弗吉尼亚）
us-east5（哥伦布）
us-south1（达拉斯）
us-west1（俄勒冈）二氧化碳排放量低

基于层级 2 价格

asia-east2（香港）
asia-northeast3（韩国首尔）
asia-southeast1（新加坡）
asia-southeast2 （雅加达）
asia-south1（印度孟买）
asia-south2（印度德里）
australia-southeast1（悉尼）
australia-southeast2（墨尔本）
europe-central2（波兰，华沙）
europe-west10（柏林）
europe-west12（都灵）
europe-west2（英国伦敦）二氧化碳排放量低
europe-west3（德国法兰克福）二氧化碳排放量低
europe-west6（瑞士苏黎世）二氧化碳排放量低
me-central1（多哈）
me-central2（达曼）
northamerica-northeast1（蒙特利尔）二氧化碳排放量低
northamerica-northeast2（多伦多）二氧化碳排放量低
southamerica-east1（巴西圣保罗）二氧化碳排放量低
southamerica-west1（智利圣地亚哥）二氧化碳排放量低
us-west2（洛杉矶）
us-west3（盐湖城）
us-west4（拉斯维加斯）

如果您已创建 Cloud Run 服务，则可以在 Google Cloud 控制台中的 Cloud Run 信息中心内查看区域。

恭喜！您刚刚将源代码从容器映像部署到了 Cloud Run。Cloud Run 会在需要处理收到的请求时自动横向扩容您的容器映像，并在需要处理的请求数量减少时自动横向缩容您的容器映像。您只需为在处理请求期间消耗的 CPU、内存和网络付费。

清理

移除测试项目

虽然 Cloud Run 不会对未在使用中的服务计费，但您可能仍然需要支付将容器映像存储在 Artifact Registry 中而产生的相关费用。为避免产生费用，您可以删除容器映像或删除 Google Cloud 项目。删除 Google Cloud 项目后，系统会停止对该项目中使用的所有资源计费。

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

后续步骤

如需详细了解如何使用代码源构建容器并推送到代码库，请参阅：