配置 App Runner 服务 - AWS App Runner

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

配置 App Runner 服务

创建 AWS App Runner 服务时,可以设置各种配置值。创建服务后,您可以更改其中的一些配置设置。其他设置只能在创建服务时应用,之后无法更改。本主题讨论如何使用 App Runner API、App Runner 控制台和 App Runner 配置文件配置服务。

使用 App Runner API 配置您的服务或 AWS CLI

API 定义了在创建服务之后可以更改哪些设置。以下列表讨论了相关的操作、类型和限制。

  • UpdateServiceaction-可以在创建后调用以更新某些配置设置。

    • 可以更新-您可以更新SourceConfigurationInstanceConfiguration、和HealthCheckConfiguration参数中的设置。但是,在中SourceConfiguration,您无法将源类型从代码切换到图像或其他方式。您提供的存储库参数必须与创建服务时提供的存储库参数相同。要么是要CodeRepositoryImageRepository

      您还可以更新与该服务关联的单独配置资源的以下 ARN:

      • AutoScalingConfigurationArn

      • VpcConnectorArn

    • 无法更新-您无法更改CreateService操作中可用的ServiceNameEncryptionConfiguration参数。它们在创建后无法更改。该UpdateService操作不包括这些参数。

    • API 与文件 — 您可以将CodeConfiguration类型的ConfigurationSource参数(作为源代码存储库的一部分SourceConfiguration)设置为Repository。在这种情况下,App Runner 会忽略中的配置设置CodeConfigurationValues,并从存储库中的配置文件中读取这些设置。如果设置为 ConfigurationSourceAPI,App Runner 会从 API 调用中获取所有配置设置并忽略配置文件,即使存在配置文件也是如此。

  • TagResourceaction — 可以在创建服务后调用,以向服务添加标签或更新现有标签的值。

  • UntagResourceaction — 可以在创建服务后调用,以从服务中移除标签。

注意

如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。

使用 App Runner 控制台配置您的服务

控制台使用 App Runner API 来应用配置更新。API 施加的更新规则(如上一节所定义)决定了您可以使用控制台配置的内容。创建服务期间可用的某些设置以后无法修改。此外,如果您决定使用配置文件,则其他设置会隐藏在控制台中,App Runner 会从文件中读取这些设置。

配置您的服务
  1. 打开 App Runner 控制台,然后在 “区域” 列表中,选择您的 AWS 区域。

  2. 在导航窗格中,选择服务,然后选择您的 App Runner 服务。

    控制台显示带有服务概述的服务仪表板。

    显示活动列表的 App Runner 服务仪表板页面
  3. 在服务仪表板页面上,选择配置选项卡。

    结果:控制台分几个部分显示服务的当前配置设置:源和部署配置构建配置服务

  4. 要更新任何类别的设置,请选择 “编辑”

  5. 在配置编辑页面上,进行任何所需的更改,然后选择保存更改

注意

如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。

使用 App Runner 配置文件配置您的服务

创建或更新 App Runner 服务时,您可以指示 App Runner 从您作为源存储库一部分提供的配置文件中读取一些配置设置。通过这样做,你可以在源代码控制下管理与源代码相关的设置以及代码本身。配置文件还提供了某些高级设置,您无法使用控制台或 API 进行设置。有关更多信息,请参阅 使用配置文件设置 App Runner 服务选项

注意

如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。