Merge pull request #80 from owncloud/testDocu

[Tests-only] documentation about running oC10 API tests
2020-02-12 17:07:15 +05:45
parent 55250add45 0120b80706
commit e5ec269522
1 changed files with 55 additions and 0 deletions
@@ -67,6 +67,61 @@ richard:superfluidity

 For details on the `json` and `ldap` backends see the [documentation](https://owncloud.github.io/ocis-reva/#users)

+## Run oC10 API acceptance tests
+1.  start an LDAP server e.g. with docker:
+    ```
+    docker run --hostname ldap.my-company.com \
+        -e LDAP_TLS_VERIFY_CLIENT=never \
+        -e LDAP_DOMAIN=owncloud.com \
+        -e LDAP_ORGANISATION=ownCloud \
+        -e LDAP_ADMIN_PASSWORD=admin \
+        --name docker-slapd \
+        -p 127.0.0.1:389:389 \
+        -p 636:636 -d osixia/openldap
+    ```
+
+2.  clone oC10 code: `git clone https://github.com/owncloud/core.git`
+
+3.  start reva with `REVA_USERS_DRIVER=ldap`:
+    ```
+    bin/ocis-reva gateway & \
+    REVA_USERS_DRIVER=ldap bin/ocis-reva users & \
+    REVA_USERS_DRIVER=ldap bin/ocis-reva auth-basic & \
+    bin/ocis-reva auth-bearer & \
+    bin/ocis-reva sharing & \
+    bin/ocis-reva storage-root & \
+    REVA_STORAGE_HOME_EXPOSE_DATA_SERVER=1 bin/ocis-reva storage-home & \
+    bin/ocis-reva storage-home-data & \
+    REVA_STORAGE_OC_EXPOSE_DATA_SERVER=1 bin/ocis-reva storage-oc & \
+    bin/ocis-reva storage-oc-data & \
+    bin/ocis-reva frontend
+    ```
+
+4.  from inside the oC10 repo run the tests:
+    ```
+    make test-acceptance-api \
+        TEST_SERVER_URL=http://localhost:9140 \
+        TEST_EXTERNAL_USER_BACKENDS=true \
+        TEST_OCIS=true \
+        OCIS_REVA_DATA_ROOT=/var/tmp/reva/ \
+        BEHAT_FILTER_TAGS='~@skipOnOcis&&@TestAlsoOnExternalUserBackend&&~@skipOnLDAP'
+    ```
+
+    Make sure to adjust the settings `TEST_SERVER_URL` and `OCIS_REVA_DATA_ROOT` according to your environment
+
+    This will run all tests that can work with LDAP and are not skipped on OCIS
+    To run a subset of tests, e.g. a single suite, file or tag have a look at the [acceptance tests documentation](https://doc.owncloud.com/server/10.0/developer_manual/core/acceptance-tests.html#running-acceptance-tests-for-a-suite).
+    E.g. you can run all tests that are marked with a specific issue:
+    ```
+    make test-acceptance-api \
+        TEST_SERVER_URL=http://localhost:9140 \
+        TEST_EXTERNAL_USER_BACKENDS=true \
+        TEST_OCIS=true \
+        OCIS_REVA_DATA_ROOT=/var/tmp/reva/ \
+        BEHAT_FILTER_TAGS='@TestAlsoOnExternalUserBackend&&~@skipOnLDAP&&@issue-ocis-reva-46'
+    ```
+
+    Note that the `~@skipOnOcis` tag is removed here, because to fix an issue you want also to run the tests that are skipped in the CI run

 ## Security