History

João Oliveirinha f686da832f TUN-7275: Make QuickTunnels only use a single connection to the edge		1 week ago
..
.gitignore	TUN-4055: Skeleton for component tests	2 years ago
README.md	TUN-5680: Adapt component tests for new service install based on token	1 year ago
cli.py	TUN-6010: Add component tests for --edge-ip-version	9 months ago
config.py	TUN-7259: Add warning for missing ingress rules	2 weeks ago
conftest.py	TUN-7259: Add warning for missing ingress rules	2 weeks ago
constants.py	TUN-7245: Add bastion flag to origin service check	2 weeks ago
requirements.txt	TUN-4125: Change component tests to run in CI with its own dedicated resources	2 years ago
setup.py	TUN-4125: Change component tests to run in CI with its own dedicated resources	2 years ago
test_config.py	TUN-4050: Add component tests to assert reconnect behavior	2 years ago
test_edge_discovery.py	TUN-6010: Add component tests for --edge-ip-version	9 months ago
test_logging.py	TUN-6741: ICMP proxy tries to listen on specific IPv4 & IPv6 when possible	6 months ago
test_pq.py	TUN-6810: Add component test for post-quantum	6 months ago
test_proxy_dns.py	TUN-7065: Remove classic tunnel creation	2 months ago
test_quicktunnels.py	TUN-7275: Make QuickTunnels only use a single connection to the edge	1 week ago
test_reconnect.py	TUN-7065: Remove classic tunnel creation	2 months ago
test_service.py	TUN-6010: Add component tests for --edge-ip-version	9 months ago
test_termination.py	TUN-5600: Add coverage to component tests for various transports	1 year ago
test_token.py	TUN-5915: New cloudflared command to allow to retrieve the token credentials for a Tunnel	1 year ago
test_tunnel.py	TUN-7271: Return 503 status code when no ingress rules configured	2 weeks ago
util.py	TUN-7245: Add bastion flag to origin service check	2 weeks ago

README.md

Requirements

Python 3.7 or later with packages in the given requirements.txt
- E.g. with conda:
- conda create -n component-tests python=3.7
- conda activate component-tests
- pip3 install -r requirements.txt
Create a config yaml file, for example:

cloudflared_binary: "cloudflared"
tunnel: "3d539f97-cd3a-4d8e-c33b-65e9099c7a8d"
credentials_file: "/Users/tunnel/.cloudflared/3d539f97-cd3a-4d8e-c33b-65e9099c7a8d.json"
classic_hostname: "classic-tunnel-component-tests.example.com"
origincert: "/Users/tunnel/.cloudflared/cert.pem"
ingress:
- hostname: named-tunnel-component-tests.example.com
  service: hello_world
- service: http_status:404

Route hostname to the tunnel. For the example config above, we can do that via

   cloudflared tunnel route dns 3d539f97-cd3a-4d8e-c33b-65e9099c7a8d named-tunnel-component-tests.example.com

Turn on linter If you are using Visual Studio, follow https://code.visualstudio.com/docs/python/linting to turn on linter.
Turn on formatter If you are using Visual Studio, follow https://code.visualstudio.com/docs/python/editing#_formatting to turn on formatter and https://marketplace.visualstudio.com/items?itemName=cbrevik.toggle-format-on-save to turn on format on save.
If you have cloudflared running as a service on your machine, you can either stop the service or ignore the service tests via --ignore test_service.py

How to run

Specify path to config file via env var COMPONENT_TESTS_CONFIG. This is required.

All tests

Run pytest inside this(component-tests) folder

Specific files

Run pytest <file 1 name>.py <file 2 name>.py

Specific tests

Run pytest file.py -k <test 1 name> -k <test 2 name>

Live Logging

Running with -o log_cli=true outputs logging to CLI as the tests are. By default the log level is WARN. --log-cli-level control logging level. For example, to log at info level, run pytest -o log_cli=true --log-cli-level=INFO. See https://docs.pytest.org/en/latest/logging.html#live-logs for more documentation on logging.