AWS App Runner 从 2026 年 4 月 30 日起，将不再向新客户开放。如果您想使用 App Runner，请在该日期之前注册。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS App Runner 可用性变更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Go 平台
**重要**
App Runner 将于 2025 年 12 月 1 日终止对 **Go 1.18** 的支持。有关建议和更多信息，请参阅[终止对托管运行时版本的支持](service-source-code.md#service-source-code.managed-platforms.eos)。
G AWS App Runner o 平台提供托管运行时。每个运行时都可以轻松构建和运行基于 Go 版本的 Web 应用程序的容器。当你使用 Go 运行时时，App Runner 会从托管 Go 运行时镜像开始。此镜像基于 [Amazon Linux Docker 镜像](https://hub.docker.com/_/amazonlinux)，包含某个 Go 版本的运行时包和一些工具。App Runner 使用此托管运行时映像作为基础映像，并添加您的应用程序代码来构建 Docker 映像。然后，它会部署此映像以在容器中运行您的 Web 服务。
在使用 App Runner 控制台或 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API 操作[创建服务](manage-create.md)时，可以为 App Runner 服务指定运行时。您也可以将运行时指定为源代码的一部分。在包含在代码存储库中的 A [pp Runner 配置文件](config-file.md)中使用`runtime`关键字。托管运行时的命名约定是**。
有关有效的 Go 运行时名称和版本，请参阅[Go 运行时版本信息](service-source-code-go-releases.md)。
每次部署或服务更新时，App Runner 都会将服务的运行时更新到最新版本。如果您的应用程序需要托管运行时的特定版本，则可以使用 [App Runner 配置文件](config-file.md)中的`runtime-version`关键字进行指定。您可以锁定到任何级别的版本，包括主要版本或次要版本。App Runner 仅对服务的运行时进行较低级别的更新。
Go 运行时的版本语法：`major[.minor[.patch]]`
例如：`1.18.7`
以下示例演示了版本锁定：
+ `1.18`— 锁定主要版本和次要版本。App Runner 仅更新补丁版本。
+ `1.18.7`— 锁定到特定的补丁版本。App Runner 不会更新你的运行时版本。
**Topics**
+ [Go 运行时配置](#service-source-code-go1.config)
+ [Go 运行时示例](#service-source-code-go1.examples)
+ [Go 运行时版本信息](service-source-code-go-releases.md)
## Go 运行时配置
选择托管运行时时，还必须至少配置生成和运行命令。您可以在[创建](manage-create.md)或[更新](manage-configure.md) App Runner 服务时对其进行配置。您可以使用以下方法之一来执行此操作：
+ **使用 App Runner 控制台**-在创建过程或**配置选项卡的 “配置构**建” 部分中指定命令。
+ **使用 App Runner API**-调用[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)或 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API 操作。使用[CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)数据类型的`BuildCommand`和`StartCommand`成员来指定命令。
+ **使用[配置文件](config-file.md)**-在最多三个构建阶段中指定一个或多个构建命令，并指定一个用于启动应用程序的运行命令。还有其他可选的配置设置。
提供配置文件是可选的。使用控制台或 API 创建 App Runner 服务时，您可以指定 App Runner 是在创建时直接获取配置设置还是从配置文件中获取配置设置。
## Go 运行时示例
以下示例显示了用于构建和运行 Go 服务的 App Runner 配置文件。
### 最小 Go 配置文件
此示例显示了可以与 Go 托管运行时一起使用的最小配置文件。有关 App Runner 使用最小配置文件做出的假设，请参阅[配置文件示例](config-file-examples.md#config-file-examples.managed)。
**Example apprunner.yaml**
```
version: 1.0
runtime: go1
build:
commands:
build:
- go build main.go
run:
command: ./main
```
### 扩展 Go 配置文件
此示例显示了在 Go 托管运行时中使用所有配置密钥的情况。
**注意**
这些示例中使用的运行时版本是*1.18.7*。您可以将其替换为要使用的版本。有关支持的最新 Go 运行时版本，请参阅[Go 运行时版本信息](service-source-code-go-releases.md)。
**Example apprunner.yaml**
```
version: 1.0
runtime: go1
build:
commands:
pre-build:
- scripts/prebuild.sh
build:
- go build main.go
post-build:
- scripts/postbuild.sh
env:
- name: MY_VAR_EXAMPLE
value: "example"
run:
runtime-version: 1.18.7
command: ./main
network:
port: 3000
env: APP_PORT
env:
- name: MY_VAR_EXAMPLE
value: "example"
```
### 完整的 Go 应用程序源码
这些示例显示了可以部署到 Go 运行时服务的完整 Go 应用程序的源代码。
**Example main.go**
```
package main
import (
"fmt"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "Welcome to App Runner
")
})
fmt.Println("Starting the server on :3000...")
http.ListenAndServe(":3000", nil)
}
```
**Example apprunner.yaml**
```
version: 1.0
runtime: go1
build:
commands:
build:
- go build main.go
run:
command: ./main
network:
port: 3000
env: APP_PORT
```