mirror of
https://github.com/maxlerebourg/crowdsec-bouncer-traefik-plugin.git
synced 2026-07-21 19:48:59 +02:00
mhx
900c7ebdc2
Add tests/e2e/ structure with shared bash helpers and the first scenario (stream-mode): spin up real Traefik + Crowdsec via docker compose, mount the repo as a local plugin, add a ban via cscli, verify the bouncer blocks the matching X-Forwarded-For, then delete the decision and verify pass-through. Adds .github/workflows/e2e.yml with one matrix job per scenario (stream-mode for now), and Makefile targets `e2e` and `e2e_<scenario>` for local runs. Refs #328
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# End-to-end test suite
|
|
|
|
These tests spin up real Traefik + Crowdsec containers and exercise the
|
|
plugin in the same conditions Traefik uses in production: loaded from a
|
|
local path, no module download, no mocking.
|
|
|
|
Each scenario lives in its own directory under `scenarios/` and owns:
|
|
|
|
- `docker-compose.yml` — the stack to spin up
|
|
- `run.sh` — orchestration + assertions
|
|
- optional fixtures (`acquis.yaml`, `ban.html`, ...)
|
|
|
|
## Running locally
|
|
|
|
Prerequisites: `docker`, `docker compose`, `curl`, `bash`.
|
|
|
|
Run a single scenario:
|
|
|
|
```bash
|
|
./tests/e2e/scenarios/stream-mode/run.sh
|
|
# or
|
|
make e2e_stream-mode
|
|
```
|
|
|
|
Run everything:
|
|
|
|
```bash
|
|
make e2e
|
|
```
|
|
|
|
Each scenario uses an isolated Docker Compose project (`-p e2e-<scenario>`),
|
|
so multiple scenarios can run in parallel without colliding on container
|
|
names — except for the `crowdsec` container, which keeps its canonical
|
|
name so `cscli` commands work uniformly across scenarios. Run scenarios
|
|
serially if you need to invoke them on the same host at the same time.
|
|
|
|
## Writing a new scenario
|
|
|
|
1. Copy `scenarios/stream-mode/` as a template.
|
|
2. Rename `container_name`s (keep `crowdsec` for the LAPI container).
|
|
3. Edit `run.sh` to express the behavior under test.
|
|
4. Add the scenario name to the `matrix` in `.github/workflows/e2e.yml`
|
|
and to `E2E_SCENARIOS` in the `Makefile`.
|
|
|
|
## CI
|
|
|
|
`.github/workflows/e2e.yml` runs one parallel job per scenario on every
|
|
PR and push to `main`. On failure, container logs are uploaded as an
|
|
artifact named `logs-<scenario>`.
|