add doc for running parallel deployment acceptance tests locally

This commit is contained in:
Saw-jan
2022-02-08 12:44:20 +05:45
parent 2417f29f7b
commit 8cc3c01285

View File

@@ -166,3 +166,50 @@ If you want to work on a specific issue
5. go back to 2. and repeat till the tests are passing.
6. remove those tests from the expected failures file
7. make a PR that has the fixed code, and the relevant lines removed from the expected failures file.
## Running tests for parallel deployment
### Setup the parallel deployment environment
Instruction on setup is available [here](https://owncloud.dev/ocis/deployment/oc10_ocis_parallel/#local-setup)
Start the docker stack with the following command:
```bash
PROXY_ENABLE_BASIC_AUTH=true docker-compose up -d
```
**NOTE**: `PROXY_ENABLE_BASIC_AUTH=true` is required as the tests use basic auth.
### Getting the test helpers
All the test helpers are located in the core repo.
```bash
git clone https://github.com/owncloud/core.git
```
### Run the acceptance tests
Run the acceptance tests with the following command from the root of the oCIS repository:
```bash
make test-paralleldeployment-api \
TEST_SERVER_URL="https://cloud.owncloud.test" \
TEST_OC10_URL="http://localhost:8080" \
TEST_PARALLEL_DEPLOYMENT=true \
TEST_OCIS=true \
TEST_WITH_LDAP=true \
PATH_TO_CORE="<path_to_core>" \
SKELETON_DIR="<path_to_core>/apps/testing/data/apiSkeleton"
```
Replace `<path_to_core>` with the actual path to the root directory of core repo that you have cloned earlier.
In order to run a single test, use `BEHAT_FEATURE` environment variable.
```bash
make test-paralleldeployment-api \
... \
BEHAT_FEATURE="tests/parallelDeployAcceptance/features/apiShareManagement/acceptShares.feature"
```