From 08a9a04b367d0c58c22ef3f08851fd17dcdf14ca Mon Sep 17 00:00:00 2001
From: Luke Amato <107487942+ThatAmatoGuy@users.noreply.github.com>
Date: Thu, 11 Dec 2025 09:57:14 -0800
Subject: [PATCH] Change role_arn parameter to optional for push step
Updated the 'role_arn' parameter description to indicate it is optional for pushing images.
---
_docs/pipelines/steps/push.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/_docs/pipelines/steps/push.md b/_docs/pipelines/steps/push.md
index 1974e741e..e549e9ba2 100644
--- a/_docs/pipelines/steps/push.md
+++ b/_docs/pipelines/steps/push.md
@@ -58,7 +58,7 @@ step_name:
| `candidate` | The identifier of the image to push to the remote Docker registry. It can be an explicit identifier of an image to push, or a variable that references a `Build` step. | Required |
| `tag` | The tag under which to push the image. Use either this or `tags`. The default is `latest`. | Default |
| `region` | Relevant only for [Amazon ECR]({{site.baseurl}}/docs/integrations/docker-registries/amazon-ec2-container-registry/) integrations using either service accounts or explicit credentials. The names of the regions for which to perform cross-region replication. The names of the source region and the destination region name must be defined in separate steps. | Optional |
-| `role_arn` | Relevant only for [Amazon ECR]({{site.baseurl}}/docs/integrations/docker-registries/amazon-ec2-container-registry/) integrations using either service accounts or explicit credentials. The role with the required permissions to use to pull the image. For example, `arn:aws:iam:::role/` | Required |
+| `role_arn` | Relevant only for [Amazon ECR]({{site.baseurl}}/docs/integrations/docker-registries/amazon-ec2-container-registry/) integrations using either service accounts or explicit credentials. The role with the required permissions to use to push the image. For example, `arn:aws:iam:::role/` | Optional |
| `aws_session_name` | Relevant only for [Amazon ECR]({{site.baseurl}}/docs/integrations/docker-registries/amazon-ec2-container-registry/) integrations using either service accounts or explicit credentials. The name of the AWS session. If not defined, `default-session-name` is used. | Default |
| `aws_duration_seconds` | Relevant only for [Amazon ECR]({{site.baseurl}}/docs/integrations/docker-registries/amazon-ec2-container-registry/) integrations using either service accounts or explicit credentials. The length of time, in seconds, for which the role credentials are considered valid, and must be between `900-3600` seconds. If not defined, the duration is set to the default of `3600` seconds. | Default |
| `tags` | Multiple tags under which to push the image. Use either this or `tag`. This is an array, so should be of the following style: {::nomarkdown}
tags: -tag1 -tag2 -{% raw %}${{CF_BRANCH_TAG_NORMALIZED_LOWER_CASE}}{% endraw %} -tag4
{:/}or {::nomarkdown}
tags:['tag1','tag2','{% raw %}${{CF_BRANCH_TAG_NORMALIZED_LOWER_CASE}}{% endraw %}','tag4']
{:/} | Default |
@@ -310,4 +310,4 @@ step_name:
## Related articles
[Docker registry integrations]({{site.baseurl}}/docs/integrations/docker-registries/)
[Custom Image annotations]({{site.baseurl}}/docs/pipelines/docker-image-metadata/)
-[Steps in pipelines]({{site.baseurl}}/docs/pipelines/steps/)
\ No newline at end of file
+[Steps in pipelines]({{site.baseurl}}/docs/pipelines/steps/)