Skip to content

[set_containers] Add cifmw.general.set_containers module#3955

Open
arxcruz wants to merge 1 commit into
openstack-k8s-operators:mainfrom
arxcruz:feature/set-containers-module
Open

[set_containers] Add cifmw.general.set_containers module#3955
arxcruz wants to merge 1 commit into
openstack-k8s-operators:mainfrom
arxcruz:feature/set-containers-module

Conversation

@arxcruz
Copy link
Copy Markdown
Contributor

@arxcruz arxcruz commented May 22, 2026

Replace the update_containers role invocation in deploy_architecture with the new cifmw.general.set_containers module. The module generates and optionally applies an OpenStackVersion CR, accepting a dynamic images list where each entry can override registry, org, name_prefix, and tag individually. This removes the rigid Jinja2 template in favor of a Python module that is easier to test, extend, and call from any playbook without role-level variable coupling.

Key design points:

  • _OPENSTACK_SUFFIXES table enables partial overrides (e.g. tag-only) for any standard OpenStack image field without repeating the suffix.
  • Empty name_prefix is supported so images that ship without the "openstack-" prefix (EDPM, IPA) can be built from parts rather than requiring a pre-assembled full_registry URL.
  • backends list handles cinderVolumeImages / manilaShareImages nested dicts.
  • Unit tests cover _build_url, _resolve_image, _resolve_backend, _build_cr, and the full run_module flow including apply, absent, and validation paths.

@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented May 22, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign dasm for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found 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

@centosinfra-prod-github-app
Copy link
Copy Markdown

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://gateway-cloud-softwarefactory.apps.ocp.cloud.ci.centos.org/zuul/t/rdoproject.org/buildset/59cc46027da04af38a632c597c515613

✔️ openstack-k8s-operators-content-provider SUCCESS in 3h 18m 45s
✔️ podified-multinode-edpm-deployment-crc SUCCESS in 1h 26m 14s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 41m 05s
✔️ cifmw-crc-podified-edpm-baremetal-minor-update SUCCESS in 1h 59m 58s
✔️ cifmw-pod-zuul-files SUCCESS in 5m 08s
✔️ adoption-standalone-to-crc-ceph-provider SUCCESS in 3h 05m 41s
✔️ noop SUCCESS in 0s
cifmw-pod-ansible-test FAILURE in 6m 00s
cifmw-pod-pre-commit FAILURE in 8m 09s
✔️ cifmw-molecule-cifmw_setup SUCCESS in 2m 38s

@arxcruz arxcruz force-pushed the feature/set-containers-module branch from 4b08e81 to 7ff95ec Compare May 22, 2026 16:19
@centosinfra-prod-github-app
Copy link
Copy Markdown

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://gateway-cloud-softwarefactory.apps.ocp.cloud.ci.centos.org/zuul/t/rdoproject.org/buildset/0eaf31714d824b02baf38086cb3ec17a

✔️ openstack-k8s-operators-content-provider SUCCESS in 3h 26m 34s
✔️ podified-multinode-edpm-deployment-crc SUCCESS in 1h 26m 24s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 33m 28s
✔️ cifmw-crc-podified-edpm-baremetal-minor-update SUCCESS in 1h 59m 17s
✔️ cifmw-pod-zuul-files SUCCESS in 4m 49s
✔️ adoption-standalone-to-crc-ceph-provider SUCCESS in 3h 11m 41s
✔️ noop SUCCESS in 0s
cifmw-pod-ansible-test FAILURE in 6m 43s
cifmw-pod-pre-commit FAILURE in 9m 27s
✔️ cifmw-molecule-cifmw_setup SUCCESS in 2m 13s

@arxcruz arxcruz force-pushed the feature/set-containers-module branch 4 times, most recently from 507f3c3 to 20386f6 Compare May 23, 2026 08:35
Comment thread roles/cifmw_setup/tasks/deploy_architecture.yml Outdated
Comment thread roles/cifmw_setup/tasks/deploy_architecture.yml
Comment thread roles/cifmw_setup/tasks/deploy_architecture.yml
Comment thread plugins/modules/set_containers.py Outdated
Comment thread plugins/modules/set_containers.py
Comment thread plugins/modules/set_containers.py Outdated
Comment thread plugins/modules/set_containers.py Outdated
Comment thread plugins/modules/set_containers.py Outdated
Comment thread tests/unit/modules/test_set_containers.py Outdated
Replace the update_containers role invocation in deploy_architecture with
the new cifmw.general.set_containers module. The module generates and
optionally applies an OpenStackVersion CR, accepting a dynamic images list
where each entry can override registry, org, name_prefix, and tag
individually. This removes the rigid Jinja2 template in favor of a Python
module that is easier to test, extend, and call from any playbook without
role-level variable coupling.

