本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置 App Runner 服务
创建 AWS App Runner 服务时,可以设置各种配置值。创建服务后,您可以更改其中的一些配置设置。其他设置只能在创建服务时应用,之后无法更改。本主题讨论如何使用 App Runner API、App Runner 控制台和 App Runner 配置文件配置服务。
主题
使用 App Runner API 配置您的服务或 AWS CLI
API 定义了在创建服务之后可以更改哪些设置。以下列表讨论了相关的操作、类型和限制。
-
UpdateServiceaction-可以在创建后调用以更新某些配置设置。
-
可以更新-您可以更新
SourceConfiguration
InstanceConfiguration
、和HealthCheckConfiguration
参数中的设置。但是,在中SourceConfiguration
,您无法将源类型从代码切换到图像或其他方式。您提供的存储库参数必须与创建服务时提供的存储库参数相同。要么是要CodeRepository
么ImageRepository
。您还可以更新以下与该服务关联 ARNs 的单独配置资源:
-
AutoScalingConfigurationArn
-
VpcConnectorArn
-
-
无法更新-您无法更改CreateService操作中可用的
ServiceName
和EncryptionConfiguration
参数。它们在创建后无法更改。该UpdateService操作不包括这些参数。 -
API 与文件 — 您可以将CodeConfiguration类型的
ConfigurationSource
参数(作为源代码存储库的一部分SourceConfiguration
)设置为Repository
。在这种情况下,App Runner 会忽略中的配置设置CodeConfigurationValues
,并从存储库中的配置文件中读取这些设置。如果设置为ConfigurationSource
API
,App Runner 会从 API 调用中获取所有配置设置并忽略配置文件,即使存在配置文件也是如此。
-
-
TagResourceaction — 可以在创建服务后调用,以向服务添加标签或更新现有标签的值。
-
UntagResourceaction — 可以在创建服务后调用,以从服务中移除标签。
注意
如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。
使用 App Runner 控制台配置您的服务
控制台使用 App Runner API 来应用配置更新。API 施加的更新规则(如上一节所定义)决定了您可以使用控制台配置的内容。创建服务期间可用的某些设置以后无法修改。此外,如果您决定使用配置文件,则其他设置会隐藏在控制台中,App Runner 会从文件中读取这些设置。
配置您的服务
-
打开 App Runner 控制台
,然后在 “区域” 列表中,选择您的 AWS 区域。 -
在导航窗格中,选择服务,然后选择您的 App Runner 服务。
控制台显示带有服务概述的服务仪表板。
-
在服务仪表板页面上,选择配置选项卡。
结果:控制台分几个部分显示服务的当前配置设置:源和部署、配置构建和配置服务。
-
要更新任何类别的设置,请选择 “编辑”。
-
在配置编辑页面上,进行任何所需的更改,然后选择保存更改。
注意
如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。
使用 App Runner 配置文件配置您的服务
创建或更新 App Runner 服务时,您可以指示 App Runner 从您作为源存储库一部分提供的配置文件中读取一些配置设置。通过这样做,你可以在源代码控制下管理与源代码相关的设置以及代码本身。配置文件还提供了某些高级设置,您无法使用控制台或 API 进行设置。有关更多信息,请参阅 使用配置文件设置 App Runner 服务选项。
注意
如果您为服务创建出站流量 VPC 连接器,则随后的服务启动过程将出现一次性延迟。您可以在创建新服务时或之后通过服务更新为新服务设置此配置。有关更多信息,请参阅一次性延迟本指南的 “与 App Runner 联网” 一章。