ci-framework
Welcome to the documentation for Ci-Framework. This documentation is designed to help you get up and running with our project as quickly and smoothly as possible. We’ll walk you through everything from setting up your development environment to understanding our code structure and contributing to the project.
Project purpose
CI-Framework is a way to bootstrap development and CI environments for RHOSO. It is not intended for a production use, and should not be treated as a persistent deployment.
Found a bug or need a new feature?
The project is under constant development, bugs happen.
If you have such a bad encounter, please fill an issue in Jira.
Choose OSPRH project, add cifmw label, and set the Component to ci-framework and the AssignedTeam to rhos-dfg-tooling.
Please provide the following information:
your environment (OS version,
ansible --version)commit hash of the ci-framework repository you’re using (
git log -1)your environment files (yes, all of them - you may want to ensure the security field of the issue is properly set to not leak internal data)
the command you issued
task name raising the error
the error itself (please use the internal pastebin if it’s too long)
In case of emergency, or if we didn’t come back to you in a reasonable time (expect a couple of days), you can ping us on our Slack channel.
Quickstart
Architecture
Reproducers
Baremetal
Development
Available plugins
- approve_csr – Automated approval of pending certificate requests in OCP.
- bridge_vlan – Attach VLAN ids to virtual network interfaces.
- cephx_key – Generate a random CephX authentication key
- crawl_n_mask – This module mask secrets in yaml/json/log files/dirs
- generate_make_tasks – Generate per Makefile target a dedicated task file
- get_makefiles_env – Recursively get Makefiles default variables.
- krb_request – Downloads/fetches the content of a SPNEGO secured URL
- pem_read – Reads a PEM file (that can list many certs)
- tempest_list_allowed – Parse filtered tests to tempest
- tempest_list_skipped – Parse skipped tests from tempest
Module utils
Available roles
- adoption_osp_deploy
- artifacts
- bm_sno
- build_containers
- build_openstack_packages
- cert_manager
- ci_dcn_site
- ci_gen_kustomize_values
- ci_local_storage
- ci_lvms_storage
- ci_multus
- ci_network
- ci_nmstate
- ci_setup
- cifmw_block_device
- cifmw_ceph_client
- cifmw_ceph_spec
- cifmw_cephadm
- CI Framework Create Admin
- cifmw_external_dns
- cifmw_helpers
- cifmw_nfs
- cifmw_ntp
- cifmw_setup
- cifmw_snr_nhc
- cifmw_test_role
- cleanup_openstack
- Compliance Role
- config_drive
- deploy_bmh
- devscripts
- discover_latest_image
- dlrn_promote
- dlrn_report
- dnsmasq
- edpm_build_images
- edpm_deploy
- edpm_deploy_baremetal
- edpm_kustomize
- edpm_prepare
- edpm_ssh_info
- env_op_images
- fdp_update_container_images
- fdp_update_edpm
- federation
- Fix Python encodings
- hci_prepare
- hive
- idrac_configuration
- install_ca
- install_openstack_ca
- install_yamls
- IPA
- krb_request
- kustomize_deploy
- libvirt_manager
- manage_secrets
- mirror_registry
- nat64_appliance
- networking_mapper
- openshift_adm
- openshift_login
- openshift_obs
- openshift_provisioner_node
- openshift_setup
- operator_build
- operator_deploy
- os_must_gather
- os_net_setup
- ovirt
- PCP Metrics
- pkg_build
- podman
- polarion
- radvd
- registry_deploy
- repo_setup
- Report portal
- reproducer
- rhol_crc
- run_hook
- set_openstack_containers
- shiftstack
- ssh_jumper
- sushy_emulator
- switch_config
- tempest
- test_deps
- Test operator
- tofu
- update
- update_containers
- validations
- virtualbmc