Skip to content

Commit 4776f7c

Browse files
NimRegevNimRegev
authored
Add article o n promotion limitations (#1318)
* Add article o n promotion limitations Added new article on promotion limitations * Update promotion-limitations.md * Update promotion-limitations.md
1 parent c74468f commit 4776f7c

12 files changed

+45
-8
lines changed

‎_data/argohub-nav.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -254,6 +254,8 @@
254254
url: "/promotion-components"
255255
- title: Promotion setup guidelines
256256
url: "/create-promotion-sequence"
257+
- title: Promotion limitations
258+
url: "/promotion-limitations"
257259
- title: Promotion Flows
258260
url: "/promotion-flow"
259261
- title: Promotion Policies

‎_data/nav.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -431,6 +431,8 @@
431431
url: "/promotion-components"
432432
- title: Promotion setup guidelines
433433
url: "/create-promotion-sequence"
434+
- title: Promotion limitations
435+
url: "/promotion-limitations"
434436
- title: Promotion Flows
435437
url: "/promotion-flow"
436438
- title: Promotion Policies

‎_docs/promotions/create-promotion-sequence.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This article outlines the tasks required to configure, trigger, and monitor prom
1010

1111
Promotions are a critical part of continuous delivery, enabling you to move changes through environments while meeting deployment and compliance requirements. A successful promotion sequence depends on key components that define and orchestrate the promotion flow. To review these components, see [Promotion building blocks]({{site.baseurl}}/docs/promotions/promotion-components/).
1212

13-
13+
For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
1414

1515
## Prerequisites
1616
1. [Configuration Runtime]({{site.baseurl}}/docs/installation/gitops/configuration-runtime/)

‎_docs/promotions/product-promotion-props.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,8 @@ Review [examples of promotable properties]({{site.baseurl}}/docs/products/promot
7878

7979
For details, see [Configuring properties for promotion across applications]({{site.baseurl}}/docs/products/promotion-version-properties/#configuring-properties-for-promotion-across-applications).
8080

81-
81+
>**NOTE**
82+
For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
8283

8384
## Concurrent promotion behavior for product
8485

@@ -119,3 +120,4 @@ Assigning flows and defining their triggers ensure that changes to the product a
119120
## Related articles
120121
[Configure Product Settings]({{site.baseurl}}/docs/products/configure-product-settings/)
121122
[Create products]({{site.baseurl}}/docs/products/create-product/)
123+
[Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/)

‎_docs/promotions/product-releases.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@ Release notes compile changes from various sources into a single view, enabling
8181
See [Analyze change history in Release Notes](#analyze-change-history-in-release-notes).
8282

8383

84+
8485
## View releases for products
8586

8687
The Releases tab for a product displays the releases for that product, whether successful or failed.
@@ -421,6 +422,7 @@ max-width="60%"
421422
## Related articles
422423
[Promotion Flows]({{site.baseurl}}/docs/promotions/promotion-flow/)
423424
[Trigger promotions]({{site.baseurl}}/docs/promotions/trigger-promotions/)
425+
[Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/)
424426
[Promotion quick starts]({{site.baseurl}}/docs/gitops-quick-start/promotions/)
425427
[Promotions: Setup & configuration guidelines]({{site.baseurl}}/docs/promotions/create-promotion-sequence/)
426428

‎_docs/promotions/promotion-components.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ For an end-to-end guide on continuous delivery with Codefresh GitOps, see [Promo
1919
A promotion comprises several entities, some optional and some required, that define its behavior.
2020

2121
The table below summarizes the core entities and promotion-specific entities, outlining their roles in the promotion process.
22-
22+
For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
2323

2424
### Core entities for promotions
2525
These entities define the structure of your deployment.<br>They support standard promotion flows, enabling typical deployment scenarios such as promotions between two environments. See our [quick starts on promotions]({{site.baseurl}}/docs/gitops-quick-start/gitops-quick-start/#promoting-applications).

‎_docs/promotions/promotion-flow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ max-width="60%"
110110

111111
## Promotion Flow behavior: Key insights
112112
Here are a few useful factors to be aware of when creating Promotion Flows.
113-
113+
For details on current limitations, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
114114

115115
### Environments in Promotion Flows
116116

‎_docs/promotions/promotion-limitations.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: "Promotion limitations"
3+
description: "Review the current limitations when working with promotions"
4+
group: promotions
5+
toc: true
6+
---
7+
8+
9+
## Current limitations for promotions
10+
The table below lists the current limitations when working with promotions.
11+
12+
{: .table .table-bordered .table-hover}
13+
| Item | Limitation |
14+
| -------------- | -------------- |
15+
|Git providers | GitHub only.<br>The following Git-based actions are supported:{::nomarkdown}<ul><li>Opening a pull request (PR)</li><li>Adding Git commit status updates with a link to the release</li></ul>{:/}|
16+
|Argo Rollouts | Partially supported.<br>{::nomarkdown}<ul><li>An application that reports a Healthy status may trigger the next stage in the promotion before the rollout is complete.</li><li>Promotion release fails if Argo Rollout remains in Processing state for over two hours</li></ul>{:/}|
17+
|Multi-source applications | Not supported.<br>{::nomarkdown}<ul><li>Promotions are not supported for Argo CD applications with multiple sources (multi-source applications).</li></ul>{:/}|
18+
|Promotable files & properties | {::nomarkdown}<ul><li><b>File scope</b>:<br>Only files in the root or a subdirectory of the <a href="https://codefresh.io/docs/docs/deployments/gitops/application-configuration-settings/#source"> Argo CD application source</a> can be promoted. Files outside this scope are ignored.</li><li><b>Value overrides</b>:<br> Inline value overrides in the application manifest, by adding `values:` in `spec.source.helm` for example, are not supported for promotion.</li></ul>{:/}|
19+
20+
## Related articles
21+
[About promotions]({{site.baseurl}}/docs/promotions/promotions-overview/)
22+
[Configure Promotion Flows]({{site.baseurl}}/docs/promotions/promotion-flow/)
23+
[Trigger promotions]({{site.baseurl}}/docs/promotions/trigger-promotions/)
24+
[Tracking product promotions through releases]({{site.baseurl}}/docs/promotions/product-releases/)
25+
[Promotions: Setup & configuration guidelines]({{site.baseurl}}/docs/promotions/create-promotion-sequence/)

‎_docs/promotions/promotions-overview.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ max-width="60%"
2323
Watch this video to see a promotion in action:
2424
<iframe width="560" height="315" src="https://www.youtube.com/embed/4isYoutmRco?si=EDSfZFQQ4Dp5gw6i" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
2525

26-
<!--- {::nomarkdown}<img src=../../../images/icons/video-play-icon-blue.svg?display=inline-block>{:/} [Drag-and-drop Promotion](https://www.youtube.com/watch?v=4isYoutmRco&t=1s){:target="\_blank"} -->
26+
2727

2828

2929

@@ -56,7 +56,9 @@ max-width="65%"
5656
%}
5757

5858
>**NOTE**
59-
Promotions in Codefresh GitOps require Runtime version 0.13.4 or higher. Ensure your runtime is updated to access promotion features.
59+
Promotions in Codefresh GitOps require Runtime version 0.13.4 or higher. Ensure your Runtime is updated to access promotion features.
60+
61+
For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
6062

6163

6264
## Key features with GitOps promotions

‎_docs/promotions/trigger-promotions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Manual promotion offer different levels of control, accessible from distinct are
2222

2323
The [quick reference for manual promotion triggers](#manual-promotion-triggers-quick-reference) provides details on the different options, where you can find them, and potential use cases for each. How-to details are in the sections that follow the quick reference.
2424

25-
25+
For details on current limitations when working with promotions, see [Promotion limitations]({{site.baseurl}}/docs/promotions/promotion-limitations/).
2626

2727
## Manual promotion triggers: quick reference
2828

0 commit comments

Comments
 (0)