Helper tool for qontract-reconcile development
Project description
Qontract Development CLI
Qontract Development CLI supports your daily qontract-reconcile development work.
[toc]
Installation
You can install this library from PyPI with pip
:
python3 -m pip install qontract-development-cli
Or install it with pipx
:
pipx install qontract-development-cli
You can also use pipx
to run the library without installing it:
pipx run qontract-development-cli
Quickstart
-
Create initial configuration
qd config init
-
Create a profile
sql-query
to run thesql-query
integrationqd profile create sql-query
-
Run
sql-query
profileqd profile run dev sql-query
Features
Qontract Development CLI currently provides the following features (get help with -h
or --help
):
- Run
qontract-reconcile
andqontract-server
as docker containers on your local machine - Support for different App-Interface environments (dev, prod, ...) via the
env
command - Configure your qontract-reconcile integration with the
profile
command - Support pull request reviews (see
profile create
) - Bootstrap your initial configurations with the
config
command - Shell auto-completion (see
qd --help
) - Automatically restart
qontract-reconcile
container when files change - Automatically rebuild the App-Interface bundle and restart the
qontract-server
container when files change
Examples
Take a look at the examples directory for different profile examples.
Usage
The following sections describe all available commands and their options.
Config
Manage global qontract-development-cli configuration.
qd config [sub-cmd] --help
- edit: open the configuration file in your favorite editor
- init: create a default configuration
Global Settings
Key | Description | Default |
---|---|---|
debug | Enable/disable debug mode | false |
defaults_profile | Name of defaults profile | defaults |
docker_compose_project_name | Docker compose project name | qontract-development |
editor | Your favorite editor | $EDITOR or vim |
environments_dir | Directory to store environment files | User config directory / environments |
profiles_dir | Directory to store profile files | User config directory / profiles |
worktrees_dir | Directory to store git repo worktrees | User cache directory / worktrees |
Environments
An environment specifies app-interface instance settings, e.g., dev vs. prod config and path to the actual app-interface instance.
qd env [sub-cmd] --help
- edit: Create/edit an environment file in your editor.
- ls: List all available environments.
- rm: Remove environment.
- show: Display environment.
Environment Settings
Key | Description | Default |
---|---|---|
app_interface_path | Path to local app-interface instance | ~/workspace/app-interface |
app_interface_state_bucket | S3 bucket | empty |
app_interface_state_bucket_account | AWS S3 account | empty |
config | app-interface config | ~/workspace/qontract-reconcile/config.dev.toml |
gitlab_pr_submitter_queue_url | Gitlab pr submitter queue url | |
run_qontract_reconcile | Run qontract-reconcile container | true |
run_qontract_server | Run qontract-server container | true |
run_vault | Run vault container | false |
:point_right: Bold keys are mandatory or should be customized.
Profiles
A profile specifies all settings to run a qontract-reconcile integration (e.g., sql-query).
qd profile [sub-cmd] --help
-
create: Create a new profile to run an integration.
Supports the creation of a new profile from an open PR/MR. See
$ qd profile create --help
for all available options. -
edit: Edit a profile in your editor.
-
ls: List all available profiles.
-
rm: Remove profile.
-
run: Run a profile.
-
show: Display profile.
--no-dry-run
By default, qd
runs integrations in dry-run
mode if not explicitly specified differently in the profile config.
There is also a --no-dry-run
flag which lets you disable dry-run
mode from the command line.
qd profile run dev my-integration --no-dry-run
The command line flag takes precedence over any configuration you might have in the profile settings.
Profile Settings
Key | Description | Default |
---|---|---|
additional_environment | Dictionary of additional environment variables to pass to the qontract-reconcile container | {} |
container_uid | Change ownership of /recconcile files in container to this user id | current UID |
command | Command to run in the qontract-reconcile container. | dockerfiles/hack/run-integration.py |
command_extra_args | Additional arguments to pass to the command. | |
debugger | Python debugger | debugpy |
dry_run | Run --dry-run mode | true |
extra_hosts | List of 'HOSTNAME:IP' mapping entries for qontract-reconcile /etc/hosts . See extra_hosts docker compose file. |
[] |
integration_name | Intergration name | |
integration_extra_args | Intergration extra arguments | |
internal_redhat_ca | Inject Red Hat internal CAs and REQUESTS_CA_BUNDLE environment variable |
false |
log_level | Log level | info |
app_interface_path | App-interface instance path. (Overrides env.app_interface_path) | |
app_interface_pr | App-interface PR/MR number | |
app_interface_upstream | Upstream remote name | upstream |
qontract_reconcile_build_image | Build qontract-reconcile image | true |
qontract_reconcile_image | Qontract-reconcile image | quay.io/app-sre/qontract-reconcile:latest |
qontract_reconcile_path | Qontract-reconcile path | ~/workspace/qontract-reconcile |
qontract_reconcile_pr | Qontract-reconcile PR/MR number | |
qontract_reconcile_upstream | Upstream remote name | upstream |
qontract_server_build_image | Build qontract-server image | true |
qontract_server_image | Qontract-server image | quay.io/app-sre/qontract-server:lates t |
qontract_server_path | Qontract-server path | ~/workspace/qontract-server |
qontract_schemas_path | Qontract-schemas path | ~/workspace/qontract-schemas |
qontract_schemas_pr | Qontract-schemas PR/MR number | |
qontract_schemas_upstream | Upstream remote name | upstream |
run_once | If 'true', execute the integration once and exit | true |
sleep_duration_secs | If not run_once, sleep duration until integration runs again | 10 |
localstack | Run localstack container and set AWS related environment variables | false |
localstack_compose_file | Path to your Localstack docker-compose file | qontract_server_path / dev/localstack/docker-compose.yml |
skip_initial_make_bundle | Skip initial make bundle step | false |
:point_right: Bold keys are mandatory or should be customized.
PR/MR support
It's a pretty handy feature to create a profile from a pull request (merge request). E.g.:
qd profile create --app-interface PATH_TO_YOUR_LOCAL/app-interface-dev-data --app-interface-pr NUMBER --qontract-schemas-pr NUMBER --qontract-reconcile-pr NUMBER --integration-name glitchtip --integration-extra-args '' glitchtip-pr-check
Which results in this profile:
$ qd profile show glitchtip-pr-check
---
app_interface_path: PATH_TO_YOUR_LOCAL/app-interface-dev-data
app_interface_pr: NUMBER
integration_name: glitchtip
qontract_reconcile_pr: NUMBER
qontract_schemas_pr: NUMBER
Running this profile will:
- Create new git worktrees (see
config.worktrees_dir
) for app-interface-dev-data, qontract-schema, and qontract-reconcile PRs - Start the containers with the adapted path to these worktrees
- Restarting the profile will fetch PR updates
:point_right: A git worktree cleanup isn't implemented yet
Development
Release
- Bump the version in
pyproject.toml
- Update the
CHANGELOG.md
- Commit the changes
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for qontract_development_cli-0.15.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4249d6d2f133a447c83c7be5ec3cb39d35ad0c563c1f6ab57c503c10ca64e268 |
|
MD5 | 62b2238f371ac66186f66d60c73a110e |
|
BLAKE2b-256 | 2e23cf443d5171db2e956c3be1a4c433b656f0a12482ef3c47939c4015850353 |
Hashes for qontract_development_cli-0.15.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dca22afa278b202171b02bb853d96d37f3011dae793e07cbc1cd552dc1b11cf2 |
|
MD5 | 2e7dacee9ef92f7cb29f3c0ab0c775ff |
|
BLAKE2b-256 | e5e0b54aa8849787c5052e20a551632c85bd1138ddb3764ffea41bd01e6a77e5 |