cs-codex-dist-tests/docs/Continuous-Tests.md

Continuous Tests

1. Description
2. Prerequisites
3. Run tests
4. Analyze logs

Description

Continuous Tests were developed to perform long lasting tests in different configurations and topologies. Unlike Distributed Tests, they are running continuously, until we stop them manually. Such approach is very useful to detect the issues which may appear over the time when we may have blocking I/O, unclosed pools/connections and etc.

Usually, we are running Continuous Tests manually and for automated runs, please refer to the Tests automation.

We have two projects in the repository

• CodexNetDeployer - Prepare environment to run the tests
• ContinuousTests - Continuous Tests

And they are used to prepare environment and run Continuous Tests.

Prerequisites

1. Kubernetes cluster, to run the tests
2. kubeconfig file, to access the cluster
3. kubectl installed, to create resources in the cluster
4. Optional - OpenLens installed, to browse cluster resources

Run tests

1. Create a Pod in the cluster, in the default namespace and consider to use your own value for metadata.name

   tests-runner.yaml

   ---
   apiVersion: v1
   kind: Pod
   metadata:
     name: tests-runner
     namespace: default
     labels:
       name: manual-run
   spec:
     containers:
     - name: runner
       image: mcr.microsoft.com/dotnet/sdk:8.0
       env:
       - name: KUBECONFIG
         value: /opt/kubeconfig.yaml
     #   volumeMounts:
     #   - name: kubeconfig
     #     mountPath: /opt/kubeconfig.yaml
     #     subPath: kubeconfig.yaml
     #   - name: logs
     #     mountPath: /var/log/codex-dist-tests
       command: ["sleep", "infinity"]
     # volumes:
     #   - name: kubeconfig
     #     secret:
     #       secretName: codex-dist-tests-app-kubeconfig
     #   - name: logs
     #     hostPath:
     #       path: /var/log/codex-dist-tests
   

   kubectl apply -f tests-runner.yaml
   

2. Copy kubeconfig to the runner Pod using the name you set in the previous step

   kubectl cp ~/.kube/codex-dist-tests.yaml tests-runner:/opt/kubeconfig.yaml
   

3. Exec into the runner Pod using the name you set in the previous step

   # kubectl
   kubectl exec -it tests-runner -- bash
   
   # OpenLens
   OpenLens --> Pods --> dist-tests-runner --> "Press on it" --> Pod Shell
   

4. Install required packages

   apt update
   apt install -y tmux vim
   

5. Clone Continuous Tests repository

   tmux
   
   cd /opt
   git clone https://github.com/codex-storage/cs-codex-dist-tests.git
   

6. Run CodexNetDeployer

   # Usually take ~ 10 minutes
   cd cs-codex-dist-tests/Tools/CodexNetDeployer
   
   # Adjust values
   vi deploy-continuous-testnet.sh
   
   # Deploy Codex Netwotk
   export RUNID=$(date +%Y%m%d-%H%M%S)
   bash deploy-continuous-testnet.sh
   

7. Run ContinuousTests

   cd ../../Tests/CodexContinuousTests
   cp ../../Tools/CodexNetDeployer/codex-deployment.json .
   
   # Adjust values
   vi run.sh
   
   # Run tests
   bash run.sh
   

8. Tmux sessions

   # Detach
   Ctrl + b --> d
   
   # List
   tmux ls
   
   # Attach
   tmux a -t 0
   

Analyze logs

We should check the logs in the /opt/cs-codex-dist-tests/Tests/CodexContinuousTests/logs folder