RHDEVDOCS-6449: Content creation for the Progressive Sync feature #98296

Dhruv-Soni11 · 2025-08-31T09:37:23Z

Version(s):

gitops-docs-1.18

Issue:

https://issues.redhat.com/browse/RHDEVDOCS-6449

Link to docs preview:

Using Progressive Sync in OpenShift GitOps

QE review:

QE has approved this change.

SME review: atali@redhat.com
QE review: @varshab1210
Peer review:

Additional information:

openshift-ci-robot · 2025-08-31T09:37:27Z

@Dhruv-Soni11: This pull request references RHDEVDOCS-6449 which is a valid jira issue.

In response to this:

Version(s):

gitops-docs-1.18

Issue:

https://issues.redhat.com/browse/RHDEVDOCS-6449

Link to docs preview:

QE review:

QE has approved this change.

SME review:
QE review:
Peer review:

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

ocpdocs-previewbot · 2025-08-31T09:43:20Z

🤖 Wed Sep 17 07:52:06 - Prow CI generated the docs preview:

https://98296--ocpdocs-pr.netlify.app/openshift-gitops/latest/argocd_application_sets/using-progressive-sync-in-openshift-gitops.html

dfitzmau · 2025-09-01T15:04:35Z

/retest

dfitzmau · 2025-09-01T15:09:52Z

/retest-required

openshift-ci-robot · 2025-09-02T05:26:01Z

@Dhruv-Soni11: This pull request references RHDEVDOCS-6449 which is a valid jira issue.

In response to this:

Version(s):

gitops-docs-1.18

Issue:

https://issues.redhat.com/browse/RHDEVDOCS-6449

Link to docs preview:

Using Progressive Sync in OpenShift GitOps

QE review:

QE has approved this change.

SME review:
QE review:
Peer review:

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot · 2025-09-02T05:50:57Z

@Dhruv-Soni11: This pull request references RHDEVDOCS-6449 which is a valid jira issue.

In response to this:

Version(s):

gitops-docs-1.18

Issue:

https://issues.redhat.com/browse/RHDEVDOCS-6449

Link to docs preview:

Using Progressive Sync in OpenShift GitOps

QE review:

QE has approved this change.

SME review: atali@redhat.com
QE review:
Peer review:

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

aali309

updated my comments

aali309

@Dhruv-Soni11 please see the updated doc

Also see Abishekh's PR

and argocd documentation

modules/gitops-enabling-progressive-sync.adoc

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

modules/gitops-enabling-progressive-sync.adoc

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

varshab1210 · 2025-09-16T05:35:48Z

LGTM, thanks

openshift-ci-robot · 2025-09-16T12:03:32Z

@Dhruv-Soni11: This pull request references RHDEVDOCS-6449 which is a valid jira issue.

In response to this:

Version(s):

gitops-docs-1.18

Issue:

https://issues.redhat.com/browse/RHDEVDOCS-6449

Link to docs preview:

Using Progressive Sync in OpenShift GitOps

QE review:

QE has approved this change.

SME review: atali@redhat.com
QE review: @varshab1210
Peer review:

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

aali309 · 2025-09-16T12:16:45Z

Thanks @Dhruv-Soni11, LGTM!

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc

ranakan19

LGTM, a quick case correction suggested above.

Incorporating SME review comments Adding QE and SME feedback Incorporating additional SME review comments

openshift-ci · 2025-09-17T07:53:06Z

@Dhruv-Soni11: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

gabriel-rh

this look good to me, a few minor suggestions, but it all depends on whether we are allowed to publish about alpha-quality s/w

gabriel-rh · 2025-09-17T13:17:10Z

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

+* You have logged in to the {OCP} cluster as an administrator.
+* You have installed the {gitops-shortname} Operator on your {OCP} cluster.
+* You can access the default Argo CD instance in the `openshift-gitops` namespace.
+* You have created an Argo CD ApplicationSet in your defined namespace, for example, `openshift-gitops`.


Suggested change

* You have created an Argo CD ApplicationSet in your defined namespace, for example, `openshift-gitops`.

* You have created an Argo CD `ApplicationSet` resource/controller in your defined namespace, for example, `openshift-gitops`.

gabriel-rh · 2025-09-17T13:18:24Z

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

+
+[IMPORTANT]
+====
+This is an experimental, alpha-quality feature. It allows you to control the order in which the `ApplicationSet` controller creates or updates the Applications owned by an `ApplicationSet` resource. The feature might be removed in future releases or changed in a non-backwards-compatible way. For more information, see the upstream documentation for link:https://github.com/argoproj/argoproj/blob/main/community/feature-status.md#alpha[Feature Status in Argo Projects (Github docs)].


We need a decision here from DPM/CS over whether we can publish alpha-quality s/w, due to support considerations. Is this dev preview or tech preview?

gabriel-rh · 2025-09-17T13:19:36Z

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc

+* You have installed the {gitops-shortname} Operator on your {OCP} cluster.
+* You can access the default Argo CD instance in the `openshift-gitops` namespace.
+* You have created an Argo CD ApplicationSet in your defined namespace, for example, `openshift-gitops`.
+* You have created a few Argo CD applications using an Argo CD ApplicationSet, which is defined in your namespace, for example, `openshift-gitops`.


as above for ApplicationSet

gabriel-rh · 2025-09-17T13:22:28Z

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc

+
+.Procedure
+
+. Set the `RollingSync` parameter for the `applicationSet` spec. The following example contains a sample YAML configuration.


Suggested change

. Set the `RollingSync` parameter for the `applicationSet` spec. The following example contains a sample YAML configuration.

. Set the `RollingSync` parameter for the `ApplicationSet` spec. The following example contains a sample YAML configuration.

gabriel-rh · 2025-09-17T13:28:04Z

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc

+        namespace: guestbook-{{.env}}
+----
+
+. Apply the YAML file by running the following command. 


Suggested change

. Apply the YAML file by running the following command.

. Apply the YAML file by running the following command:

gabriel-rh · 2025-09-17T13:31:21Z

modules/gitops-troubleshooting-progressive-sync.adoc

+
+If the **Progressive Sync** section is missing from the Application details:
+
+* Confirm that the application is managed by an `ApplicationSet` with the `RollingSync` strategy.  


Suggested change

* Confirm that the application is managed by an `ApplicationSet` with the `RollingSync` strategy.

* Confirm that the application is managed by an `ApplicationSet` controller with the `RollingSync` strategy.

gabriel-rh · 2025-09-17T13:36:10Z

modules/gitops-adding-extraCommandArgs-to-argo-cd.adoc

+
+:_mod-docs-content-type: PROCEDURE
+[id="gitops-adding-extraCommandArgs-to-argo-cd_{context}"]
+= Adding the 'extraCommandArgs' argument to the Argo CD CR


I think these are meant to be ticks indicating code, instead of single quotes - 'extraCommandArgs'

But again I don't think we are allowed to have styled content in titles, according to style guide, so maybe just leave plain

gabriel-rh · 2025-09-19T14:06:14Z

OCP docs has a strict policy of not documenting dev preview content , only tech preview.

It may be possible for a Content Strategist or DPM to get an exception to this rule, but this probably needs the approval of the support team.

More information available here: https://redhat-documentation.github.io/supplementary-style-guide/#developer-preview-guidance

Some products, such as Red Hat Openshift Container Platform, do not include Developer Preview content in the documentation. Check with your Content Strategist or Support contact to confirm whether you can publish Developer Preview documentation for your product.

openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Aug 31, 2025

openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Aug 31, 2025

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch 2 times, most recently from 90b551f to 1b7d62e Compare August 31, 2025 12:12

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch 2 times, most recently from 96ac556 to 014d597 Compare September 2, 2025 05:19

aali309 suggested changes Sep 2, 2025

