How to Test¶
GraphScope is comprised of three engines targeting for different business scenario, and a coordinator that could bring them together, and a client for users to connect and perform various tasks.
We already covered how to test for engines in
Here in this guide we will focus on how to do the e2e test, where multiple engines will working together.
Test GraphScope on local¶
Dev Environment¶
Here we would use a prebuilt docker image with necessary dependencies installed.
docker run --name dev -it --shm-size=4096m registry.cn-hongkong.aliyuncs.com/graphscope/graphscope-dev:latest
Please refer to Dev Environment to find more options to get a dev environment.
Build All Targets for GraphScope¶
With gs command-line utility, you can build all targets for GraphScope with a single command.
python3 gsctl.py make install
Run tests¶
Run a bunch of test cases that involves 3 engines
python3 gsctl.py test e2e --local
Test GraphScope on Kubernetes cluster¶
Make sure you have docker installed.
Build images¶
python3 gsctl.py make-image all
Executing this command will generate the corresponding images for each component.
It would produce a couple of images like this
Images of GraphScope¶
Or you could choose to generate image for a specific component. For example
python3 gsctl.py make-image analytical
Try python3 gsctl.py make-image -h for more available options.
Prepare a Kubernetes cluster¶
Please refer to Prepare a kubernetes cluster to get a cluster if you doesn’t have one.
Run tests¶
The tests would launch a couple of pods on your cluster, so you need to set appropriate environment variables to let it use your newly built image.
Take our previous built image for example, which has an empty registry (or you could say it’s docker.io by default), and tagged latest
python3 gsctl.py test e2e --k8s --registry="docker.io" --tag="latest"