Key design points:
- _OPENSTACK_SUFFIXES table enables partial overrides (e.g. tag-only) for
  any standard OpenStack image field without repeating the suffix.
- Empty name_prefix is supported so images that ship without the
  "openstack-" prefix (EDPM, IPA) can be built from parts rather than
  requiring a pre-assembled full_registry URL.
- backends list handles cinderVolumeImages / manilaShareImages nested dicts.
- Unit tests cover _build_url, _resolve_image, _resolve_backend, _build_cr,
  and the full run_module flow including apply, absent, and validation paths.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Arx Cruz <arxcruz@redhat.com>
@arxcruz arxcruz force-pushed the feature/set-containers-module branch from 20386f6 to 069b3b9 Compare May 26, 2026 09:21
@centosinfra-prod-github-app
Copy link
Copy Markdown

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://gateway-cloud-softwarefactory.apps.ocp.cloud.ci.centos.org/zuul/t/rdoproject.org/buildset/f0e6dcf146e549c69f1b8afa58e43841

✔️ openstack-k8s-operators-content-provider SUCCESS in 3h 21m 40s
✔️ podified-multinode-edpm-deployment-crc SUCCESS in 1h 25m 48s
✔️ cifmw-crc-podified-edpm-baremetal SUCCESS in 1h 34m 55s
✔️ cifmw-crc-podified-edpm-baremetal-minor-update SUCCESS in 2h 02m 06s
✔️ cifmw-pod-zuul-files SUCCESS in 4m 53s
✔️ adoption-standalone-to-crc-ceph-provider SUCCESS in 3h 08m 45s
✔️ noop SUCCESS in 0s
✔️ cifmw-pod-ansible-test SUCCESS in 9m 02s
cifmw-pod-pre-commit FAILURE in 8m 33s
✔️ cifmw-molecule-cifmw_setup SUCCESS in 2m 08s

Copy link
Copy Markdown

@jokke-ilujo jokke-ilujo left a comment

Choose a reason for hiding this comment

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

I have some concerns of the dest_path file handling. Other than that looks quite good on the first pass.

module.fail_json(
msg="oc delete failed", rc=rc, stdout=out, stderr=err
)
os.remove(dest_path)
Copy link
Copy Markdown

@jokke-ilujo jokke-ilujo May 27, 2026

Choose a reason for hiding this comment

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

As the dest_path is a freeform input from the module parameters without sanitization this module can behave like universal delete and we only check that the path exists. We should probably encapsulate the os.remove in try-except block for various error conditions and fail the module gracefully should they occur.

cr_yaml = yaml.dump(cr, default_flow_style=False, sort_keys=False)

existing = None
if os.path.exists(dest_path):
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This does not guarantee That the dest_path is a file nor that we actually can read it (it might be for example existing folder returning true). os.path.isabs and os.path.is_file checks with graceful module failure could mitigate the risks here quite a bit.

kubeconfig=dict(type="path", default=None),
)

module = AnsibleModule(argument_spec=module_args, supports_check_mode=True)
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Using ansible.module_utils.common.arg_spec.ArgumentSpecValidator here could be very useful to ensure we actually have correct looking arguments provided before moving forward.

existing = None
if os.path.exists(dest_path):
with open(dest_path, "r") as fh:
existing = fh.read()
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

We probably should check here that the "existing" somewhat looks like CR, start by yaml parsing "is this file content actually yaml", etc. To make sure we don't overwrite some random file in the filesystem with the new CR.

dest_dir = os.path.dirname(dest_path)
if dest_dir:
os.makedirs(dest_dir, exist_ok=True)
with open(dest_path, "w") as fh:
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Ditto with read. We have no guarantees at this point that the dest_path is a writeable file. We should try and fail gracefully.

set_containers.run_module()
mock_rm.assert_called_once_with("/tmp/set_containers.yml")
self.assertTrue(cm.exception.args[0]["changed"])

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Add tests for various invalid 'dest_path's (no write permissions, directory, empty string "", invalid content (say /etc/hosts for example))

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants