You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _docs/promotions/entities/promotion-workflow.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -99,13 +99,13 @@ At the simplest levels, you can display the values from the parameters in notifi
99
99
|`APP_NAMESPACE`| The namespace where the application is deployed to. For example,`gitops`.| ✅| ✅|
100
100
|`APP_NAME`| The name of the specific application the Promotion Workflows and the Promotion Action pertain to. For example,`trioapp-staging`.| ✅| ✅|
101
101
|`REPO_URL`| The Git repository with the application settings, as defined in the application's configuration. See[Source settings for applications]({{site.baseurl}}/docs/deployments/gitops/create-application/#sources).| ✅| ✅|
102
-
|`BRANCH`| The specific Git branch to which to promote changes. For example,`main`.|✅| ✅|
102
+
|`BRANCH`| The specific Git branch to which to promote changes, retrieved from`spec.source.targetRevision` defined in the application's configuration settings. <br>If`spec.source.targetRevision` is set to`HEAD`, this is the value used for`BRANCH` in both the Pre- and Post-Action Workflows, even if the resolved branch name is`main`,`master`, or any custom name.|✅| ✅|
103
103
|`PATH`| The relative path within the repository defined by`REPO_URL` to the directory or file containing the application's configuration. See[Source settings for applications]({{site.baseurl}}/docs/deployments/gitops/create-application/#sources).| ✅| ✅|
104
104
|`RUNTIME`|The name of the GitOps Runtime the application being promoted is associated with.|✅| ✅|
105
-
|`COMMIT_SHA`| The unique identifier (SHA) of the commit, generated by Git, including the precise set of changes addressed by the commit. Can be used as a trigger condition in Promotion Flows configured for a product.||✅|
106
-
|`COMMIT_AUTHOR`| The name of the user who made the commit. Useful for tracking changes and for notifications.|| ✅|
107
-
|`COMMIT-MESSAGE`| The text in the commit message associated with the code change that triggered the promotion, providing context for the changes introduced by the commit.||✅|
108
-
|`COMMIT-DATE`| The date and time when the commit was made. Useful to correlate the commit with other events and understand the timeline of changes.|| ✅|
105
+
|`COMMIT_SHA`| The unique identifier (SHA) of the commit, generated by Git, including the precise set of changes addressed by the commit. Can be used as a trigger condition in Promotion Flows configured for a product.<br>Available in Post-Action Workflows only for commit-based Promotion Actions. Not available for PR-based Promotion Actions.||✅|
106
+
|`COMMIT_AUTHOR`| The name of the user who made the commit. Useful for tracking changes and for notifications.<br>Available in Post-Action Workflows only for commit-based Promotion Actions. Not available for PR-based Promotion Actions.|| ✅|
107
+
|`COMMIT-MESSAGE`| The text in the commit message associated with the code change that triggered the promotion, providing context for the changes introduced by the commit.<br>Available in Post-Action Workflows only for commit-based Promotion Actions. Not available for PR-based Promotion Actions.||✅|
108
+
|`COMMIT-DATE`| The date and time when the commit was made. Useful to correlate the commit with other events and understand the timeline of changes.<br>Available in Post-Action Workflows only for commit-based Promotion Actions. Not available for PR-based Promotion Actions.|| ✅|
109
109
110
110
111
111
###Custom global parameters
@@ -125,6 +125,7 @@ outputs:
125
125
See this [example](#example-3-pre--and-post-action-workflows-with-custom-globalname-argument-usage) that uses the`globalName` argument.