Configuring an App Runner service
When you create an AWS App Runner service, you set various configuration values. You can change some of these configuration settings after you create the service. Other settings can be applied only while creating the service and cannot be changed thereafter. This topic discusses the configuration of your service using the App Runner API, the App Runner console, and an App Runner configuration file.
Topics
- Configure your service using the App Runner API or AWS CLI
- Configure your service using the App Runner console
- Configure your service using an App Runner configuration file
- Configuring observability for your service
- Configuring service settings using sharable resources
- Configuring health checks for your service
Configure your service using the App Runner API or AWS CLI
The API defines which settings can be changed after service creation. The following list discusses the relevant actions, types, and limitations.
-
UpdateService action – Can be called after creation to update some configuration settings.
-
Can be updated – You can update settings in the
SourceConfiguration
,InstanceConfiguration
, andHealthCheckConfiguration
parameters. However, inSourceConfiguration
, you can't switch your source type from code to image or the other way around. You must provide the same repositoryparameter as you provided when you created the service. It's eitherCodeRepository
orImageRepository
.You can also update the following ARNs of separate configuration resources associated with the service:
-
AutoScalingConfigurationArn
-
VpcConnectorArn
-
-
Cannot be updated – You can't change the
ServiceName
andEncryptionConfiguration
parameters that are available in the CreateService action. They can't be changed after they're created. The UpdateService action doesn't include these parameters. -
API vs. file – You can set the
ConfigurationSource
parameter of the CodeConfiguration type (used for source code repositories as part ofSourceConfiguration
) toRepository
. In this case, App Runner ignores the configuration settings inCodeConfigurationValues
, and reads these settings from a configuration file in your repository. If you setConfigurationSource
toAPI
, App Runner gets all configuration settings from the API call and ignores the configuration file, even if one exists.
-
-
TagResource action – Can be called after your service is created to add tags to the service or update values of existing tags.
-
UntagResource action – Can be called after your service is created to remove tags from the service.
Note
If you create an outbound traffic VPC connector for a service, the service startup process that follows will experience a one-time latency. You can set this configuration for a new service when you create it, or afterward, with a service update. For more information, see One-time latency in the Networking with App Runner chapter of this guide.
Configure your service using the App Runner console
The console uses the App Runner API to apply configuration updates. The update rules that the API imposes, as defined in the previous section, determine what you can configure using the console. Some settings that were available during service creation aren't available for modification later on. In addition, if you decide to use a configuration file, additional settings are hidden in the console, and App Runner reads them from the file.
To configure your service
-
Open the App Runner console
, and in the Regions list, select your AWS Region. -
In the navigation pane, choose Services, and then choose your App Runner service.
The console displays the service dashboard with a Service overview.
-
On the service dashboard page, choose the Configuration tab.
Result: The console displays the current configuration settings of your service in several sections: Source and deployment, Configure build, and Configure service.
-
To update settings in any category, choose Edit.
-
On the configuration edit page, make any desired changes, and then choose Save changes.
Note
If you create an outbound traffic VPC connector for a service, the service startup process that follows will experience a one-time latency. You can set this configuration for a new service when you create it, or afterward, with a service update. For more information, see One-time latency in the Networking with App Runner chapter of this guide.
Configure your service using an App Runner configuration file
When you create or update an App Runner service, you can instruct App Runner to read some configuration settings from a configuration file that you provide as part of your source repository. By doing this, you can manage the settings that are related to your source code under source control, together with the code itself. The configuration file also provides certain advanced settings that you can't set using the console or the API. For more information, see Setting App Runner service options using a configuration file.
Note
If you create an outbound traffic VPC connector for a service, the service startup process that follows will experience a one-time latency. You can set this configuration for a new service when you create it, or afterward, with a service update. For more information, see One-time latency in the Networking with App Runner chapter of this guide.