https://github.com/redhatcre/znoyder
Automate preparation of downstream CI jobs for Red Hat OpenStack Platform (OSP) releases.
https://github.com/redhatcre/znoyder
openstack osp python zuul
Last synced: about 1 year ago
JSON representation
Automate preparation of downstream CI jobs for Red Hat OpenStack Platform (OSP) releases.
- Host: GitHub
- URL: https://github.com/redhatcre/znoyder
- Owner: RedHatCRE
- License: apache-2.0
- Created: 2021-11-12T10:27:57.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-11T10:54:59.000Z (over 1 year ago)
- Last Synced: 2025-03-28T22:51:10.913Z (about 1 year ago)
- Topics: openstack, osp, python, zuul
- Language: Python
- Homepage:
- Size: 337 KB
- Stars: 8
- Watchers: 4
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Znoyder
The goal of this project is to automate preparation of downstream CI jobs
for Red Hat OpenStack Platform (OSP) releases.
The name `znoyder` is a play of Silesian word *znojdywacz* and its English
meaning (*finder*).
# Usage examples
Below are the examples of the tool usage.
The basic usage involves a valid subcommand and additional options to it.
For further details, the standard `--help` shall guide you.
## browse-osp
This command can be used to explore the **ospinfo** data.
To view existing components:
```
znoyder browse-osp components
```
There is a basic filtering implemented that allows to limit and narrow results,
for example to a specific release, project or component – for `packages` subcommand.
It is also possible to select only certain fields as result, using the `--output` option.
To list URLs to repositories of packages that belong to network component:
```
znoyder browse-osp packages --component network --tag osp-17.0 --output osp-patches
```
There is an additional key `osp-project` introduced that contains downstream repository name:
```
znoyder browse-osp packages --output osp-project
```
There exists the `--debug` option which will display raw dictionary as output.
It can be useful to find fields (key names) for `--output` option.
```
znoyder browse-osp releases --debug
```
## download
This command allows fetching the Zuul configuration, if there is any,
from a given repository and its branch.
```
znoyder download --repo https://opendev.org/openstack/nova --branch master --destination zuul-config-files/
```
## find-jobs
It allows investigating details of Zuul configuration that is available
in the local path.
To get list of jobs and templates defined for a particular project
and specified Zuul pipelines, simply execute:
```
znoyder find-jobs --dir path/to/nova --base /path/to/templates/openstack-zuul-jobs --pipeline check,gate
```
There exists the `-v` option for getting a verbose output with many details.
## templates
Calling this command will produce a list of available templates.
```
znoyder templates
```
## generate
This command can be used to download Zuul upstream configuration for a given
OSP release and component (optional filtering), then process it and produce
new configuration files, crafted for downstream OSP testing.
```
znoyder generate --tag osp-17.0 --component network
```
# Tests
Call `tox` to run the default test suite in this repository.