Deploying a new application version to App Runner
When you create a service in AWS App Runner, you configure an application source—a container image or a source repository. App Runner provisions resources to run your service and deploys your application to them.
This topic describes ways to redeploy your application source to your App Runner service when a new version becomes available. This can be a new image version in the image repository or a new commit in the code repository. App Runner provides two methods to deploy to a service: automatic and manual.
Deployment methods
App Runner provides the following methods for you to control how application deployments are initiated.
- Automatic deployment
-
Use automatic deployment when you want continuous integration and deployment (CICD) behavior for your service. App Runner monitors your image or code repository. Whenever you push a new image version to your image repository, or a new commit to your code repository, App Runner automatically deploys it to your service without further action on your side.
Note App Runner doesn't support automatic deployment for Amazon ECR Public images, and for images in an Amazon ECR repository that belongs to a different AWS account than the one that your service is in.
- Manual deployment
-
Use manual deployment when you want to explicitly initiate each deployment to your service. You initiate a deployment if the repository that you configured for your service has a new version that you want to deploy. For more information, see Manual deployment.
You can configure the deployment method for your service in the following ways:
-
Console – For a new service you're creating or for an existing service, in the Deployment settings section of the Source and deployment configuration page, choose Manual or Automatic.
-
API or AWS CLI – In a call to either the CreateService or UpdateService action, set the
AutoDeploymentsEnabled
member of the SourceConfiguration parameter toFalse
for manual deployment orTrue
for automatic deployment.
Manual deployment
With manual deployment, you need to explicitly initiate each deployment to your service. When you have a new version of your application image or code ready to deploy, you can refer to the following sections to learn how to perform a deployment using the console and the API.
Deploy a version of your application using one of the following methods: