Skip to content

[test_operator] Automatic sync of README.md#3589

Merged
openshift-merge-bot[bot] merged 1 commit intoopenstack-k8s-operators:mainfrom
sauragar:OSPRH-19423
Mar 10, 2026
Merged

[test_operator] Automatic sync of README.md#3589
openshift-merge-bot[bot] merged 1 commit intoopenstack-k8s-operators:mainfrom
sauragar:OSPRH-19423

Conversation

@sauragar
Copy link
Contributor

@sauragar sauragar commented Jan 7, 2026

This commit will ensure to have the proper auto-sync of README.md with the defaults/main.yml file and also added the post-commit file so whenever someone commits in the defaults/main.yml file the script can be auto-run

Ticket: OSPRH-19423

This PR #3327 is closed since I am not able to reopen the PR

Signed-off-by: Saurabh Agarwal sauragar@redhat.com

Copy link
Contributor

@kstrenkova kstrenkova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the PR! I have tested it locally and found a small issue with updating the defaults. It is explained in the comments, the fix should be rather simple. Other than that I saw the README sync was working nicely, so I think you're close to the finish 🎉 I like that the parameters will be in alphabetical order now :D Maybe there could be a mention of the script somewhere in the README so that people know they can use the sync when creating new variables or updating the old ones.

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/4de28a813ea54e73883c28ab7ff35c81

✔️ openstack-k8s-operators-content-provider SUCCESS in 2h 18m 29s
✔️ podified-multinode-edpm-deployment-crc SUCCESS in 1h 20m 49s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 41m 18s
✔️ cifmw-crc-podified-edpm-baremetal-minor-update SUCCESS in 2h 04m 04s
✔️ cifmw-multinode-tempest SUCCESS in 1h 45m 54s
✔️ cifmw-pod-zuul-files SUCCESS in 4m 23s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 8m 48s
cifmw-pod-pre-commit FAILURE in 7m 42s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 29s

Copy link
Contributor

@kstrenkova kstrenkova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is left are just a few transformations from defaults to to Default value: where it is possible. Other than that lgtm.

Copy link
Contributor

@kstrenkova kstrenkova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am adding 2 comments about the same issue atop of my previous comments.

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/fe0fdd8386324989bd8ea335a95f52d6

openstack-k8s-operators-content-provider FAILURE in 4m 53s
⚠️ podified-multinode-edpm-deployment-crc SKIPPED Skipped due to failed job openstack-k8s-operators-content-provider
⚠️ cifmw-crc-podified-edpm-baremetal SKIPPED Skipped due to failed job openstack-k8s-operators-content-provider
⚠️ cifmw-crc-podified-edpm-baremetal-minor-update SKIPPED Skipped due to failed job openstack-k8s-operators-content-provider
⚠️ cifmw-multinode-tempest SKIPPED Skipped due to failed job openstack-k8s-operators-content-provider
✔️ cifmw-pod-zuul-files SUCCESS in 4m 32s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 12m 50s
cifmw-pod-pre-commit FAILURE in 8m 07s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 03s

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/5eac463796534f4b89b1f990b236fe22

✔️ openstack-k8s-operators-content-provider SUCCESS in 2h 29m 11s
✔️ podified-multinode-edpm-deployment-crc SUCCESS in 1h 28m 37s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 39m 55s
✔️ cifmw-crc-podified-edpm-baremetal-minor-update SUCCESS in 2h 10m 53s
✔️ cifmw-multinode-tempest SUCCESS in 1h 53m 13s
✔️ cifmw-pod-zuul-files SUCCESS in 4m 24s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 8m 36s
cifmw-pod-pre-commit FAILURE in 8m 30s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 00s

Copy link
Contributor

@kstrenkova kstrenkova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am leaving a few very small comments. I think the PR is almost done, so it would be a good idea to ask someone else for a review to get more perspective. I am also not sure about editing the pre-commit and setup_molecule files, we need someone from ci-framework for that :D

Copy link
Contributor

@michburk michburk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A handful of comments and suggestions.

Overall, I understand the motivation to keep the readme up to date by using a script. We've done a pretty poor job of enforcing that the docs be updated with every change to the defaults, but I don't love the idea of designing and maintaining a script specifically for just one role's readme. I'd be curious to see what other cifmw folks have to say.

@kstrenkova
Copy link
Contributor

recheck

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/3bc1c9a16aeb42628016f8cf3fdaeeee

✔️ openstack-k8s-operators-content-provider SUCCESS in 29m 06s
podified-multinode-edpm-deployment-crc RETRY_LIMIT in 11m 23s
cifmw-crc-podified-edpm-baremetal RETRY_LIMIT in 14m 16s
cifmw-crc-podified-edpm-baremetal-minor-update RETRY_LIMIT in 14m 41s
cifmw-multinode-tempest RETRY_LIMIT in 11m 20s
✔️ cifmw-pod-zuul-files SUCCESS in 6m 24s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 10m 46s
✔️ cifmw-pod-pre-commit SUCCESS in 10m 23s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 24s

@kstrenkova
Copy link
Contributor

recheck

Add automatic sync script to keep README.md in sync with defaults/main.yml:
- Create sync_test_operator_var_readme.py for automated documentation updates
- Generate GitHub URLs with line anchors for direct navigation to variable definitions
- Display inline default values for simple/single-line variables
- Redirect complex values (lists, dicts, multiline) to defaults/main.yml
- Preserve existing default text variations (e.g., "Defaults to", "defaults to")
- Only add "Default value:" when completely missing from documentation
- Reorganize parameter documentation in alphabetical order
- Add auto-sync note at the top of README.md
- Fix pre-commit ansible-lint compatibility

Signed-off-by: Saurabh Agarwal <sauragar@redhat.com>
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@danpawlik
Copy link
Contributor

recheck

1 similar comment
@danpawlik
Copy link
Contributor

recheck

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/6cd4199a72af4cccbab5d63534c85598

✔️ openstack-k8s-operators-content-provider SUCCESS in 27m 49s
podified-multinode-edpm-deployment-crc RETRY_LIMIT in 11m 58s
cifmw-crc-podified-edpm-baremetal RETRY_LIMIT in 14m 25s
cifmw-crc-podified-edpm-baremetal-minor-update RETRY_LIMIT in 14m 24s
cifmw-multinode-tempest RETRY_LIMIT in 11m 41s
✔️ cifmw-pod-zuul-files SUCCESS in 5m 06s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 9m 20s
✔️ cifmw-pod-pre-commit SUCCESS in 9m 11s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 23s

@sauragar
Copy link
Contributor Author

recheck

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/de2d99a5256744f28746b92c94bd6802

✔️ openstack-k8s-operators-content-provider SUCCESS in 28m 07s
podified-multinode-edpm-deployment-crc RETRY_LIMIT in 11m 22s
cifmw-crc-podified-edpm-baremetal RETRY_LIMIT in 14m 33s
cifmw-crc-podified-edpm-baremetal-minor-update RETRY_LIMIT in 14m 18s
cifmw-multinode-tempest RETRY_LIMIT in 11m 16s
✔️ cifmw-pod-zuul-files SUCCESS in 6m 39s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 9m 16s
✔️ cifmw-pod-pre-commit SUCCESS in 11m 00s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 09s

@sauragar
Copy link
Contributor Author

recheck

@softwarefactory-project-zuul
Copy link

Build failed (check pipeline). Post recheck (without leading slash)
to rerun all jobs. Make sure the failure cause has been resolved before
you rerun jobs.

https://softwarefactory-project.io/zuul/t/rdoproject.org/buildset/234171f9308c4152b21287d43029ea62

✔️ openstack-k8s-operators-content-provider SUCCESS in 2h 12m 48s
podified-multinode-edpm-deployment-crc FAILURE in 21m 13s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 35m 54s
cifmw-crc-podified-edpm-baremetal-minor-update FAILURE in 28m 37s
✔️ cifmw-multinode-tempest SUCCESS in 1h 59m 11s
✔️ cifmw-pod-zuul-files SUCCESS in 5m 14s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 9m 01s
✔️ cifmw-pod-pre-commit SUCCESS in 8m 47s
✔️ cifmw-molecule-test_operator SUCCESS in 3m 06s

@kstrenkova
Copy link
Contributor

recheck

@sauragar
Copy link
Contributor Author

sauragar commented Mar 5, 2026

@michburk Can you please approve this so that we can merge this change?

Copy link
Contributor

@michburk michburk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple little things, maybe put them down as ideas for future improvements.

@kstrenkova
Copy link
Contributor

/lgtm

@kstrenkova
Copy link
Contributor

/approve

@kstrenkova
Copy link
Contributor

@rebtoor Can you please take a look, we don't have the approve rights here it seems :D

@michburk
Copy link
Contributor

/approve

@openshift-ci
Copy link
Contributor

openshift-ci bot commented Mar 10, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kstrenkova, michburk

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-merge-bot openshift-merge-bot bot merged commit b737ebc into openstack-k8s-operators:main Mar 10, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants