AWS App Runner 从 2026 年 4 月 30 日起，将不再向新客户开放。如果您想使用 App Runner，请在该日期之前注册。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS App Runner 可用性变更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Ruby 平台
<a name="service-source-code-ruby"></a>

**重要**  
App Runner 将于 2025 年 12 月 1 日终止对 **Ruby 3.** 1 的支持。有关建议和更多信息，请参阅[终止对托管运行时版本的支持](service-source-code.md#service-source-code.managed-platforms.eos)。

 AWS App Runner Ruby 平台提供托管运行时。每个运行时都可以轻松地使用基于 Ruby 版本的 Web 应用程序构建和运行容器。当你使用 Ruby 运行时时，App Runner 会从托管的 Ruby 运行时镜像开始。此镜像基于 [Amazon Linux Docker 镜像](https://hub.docker.com/_/amazonlinux)，包含某个 Ruby 版本的运行时包和一些工具。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`关键字。托管运行时的命名约定是*<language-name><major-version>*。

有关有效的 Ruby 运行时名称和版本，请参见[Ruby 运行时发布信息](service-source-code-ruby-releases.md)。

每次部署或服务更新时，App Runner 都会将服务的运行时更新到最新版本。如果您的应用程序需要托管运行时的特定版本，则可以使用 [App Runner 配置文件](config-file.md)中的`runtime-version`关键字进行指定。您可以锁定到任何级别的版本，包括主要版本或次要版本。App Runner 仅对服务的运行时进行较低级别的更新。

Ruby 运行时的版本语法：`major[.minor[.patch]]`

例如：`3.1.2`

以下示例演示了版本锁定：
+ `3.1`— 锁定主要版本和次要版本。App Runner 仅更新补丁版本。
+ `3.1.2`— 锁定到特定的补丁版本。App Runner 不会更新你的运行时版本。

**Topics**
+ [Ruby 运行时配置](#service-source-code-ruby.config)
+ [Ruby 运行时示例](#service-source-code-ruby.examples)
+ [Ruby 运行时发布信息](service-source-code-ruby-releases.md)

## Ruby 运行时配置
<a name="service-source-code-ruby.config"></a>

选择托管运行时时，还必须至少配置生成和运行命令。您可以在[创建](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 是在创建时直接获取配置设置还是从配置文件中获取配置设置。

## Ruby 运行时示例
<a name="service-source-code-ruby.examples"></a>

以下示例显示了用于构建和运行 Ruby 服务的 App Runner 配置文件。

### 最小 Ruby 配置文件
<a name="service-source-code-ruby.examples.minimal"></a>

此示例显示了一个可以与 Ruby 托管运行时配合使用的最小配置文件。有关 App Runner 使用最小配置文件做出的假设，请参阅[配置文件示例](config-file-examples.md#config-file-examples.managed)。

**Example apprunner.yaml**  

```
version: 1.0
runtime: ruby31
build:
  commands:
    build:
      - bundle install
run:
  command: bundle exec rackup --host 0.0.0.0 -p 8080
```

### 扩展的 Ruby 配置文件
<a name="service-source-code-ruby.examples.extended"></a>

此示例显示了在 Ruby 托管运行时中使用所有配置密钥的情况。

**注意**  
这些示例中使用的运行时版本是*3.1.2*。您可以将其替换为要使用的版本。有关支持的最新的 Ruby 运行时版本，请参阅[Ruby 运行时发布信息](service-source-code-ruby-releases.md)。

**Example apprunner.yaml**  

```
version: 1.0
runtime: ruby31
build:
  commands:
     pre-build:
      - scripts/prebuild.sh
    build:
      - bundle install
    post-build:
      - scripts/postbuild.sh
  env:
    - name: MY_VAR_EXAMPLE
      value: "example"
run:
  runtime-version: 3.1.2
  command: bundle exec rackup --host 0.0.0.0 -p 4567
  network:
    port: 4567
    env: APP_PORT
  env:
    - name: MY_VAR_EXAMPLE
      value: "example"
```

### 完整的 Ruby 应用程序源码
<a name="service-source-code-ruby.examples.end2end"></a>

这些示例显示了可以部署到 Ruby 运行时服务的完整 Ruby 应用程序的源代码。

**Example server.rb**  

```
# server.rb
require 'sinatra'

get '/' do    
  'Hello World!'
end
```

**Example config.ru**  

```
# config.ru

require './server'

run Sinatra::Application
```

**Example Gemfile**  

```
# Gemfile
source 'https://rubygems.org (https://rubygems.org/)'

gem 'sinatra'
gem 'puma'
```

**Example apprunner.yaml**  

```
version: 1.0
runtime: ruby31
build:
  commands:
    build:
      - bundle install
run:
  command: bundle exec rackup --host 0.0.0.0 -p 4567
  network:
    port: 4567
    env: APP_PORT
```

# Ruby 运行时发布信息
<a name="service-source-code-ruby-releases"></a>

**重要**  
App Runner 将于 2025 年 12 月 1 日终止对 **Ruby 3.** 1 的支持。有关建议和更多信息，请参阅[终止对托管运行时版本的支持](service-source-code.md#service-source-code.managed-platforms.eos)。

本主题列出了 App Runner 支持的 Ruby 运行时版本的完整详细信息。


**支持的运行时版本-原始 App Runner 版本**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/apprunner/latest/dg/service-source-code-ruby-releases.html)

**注意**  
App Runner 为最近发布的特定主要运行时提供了修订后的构建流程。因此，您将在本文档的某些部分中看到对*修订后的 App Runner 版本**和原始 App Runner 版本*的引用。有关更多信息，请参阅[托管运行时版本和 App Runner 版本](service-source-code.md#service-source-code.build-detail)。