mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-11-08 18:04:14 +01:00
Update integration test README
and remove outdated chinese version
This commit is contained in:
parent
6149f0de7c
commit
d06da0d9c6
2 changed files with 36 additions and 91 deletions
|
@ -1,5 +1,23 @@
|
||||||
# Integration tests
|
# Integration tests
|
||||||
|
|
||||||
|
Thank you for your effort to provide good software tests for Forgejo.
|
||||||
|
Please also read the general testing instructions in the
|
||||||
|
[Forgejo contributor documentation](https://forgejo.org/docs/next/contributor/testing/).
|
||||||
|
|
||||||
|
This file is meant to provide specific information for the integration tests
|
||||||
|
as well as some tips and tricks you should know.
|
||||||
|
|
||||||
|
Feel free to extend this file with more instructions if you feel like you have something to share!
|
||||||
|
|
||||||
|
|
||||||
|
## How to run the tests?
|
||||||
|
|
||||||
|
Before running any tests, please ensure you perform a clean build:
|
||||||
|
|
||||||
|
```
|
||||||
|
make clean build
|
||||||
|
```
|
||||||
|
|
||||||
Integration tests can be run with make commands for the
|
Integration tests can be run with make commands for the
|
||||||
appropriate backends, namely:
|
appropriate backends, namely:
|
||||||
```shell
|
```shell
|
||||||
|
@ -8,40 +26,39 @@ make test-pgsql
|
||||||
make test-mysql
|
make test-mysql
|
||||||
```
|
```
|
||||||
|
|
||||||
Make sure to perform a clean build before running tests:
|
|
||||||
```
|
|
||||||
make clean build
|
|
||||||
```
|
|
||||||
|
|
||||||
## Run tests via local act_runner
|
### Run tests via local forgejo runner
|
||||||
|
|
||||||
### Run all jobs
|
If you have a [forgejo runner](https://code.forgejo.org/forgejo/runner/),
|
||||||
|
you can use it to run the test jobs:
|
||||||
|
|
||||||
|
#### Run all jobs
|
||||||
|
|
||||||
```
|
```
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest
|
forgejo-runner exec -W .forgejo/workflows/testing.yml --event=pull_request
|
||||||
```
|
```
|
||||||
|
|
||||||
Warning: This file defines many jobs, so it will be resource-intensive and therefore not recommended.
|
Warning: This file defines many jobs, so it will be resource-intensive and therefore not recommended.
|
||||||
|
|
||||||
### Run single job
|
#### Run single job
|
||||||
|
|
||||||
```SHELL
|
```SHELL
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest -j <job_name>
|
forgejo-runner exec -W .forgejo/workflows/testing.yml --event=pull_request -j <job_name>
|
||||||
```
|
```
|
||||||
|
|
||||||
You can list all job names via:
|
You can list all job names via:
|
||||||
|
|
||||||
```SHELL
|
```SHELL
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest -l
|
forgejo-runner exec -W .forgejo/workflows/testing.yml --event=pull_request -l
|
||||||
```
|
```
|
||||||
|
|
||||||
## Run sqlite integration tests
|
### Run sqlite integration tests
|
||||||
Start tests
|
Start tests
|
||||||
```
|
```
|
||||||
make test-sqlite
|
make test-sqlite
|
||||||
```
|
```
|
||||||
|
|
||||||
## Run MySQL integration tests
|
### Run MySQL integration tests
|
||||||
Setup a MySQL database inside docker
|
Setup a MySQL database inside docker
|
||||||
```
|
```
|
||||||
docker run -e "MYSQL_DATABASE=test" -e "MYSQL_ALLOW_EMPTY_PASSWORD=yes" -p 3306:3306 --rm --name mysql mysql:latest #(just ctrl-c to stop db and clean the container)
|
docker run -e "MYSQL_DATABASE=test" -e "MYSQL_ALLOW_EMPTY_PASSWORD=yes" -p 3306:3306 --rm --name mysql mysql:latest #(just ctrl-c to stop db and clean the container)
|
||||||
|
@ -52,7 +69,7 @@ Start tests based on the database container
|
||||||
TEST_MYSQL_HOST=localhost:3306 TEST_MYSQL_DBNAME=test TEST_MYSQL_USERNAME=root TEST_MYSQL_PASSWORD='' make test-mysql
|
TEST_MYSQL_HOST=localhost:3306 TEST_MYSQL_DBNAME=test TEST_MYSQL_USERNAME=root TEST_MYSQL_PASSWORD='' make test-mysql
|
||||||
```
|
```
|
||||||
|
|
||||||
## Run pgsql integration tests
|
### Run pgsql integration tests
|
||||||
Setup a pgsql database inside docker
|
Setup a pgsql database inside docker
|
||||||
```
|
```
|
||||||
docker run -e "POSTGRES_DB=test" -p 5432:5432 --rm --name pgsql postgres:latest #(just ctrl-c to stop db and clean the container)
|
docker run -e "POSTGRES_DB=test" -p 5432:5432 --rm --name pgsql postgres:latest #(just ctrl-c to stop db and clean the container)
|
||||||
|
@ -62,7 +79,7 @@ Start tests based on the database container
|
||||||
TEST_PGSQL_HOST=localhost:5432 TEST_PGSQL_DBNAME=test TEST_PGSQL_USERNAME=postgres TEST_PGSQL_PASSWORD=postgres make test-pgsql
|
TEST_PGSQL_HOST=localhost:5432 TEST_PGSQL_DBNAME=test TEST_PGSQL_USERNAME=postgres TEST_PGSQL_PASSWORD=postgres make test-pgsql
|
||||||
```
|
```
|
||||||
|
|
||||||
## Running individual tests
|
### Running individual tests
|
||||||
|
|
||||||
Example command to run GPG test:
|
Example command to run GPG test:
|
||||||
|
|
||||||
|
@ -99,3 +116,8 @@ SLOW_FLUSH = 5S ; 5s is the default value
|
||||||
```bash
|
```bash
|
||||||
GITEA_SLOW_TEST_TIME="10s" GITEA_SLOW_FLUSH_TIME="5s" make test-sqlite
|
GITEA_SLOW_TEST_TIME="10s" GITEA_SLOW_FLUSH_TIME="5s" make test-sqlite
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Tips and tricks
|
||||||
|
|
||||||
|
If you know noteworthy tests that can act as an inspiration for new tests,
|
||||||
|
please add some details here.
|
||||||
|
|
|
@ -1,77 +0,0 @@
|
||||||
# 关于集成测试
|
|
||||||
|
|
||||||
使用如下 make 命令可以运行指定的集成测试:
|
|
||||||
```shell
|
|
||||||
make test-mysql
|
|
||||||
make test-pgsql
|
|
||||||
make test-sqlite
|
|
||||||
```
|
|
||||||
|
|
||||||
在执行集成测试命令前请确保清理了之前的构建环境,清理命令如下:
|
|
||||||
```
|
|
||||||
make clean build
|
|
||||||
```
|
|
||||||
|
|
||||||
## 如何在本地 act_runner 上运行测试
|
|
||||||
|
|
||||||
### 运行所有任务
|
|
||||||
|
|
||||||
```
|
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest
|
|
||||||
```
|
|
||||||
|
|
||||||
警告:由于在此文件中定义了许多任务,因此此操作将花费太多的CPU和内存来运行。所以不建议这样做。
|
|
||||||
|
|
||||||
### 运行单个任务
|
|
||||||
|
|
||||||
```SHELL
|
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest -j <job_name>
|
|
||||||
```
|
|
||||||
|
|
||||||
您可以通过以下方式列出所有任务名称:
|
|
||||||
```SHELL
|
|
||||||
act_runner exec -W ./.github/workflows/pull-db-tests.yml --event=pull_request --default-actions-url="https://github.com" -i catthehacker/ubuntu:runner-latest -l
|
|
||||||
```
|
|
||||||
|
|
||||||
## 如何使用 sqlite 数据库进行集成测试
|
|
||||||
使用该命令执行集成测试
|
|
||||||
```
|
|
||||||
make test-sqlite
|
|
||||||
```
|
|
||||||
|
|
||||||
## 如何使用 mysql 数据库进行集成测试
|
|
||||||
首先在docker容器里部署一个 mysql 数据库
|
|
||||||
```
|
|
||||||
docker run -e "MYSQL_DATABASE=test" -e "MYSQL_ALLOW_EMPTY_PASSWORD=yes" -p 3306:3306 --rm --name mysql mysql:8 #(just ctrl-c to stop db and clean the container)
|
|
||||||
```
|
|
||||||
之后便可以基于这个数据库进行集成测试
|
|
||||||
```
|
|
||||||
TEST_MYSQL_HOST=localhost:3306 TEST_MYSQL_DBNAME=test TEST_MYSQL_USERNAME=root TEST_MYSQL_PASSWORD='' make test-mysql
|
|
||||||
```
|
|
||||||
|
|
||||||
## 如何使用 pgsql 数据库进行集成测试
|
|
||||||
同上,首先在 docker 容器里部署一个 pgsql 数据库
|
|
||||||
```
|
|
||||||
docker run -e "POSTGRES_DB=test" -p 5432:5432 --rm --name pgsql postgres:14 #(just ctrl-c to stop db and clean the container)
|
|
||||||
```
|
|
||||||
之后便可以基于这个数据库进行集成测试
|
|
||||||
```
|
|
||||||
TEST_PGSQL_HOST=localhost:5432 TEST_PGSQL_DBNAME=test TEST_PGSQL_USERNAME=postgres TEST_PGSQL_PASSWORD=postgres make test-pgsql
|
|
||||||
```
|
|
||||||
|
|
||||||
## 如何进行自定义的集成测试
|
|
||||||
|
|
||||||
下面的示例展示了怎样在集成测试中只进行 GPG 测试:
|
|
||||||
|
|
||||||
sqlite 数据库:
|
|
||||||
|
|
||||||
```
|
|
||||||
make test-sqlite#GPG
|
|
||||||
```
|
|
||||||
|
|
||||||
其它数据库 (用 PGSQL 取代 MYSQL):
|
|
||||||
|
|
||||||
```
|
|
||||||
TEST_MYSQL_HOST=localhost:1433 TEST_MYSQL_DBNAME=test TEST_MYSQL_USERNAME=sa TEST_MYSQL_PASSWORD=MwantsaSecurePassword1 make test-mysql#GPG
|
|
||||||
```
|
|
||||||
|
|
Loading…
Reference in a new issue