AWS App Runner 从 2026 年 4 月 30 日起，将不再向新客户开放。如果您想使用 App Runner，请在该日期之前注册。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS App Runner 可用性变更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 配置 App Runner 服务 [创建 AWS App Runner 服务时](manage-create.md)，可以设置各种配置值。创建服务后，您可以更改其中的一些配置设置。其他设置只能在创建服务时应用，之后无法更改。本主题讨论如何使用 App Runner API、App Runner 控制台和 App Runner 配置文件配置服务。 **Topics** + [使用 App Runner API 配置您的服务或 AWS CLI](#manage-configure.api) + [使用 App Runner 控制台配置您的服务](#manage-configure.console) + [使用 App Runner 配置文件配置您的服务](#manage-configure.file) + [为您的服务配置可观测性](manage-configure-observability.md) + [使用可共享资源配置服务设置](manage-configure-resources.md) + [为您的服务配置运行状况检查](manage-configure-healthcheck.md) ## 使用 App Runner API 配置您的服务或 AWS CLI API 定义了在创建服务之后可以更改哪些设置。以下列表讨论了相关的操作、类型和限制。 + [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)action-可以在创建后调用以更新某些配置设置。 + *可以更新*-您可以更新`SourceConfiguration``InstanceConfiguration`、和`HealthCheckConfiguration`参数中的设置。但是，在中`SourceConfiguration`，您无法将源类型从代码切换到图像或其他方式。您提供的存储库参数必须与创建服务时提供的存储库参数相同。要么是要`CodeRepository`么`ImageRepository`。 您还可以更新以下与该服务关联 ARNs 的单独配置资源： + `AutoScalingConfigurationArn` + `VpcConnectorArn` + *无法更新*-您无法更改[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)操作中可用的`ServiceName`和`EncryptionConfiguration`参数。它们在创建后无法更改。该[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)操作不包括这些参数。 + *API 与文件* — 您可以将[CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)类型的`ConfigurationSource`参数（作为源代码存储库的一部分`SourceConfiguration`）设置为`Repository`。在这种情况下，App Runner 会忽略中的配置设置`CodeConfigurationValues`，并从存储库中的[配置文件](config-file.md)中读取这些设置。如果设置为 `ConfigurationSource``API`，App Runner 会从 API 调用中获取所有配置设置并忽略配置文件，即使存在配置文件也是如此。 + [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)action — 可以在创建服务后调用，以向服务添加标签或更新现有标签的值。 + [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)action — 可以在创建服务后调用，以从服务中移除标签。 **注意** 如果您为服务创建出站流量 VPC 连接器，则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息，请参阅[一次性延迟](network-vpc.md#network-vpc.VPC-connector.latency)本指南的 “*与 App Runner 联网*” 一章。 ## 使用 App Runner 控制台配置您的服务 控制台使用 App Runner API 来应用配置更新。API 施加的更新规则（如上一节所定义）决定了您可以使用控制台配置的内容。创建服务期间可用的某些设置以后无法修改。此外，如果您决定使用[配置文件](config-file.md)，则其他设置会隐藏在控制台中，App Runner 会从文件中读取这些设置。 **配置您的服务** 1. 打开 [App Runner 控制台](https://console.aws.amazon.com/apprunner)，然后在 “**区域**” 列表中，选择您的 AWS 区域。 1. 在导航窗格中，选择**服务**，然后选择您的 App Runner 服务。 控制台显示带有服务**概述的服务**仪表板。 ![\[显示活动列表的 App Runner 服务仪表板页面\]](http://docs.aws.amazon.com/zh_cn/apprunner/latest/dg/images/console-dashboard.png) 1. 在服务仪表板页面上，选择**配置**选项卡。 结果：控制台分几个部分显示服务的当前配置设置：**源和部署**、**配置构建**和**配置服务**。 1. 要更新任何类别的设置，请选择 “**编辑”**。 1. 在配置编辑页面上，进行任何所需的更改，然后选择**保存更改**。 **注意** 如果您为服务创建出站流量 VPC 连接器，则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息，请参阅[一次性延迟](network-vpc.md#network-vpc.VPC-connector.latency)本指南的 “*与 App Runner 联网*” 一章。 ## 使用 App Runner 配置文件配置您的服务 创建或更新 App Runner 服务时，您可以指示 App Runner 从您作为源存储库一部分提供的配置文件中读取一些配置设置。通过这样做，你可以在源代码控制下管理与源代码相关的设置以及代码本身。配置文件还提供了某些高级设置，您无法使用控制台或 API 进行设置。有关更多信息，请参阅 [使用配置文件设置 App Runner 服务选项](config-file.md)。 **注意** 如果您为服务创建出站流量 VPC 连接器，则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息，请参阅[一次性延迟](network-vpc.md#network-vpc.VPC-connector.latency)本指南的 “*与 App Runner 联网*” 一章。 # 为您的服务配置可观测性 AWS App Runner 与多项 AWS 服务集成，为您的 App Runner 服务提供广泛的可观察性工具套件。有关更多信息，请参阅 [App Runner 服务的可观察性](monitor.md)。 App Runner 支持启用某些可观察性功能并使用名为的可共享资源来配置其行为。*ObservabilityConfiguration*在创建或更新服务时，您可以提供可观测性配置资源。当你创建新的 App Runner 服务时，App Runner 控制台会为你创建一个服务。提供可观测性配置是可选的。如果您不提供可观测性配置，App Runner 会提供默认的可观测性配置。 您可以跨多个 App Runner 服务共享单个可观察性配置，以确保它们具有相同的可观察性行为。有关更多信息，请参阅 [使用可共享资源配置服务设置](manage-configure-resources.md)。 您可以使用可观测性配置配置配置以下可观测性功能： + *跟踪配置*-用于跟踪您的应用程序所处理的请求和它发出的下游调用的设置。有关跟踪的更多信息，请参阅 [使用 X-Ray 跟踪您的 App Runner 应用程序](monitor-xray.md)。 ## 管理可观测性 使用以下方法之一管理您的 App Runner 服务的可观察性： ------ #### [ App Runner console ] 使用 App Runner 控制台[创建服务](manage-create.md)时，或者[稍后更新其配置](manage-configure.md)时，可以为服务配置可观察性功能。在控制台页面上查找 “**可观察性**配置” 部分。 ![\[显示可观察性选项的 App Runner 控制台配置页面\]](http://docs.aws.amazon.com/zh_cn/apprunner/latest/dg/images/manage-configure-observability.png) ------ #### [ App Runner API or AWS CLI ] 当您调用[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)或 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)App Runner API 操作时，您可以使用`ObservabilityConfiguration`参数对象来启用可观测性功能并为服务指定可观测性配置资源。 使用以下 App Runner API 操作来管理您的可观测性配置资源。 + [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— 创建新的可观测性配置或对现有配置的修订。 + [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— 返回与您的 AWS 账户关联的可观测性配置列表以及摘要信息。 + [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— 返回可观测性配置的完整描述。 + [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— 删除可观察性配置。您可以删除特定的修订版或最新的活动修订版。如果您达到可观测性配置配额，则可能需要删除不必要的可观测性配置。 AWS 账户 ------ # 使用可共享资源配置服务设置 对于某些功能，跨 AWS App Runner 服务共享配置是有意义的。例如，您可能希望一组服务具有相同的 auto Scaling 行为。或者，您可能需要为所有服务设置相同的可观察性设置。App Runner 允许您使用单独的可共享资源来共享设置。您创建一个为某项功能定义一组配置设置的资源，然后将此配置资源的亚马逊资源名称 (ARN) 提供给一个或多个 App Runner 服务。 App Runner 为以下功能实现了可共享的配置资源： + [自动扩缩](manage-autoscaling.md) + [可观察性](manage-configure-observability.md) + [VPC 访问](network-vpc.md) 每项功能的文档页面都提供了有关可用设置和管理程序的信息。 使用单独配置资源的功能具有一些共同的设计特征和注意事项。 + **修订版**-某些配置资源可能有修订版。自动缩放和可观察性是两个使用修订版的配置资源的示例。在这些情况下，每个配置都有一个*名称*和一个数字*修订版*。一个配置的多个版本具有相同的名称和不同的修订号。您可以针对不同的场景使用不同的配置名称。对于每个名称，您可以添加多个修订版，以微调特定场景的设置。 使用名称创建的第一个配置的修订号为 1。具有相同名称的后续配置将获得连续的修订版号（以 2 开头）。您可以将 App Runner 服务与特定的配置版本或最新版本的配置相关联。 + **共享** — 您可以跨多个 App Runner 服务共享单个配置资源。如果您想在这些服务之间保持相同的配置，这很有用。特别是，如果您的资源支持修订版，则可以将多个服务配置为使用最新版本的配置。为此，您可以只指定配置名称，而不指定修订版。更新服务时，您以这种方式配置的任何服务都会收到配置更新。有关配置更改的更多信息，请参阅[配置 App Runner 服务](manage-configure.md)。 + **资源管理**-您可以使用 App Runner 创建和删除配置。您无法直接更新配置。相反，对于支持修订版的资源，您可以为现有配置名称创建新的修订版以有效地更新配置。 **注意** 对于自动缩放，您可以使用 App Runner 控制台和 App Runner API 创建配置和*多个*修订版。App Runner 控制台和 App Runner API 也可以删除配置和修订版。有关更多详细信息，请参阅[管理 App Runner 自动缩放](manage-autoscaling.md)。 对于其他配置类型，例如可观察性配置，您只能使用 App Runner 控制台创建具有*单个*修订版的配置。要创建更多修订版和删除配置，必须使用 App Runner API。 + **资源配**额 — 您可以为每个配置资源设置的唯一配置名称和修订版本数量的配额 AWS 区域。如果达到这些配额，则必须先删除配置名称或至少删除其中的一些修订版，然后才能创建更多版本。对于自动缩放配置修订版，您可以使用 App Runner 控制台或 App Runner API 将其删除。有关更多详细信息，请参阅[管理 App Runner 自动缩放](manage-autoscaling.md)。您必须使用 App Runner API 来删除其他资源。有关限额的更多信息，请参阅[应用程序运行器资源配额](architecture.md#architecture.quotas)。 + **无资源成本** — 创建配置资源不会产生额外费用。您可能会为该功能本身承担费用（例如，在打开 X-Ray 跟踪时，您需要支付正常 AWS X-Ray 费用），但不会为为 App Runner 服务配置该功能的 App Runner 配置资源付费。 # 为您的服务配置运行状况检查 AWS App Runner 通过执行运行状况检查来监控服务的运行状况。默认运行状况检查协议为 TCP。App Runner 会对分配给你的服务的域执行 ping 操作。您也可以将运行状况检查协议设置为 HTTP。App Runner 向你的 Web 应用程序发送运行状况检查 HTTP 请求。 您可以配置一些与运行状况检查相关的设置。下表描述了运行状况检查设置及其默认值。 | **设置** | **描述** | **默认** | | --- | --- | --- | | 协议 | App Runner 用于对您的服务执行运行状况检查的 IP 协议。 如果您将协议设置为`TCP`，则 App Runner 会在应用程序正在监听的端口上对分配给您的服务的默认域执行 ping 操作。 如果您将协议设置为`HTTP`，App Runner 会向配置的路径发送运行状况检查请求。 | `TCP` | | 路径 | App Runner 向其发送 HTTP 运行状况检查请求的网址。仅适用于 HTTP 检查。 | `/` | | Interval | 运行状况检查之间的时间间隔（以秒为单位）。 | `5` | | Timeout | 在确定运行状况检查响应失败之前等待的时间（以秒为单位）。 | `2` | | 健康阈值 | App Runner 确定服务运行状况正常之前必须成功的连续检查次数。 | `1` | | 不健康阈值 | App Runner 确定服务运行状况不正常之前必须失败的连续检查次数。 | `5` | ## 配置运行状况检查 使用以下方法之一为 App Runner 服务配置运行状况检查： ------ #### [ App Runner console ] 使用 App Runner 控制台创建 App Runner 服务时，或者稍后更新其配置时，可以配置运行状况检查设置。有关完整的控制台程序，请参阅[创建 App Runner 服务](manage-create.md)和[配置 App Runner 服务](manage-configure.md)。在这两种情况下，请在控制台页面上**查找 Health check** 配置部分。 ![\[显示运行状况检查选项的 App Runner 控制台配置页面\]](http://docs.aws.amazon.com/zh_cn/apprunner/latest/dg/images/console-health-check.png) ------ #### [ App Runner API or AWS CLI ] 当您调用[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 操作时，您可以使用`HealthCheckConfiguration`参数来指定运行状况检查设置。 有关参数结构的信息，请参阅 *AWS App Runner API 参考[HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)*中的。 ------