View reviewed changes

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc Outdated Show resolved Hide resolved

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc Outdated Show resolved Hide resolved

aali309 approved these changes Sep 4, 2025

View reviewed changes

aali309 suggested changes Sep 10, 2025

View reviewed changes

varshab1210 reviewed Sep 12, 2025

View reviewed changes

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch from 8850d23 to ac2ec16 Compare September 12, 2025 14:19

aali309 suggested changes Sep 15, 2025

View reviewed changes

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc Outdated Show resolved Hide resolved

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch 2 times, most recently from b540e6d to bfef928 Compare September 16, 2025 06:19

ranakan19 reviewed Sep 16, 2025

View reviewed changes

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc Outdated Show resolved Hide resolved

ranakan19 reviewed Sep 16, 2025

View reviewed changes

argocd_application_sets/using-progressive-sync-in-openshift-gitops.adoc Show resolved Hide resolved

ranakan19 reviewed Sep 16, 2025

View reviewed changes

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc Outdated Show resolved Hide resolved

ranakan19 reviewed Sep 16, 2025

View reviewed changes

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc Outdated Show resolved Hide resolved

ranakan19 reviewed Sep 16, 2025

View reviewed changes

modules/gitops-creating-appset-sync-manifest-using-rollingsync.adoc Outdated Show resolved Hide resolved

ranakan19 approved these changes Sep 16, 2025

View reviewed changes

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch from 6f2df65 to 2f734f8 Compare September 17, 2025 07:24

RHDEVDOCS-6449: Content creation for the Progressive Sync feature

d261338

Incorporating SME review comments Adding QE and SME feedback Incorporating additional SME review comments

Dhruv-Soni11 force-pushed the RHDEVDOCS-6449 branch from 2f734f8 to d261338 Compare September 17, 2025 07:38

gabriel-rh reviewed Sep 17, 2025

View reviewed changes

	* You have created an Argo CD ApplicationSet in your defined namespace, for example, `openshift-gitops`.
	* You have created an Argo CD `ApplicationSet` resource/controller in your defined namespace, for example, `openshift-gitops`.


		.Procedure

		. Set the `RollingSync` parameter for the `applicationSet` spec. The following example contains a sample YAML configuration.

	. Apply the YAML file by running the following command.
	. Apply the YAML file by running the following command:


		If the Progressive Sync section is missing from the Application details:

		* Confirm that the application is managed by an `ApplicationSet` with the `RollingSync` strategy.

RHDEVDOCS-6449: Content creation for the Progressive Sync feature #98296

Are you sure you want to change the base?

RHDEVDOCS-6449: Content creation for the Progressive Sync feature #98296

Uh oh!

Conversation

Dhruv-Soni11 commented Aug 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Aug 31, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented Aug 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dfitzmau commented Sep 1, 2025

Uh oh!

dfitzmau commented Sep 1, 2025

Uh oh!

openshift-ci-robot commented Sep 2, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Sep 2, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aali309 left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aali309 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

varshab1210 commented Sep 16, 2025

Uh oh!

openshift-ci-robot commented Sep 16, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

aali309 commented Sep 16, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ranakan19 left a comment

Choose a reason for hiding this comment

Uh oh!

openshift-ci bot commented Sep 17, 2025

Uh oh!

gabriel-rh left a comment

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Choose a reason for hiding this comment

Uh oh!

gabriel-rh Sep 17, 2025

Dhruv-Soni11 commented Aug 31, 2025 •

edited

Loading

openshift-ci-robot commented Aug 31, 2025 •

edited by openshift-ci bot

Loading

ocpdocs-previewbot commented Aug 31, 2025 •

edited

Loading

openshift-ci-robot commented Sep 2, 2025 •

edited by openshift-ci bot

Loading

openshift-ci-robot commented Sep 2, 2025 •

edited by openshift-ci bot

Loading

aali309 left a comment •

edited

Loading

openshift-ci-robot commented Sep 16, 2025 •

edited by openshift-ci bot

Loading