61 lines
2 KiB
Markdown
61 lines
2 KiB
Markdown
# Forgejo end-to-end tests
|
|
|
|
A series of tests scenarios and assertions covering
|
|
[Forgejo](https://codeberg.org/forgejo/forgejo) and the [Forgejo
|
|
runner](https://code.forgejo.org/forgejo/runner). They partially rely
|
|
on [Forgejo actions](https://code.forgejo.org/actions) developped
|
|
specifically for testing such as
|
|
[setup-forgejo](https://code.forgejo.org/actions/setup-forgejo).
|
|
|
|
They are designed to run using Forgejo releases and development
|
|
versions compiled from designated repositories.
|
|
|
|
## Hacking
|
|
|
|
To run and debug workflows from `actions/example-*`, from the root of
|
|
the source directory, with docker and forgejo-curl.sh installed, mimic
|
|
what `.forgejo/workflows/actions.yml` does. There may be some manual
|
|
tweaking (such as creating temporary directories) because the tests
|
|
run as root in the context of Forgejo Actions and assume they have
|
|
admin permissions. But they do not need to run as root and must work
|
|
fine when run as a regular user.
|
|
|
|
### Prepare the Forgejo instance and the runner
|
|
|
|
```sh
|
|
git clone https://code.forgejo.org/actions/setup-forgejo
|
|
export PATH=$(pwd)/setup-forgejo:$PATH
|
|
git clone https://code.forgejo.org/forgejo/end-to-end
|
|
cd end-to-end
|
|
export DIR=/tmp/end-to-end
|
|
```
|
|
|
|
Run one example
|
|
|
|
```sh
|
|
actions/run.sh https://codeberg.org/forgejo-experimental/forgejo/releases/download/v1.22.0-test/forgejo-1.22.0-test-linux-amd64 v1_22 cron # runs actions/example-cron
|
|
```
|
|
|
|
Cleanup
|
|
|
|
```sh
|
|
actions/run.sh https://codeberg.org/forgejo-experimental/forgejo/releases/download/v1.22.0-test/forgejo-1.22.0-test-linux-amd64 v1_22 none
|
|
```
|
|
|
|
Run all examples for v1_22
|
|
|
|
```sh
|
|
actions/run.sh https://codeberg.org/forgejo-experimental/forgejo/releases/download/v1.22.0-test/forgejo-1.22.0-test-linux-amd64 v1_22
|
|
```
|
|
|
|
### Remote testing
|
|
|
|
To reduce the runtime the following variables can be set to control
|
|
the number of cases run by the
|
|
[actions](.forgejo/workflows/actions.yml) tests. If set to
|
|
**none** they are not run at all for that version of Forgejo. If
|
|
it does not exist, all tests are run.
|
|
|
|
* `V1_22_TESTS`
|
|
* `V1_21_TESTS`
|
|
* `V1_20_TESTS`
|