Skip to content

Commit 78133b9

Browse files
committed
docs: add docs for running test on kubernetes
1 parent 7bae839 commit 78133b9

File tree

1 file changed

+74
-3
lines changed

1 file changed

+74
-3
lines changed

docs/ocis/development/testing.md

Lines changed: 74 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -532,7 +532,7 @@ WEB_UI_CONFIG_FILE="tests/config/local/ocis-web.json" \
532532
ocis/bin/ocis server
533533
```
534534

535-
The first oCIS instance should be available at: https://localhost:9200/
535+
The first oCIS instance should be available at: <https://localhost:9200/>
536536

537537
### Setup Second oCIS Instance
538538

@@ -552,7 +552,7 @@ source tests/config/local/.env-federation && ocis/bin/ocis init
552552
ocis/bin/ocis server
553553
```
554554

555-
The second oCIS instance should be available at: https://localhost:10200/
555+
The second oCIS instance should be available at: <https://localhost:10200/>
556556

557557
{{< hint info >}}
558558
To enable ocm in the web interface, you need to set the following envs:
@@ -589,6 +589,77 @@ The sample `fontsMap.json` file is located in `tests/config/drone/fontsMap.json`
589589
}
590590
```
591591

592+
## Running Test on helm setup
593+
594+
Clone the [`ocis-charts`](https://github.com/owncloud/ocis-charts/) repository.
595+
596+
Install [k3d](https://k3d.io/stable/#install-script)
597+
Install [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
598+
Install [helm](https://helm.sh/docs/intro/install/)
599+
600+
1. Setup Basicauth
601+
602+
```bash
603+
cd ocis-charts
604+
# Enable basic auth in proxy deployment
605+
sed -i '/- name: PROXY_HTTP_ADDR/i\
606+
- name: PROXY_ENABLE_BASIC_AUTH\
607+
value: "true"' ./charts/ocis/templates/proxy/deployment.yaml
608+
# copy authbasic service
609+
cp -r <path-to-ocis-repo>/tests/config/drone/k3s/authbasic ./charts/ocis/templates/
610+
cp <path-to-ocis-repo>/tests/config/drone/k3s/values.yaml charts/charts/ocis/ci/deployment-values.yaml
611+
sed -i '/{{- $_ := set .scope "appNameAuthMachine" "authmachine" -}}/a\ {{- $_ := set .scope "appNameAuthBasic" "authbasic" -}}' ./charts/ocis/templates/_common/_tplvalues.tpl
612+
```
613+
614+
2. Install charts using k3d
615+
616+
```bash
617+
k3d cluster create drone --api-port ocis.owncloud.test:33199 -p '80:80@loadbalancer' -p '443:443@loadbalancer' --k3s-arg '--tls-san=k3d@server:*' --k3s-arg '--disable=metrics-server@server:*'
618+
k3d kubeconfig get drone > kubeconfig.yaml
619+
chmod 0600 kubeconfig.yaml
620+
kubectl create configmap coredns-custom --namespace kube-system --from-literal='rewritehost.override=rewrite name exact ocis.owncloud.test host.k3d.internal'
621+
kubectl -n kube-system rollout restart deployment coredns
622+
make helm-install-atomic
623+
```
624+
625+
3. Run test
626+
```bash
627+
cd ../ocis
628+
K3D=true TEST_SERVER_URL="ocis-server" make test-acceptance-api BEHAT_FEATURE=tests/acceptance/features/apiArchiver/downloadById.feature
629+
```
630+
4. Run Test With ociswrapper
631+
```bash
632+
ociswrapper serve --url https://ocis-server --admin-username admin --admin-password admin --skip-ocis-run
633+
```
634+
5. Run Antivirus Test
635+
To run clamav service run these command deploying the helm chart
636+
```bash
637+
cp -r config/drone/k8s/clamav charts/ocis/templates/
638+
sed -i 's/{{ *\.Values\.features\.virusscan\.infectedFileHandling *| *quote *}}/"delete"/' ocis/templates/antivirus/deployment.yaml
639+
sed -i 's/{{ *\.Values\.features\.virusscan\.infectedFileHandling *| *quote *}}/"delete"/' ocis/templates/antivirus/deployment.yaml
640+
sed -i '/name: ANTIVIRUS_SCANNER_TYPE/{n;s/value: *"icap"/value: "clamav"/}' charts/ocis/templates/antivirus/deployment.yaml
641+
sed -i '/- name: ANTIVIRUS_SCANNER_TYPE/i\ - name: ANTIVIRUS_CLAMAV_SOCKET\n value: "tcp://clamav:3310"' charts/ocis/templates/antivirus/deployment.yaml
642+
```
643+
6. Run Email Test
644+
To run email service run these command deploying the helm chart
645+
```bash
646+
cp -r <path-to-ocis-repo>/tests/config/drone/k8s/mailpit charts/ocis/templates/
647+
```
648+
After ocis is deployed
649+
```bash
650+
kubectl port-forward svc/mailpit EMAIL_PORT:8025 -n ocis
651+
```
652+
7. Run Authapp Test
653+
To run authapp service run these command deploying the helm chart
654+
```bash
655+
cp -r <path-to-ocis-repo>/tests/config/drone/k8s/mailpit charts/ocis/templates/
656+
```
657+
8. Run Tika Test
658+
To run tika service run these command deploying the helm chart
659+
```bash
660+
cp -r <path-to-ocis-repo>/tests/config/drone/k8s/tika charts/ocis/templates/
661+
```
662+
592663
## Generating Code Coverage Report by Running Acceptance Tests
593664

594665
To find out what oCIS code is covered by the API tests, first create a debug build of oCIS.
@@ -623,4 +694,4 @@ You can also view the report in a web UI using the following command.
623694
go tool cover -html=cov.txt
624695
```
625696

626-
This command should open a browser with the code report.
697+
This command should open a browser with the code report.

0 commit comments

Comments
 (0)