Update a service pipeline
Learn to update an AWS Proton service pipeline and cancel the update.
A service pipeline belongs to a service. You can only create or delete a pipeline within the context of service create and delete actions.
There are four modes for updating a service pipeline as described in the following list. When using the AWS CLI, the deployment-type
field
defines the mode. When you use the console, these modes map to the Edit pipeline and Update to recommended
version.
-
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
-
CURRENT_VERSION
In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this
deployment-type
. -
MINOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use by default. You can also specify a different minor version of the current major version in use.
-
MAJOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
You can attempt to cancel a service pipeline update deployment if the deploymentStatus
is IN_PROGRESS
. AWS Proton attempts to
cancel the deployment. Successful cancellation isn’t guaranteed.
When you cancel an update deployment, AWS Proton attempts to cancel the deployment as listed in the following steps.
-
Sets the deployment state to
CANCELLING
. -
Stops the deployment in process and deletes any new resources that were created by the deployment when
IN_PROGRESS
. -
Sets the deployment state to
CANCELLED
. -
Reverts the state of the resource to what it was before the deployment was started.
For more information on cancelling a service pipeline deployment, see CancelServicePipelineDeployment in the AWS Proton API Reference.
Use the console or AWS CLI to make updates or cancel update deployments.