5b677e1536
Adding support to dump docker-compose logs if unhealthy containers found. |
||
---|---|---|
.. | ||
example | ||
helpers | ||
ldap | ||
rbac | ||
README.md | ||
regression.py | ||
runner |
ClickHouse Tests in TestFlows
This directory contains integration tests written using TestFlows that involves several ClickHouse instances, custom configs, ZooKeeper, etc.
Supported environment
Prerequisites
Running tests locally
You can run tests locally by passing --local
and --clickhouse-binary-path
to the regression.py
.
--local
specifies that regression will be run locally--clickhouse-binary-path
specifies the path to the ClickHouse binary that will be used during the regression run
Note: you can pass
-h
or--help
argument to theregression.py
to see a help message.python3 regression.py -h
Note: make sure that the ClickHouse binary has correct permissions. If you are using
/usr/bin/clickhouse
its owner and group is set toroot:root
by default and it needs to be changed toclickhouse:clickhouse
. You can change the owner and the group using the following command.sudo chown clickhouse:clickhouse /usr/bin/clickhouse
Using the default ClickHouse installation and its server binary at /usr/bin/clickhouse
, you can run
regressions locally using the following command.
python3 regression.py --local --clickhouse-binary-path "/usr/bin/clickhouse"
Output Verbosity
You can control verbosity of the output by specifying the output format with -o
or --output
option.
See --help
for more details.
Running Only Selected Tests
You can run only the selected tests by passing --only
option to the regression.py
.
For example,
./regression.py --local --clickhouse-binary-path /usr/bin/clickhouse --only "/clickhouse/rbac/syntax/grant privilege/*"
will execute all rbac/syntax/grant privilege
tests.
If you want to run only a single test such as the /clickhouse/rbac/syntax/grant privilege/grant privileges/privilege='KILL QUERY', on=('*.*',), allow_introspection=False
you can do it as follows
./regression.py --local --clickhouse-binary-path /usr/bin/clickhouse --only "/clickhouse/rbac/syntax/grant privilege/grant privileges/privilege='KILL QUERY', on=('[*].[*]',), allow_introspection=False/*"
Note that you need to surround special characters such as
*
with square brackets, for example[*]
.
Note that you need to end the filtering pattern with
/*
to run all the steps inside the test.
For more information, please see Filtering section in the TestFlows Handbook.