lambdatest/hyperexecute repository overview

⁠LambdaTest Hyperexecute

Official docker image for LambdaTest⁠ Hyperexecute.

⁠Version

docker run -it lambdatest/hyperexecute:latest ./hyperexecute --version

⁠Help

docker run -it lambdatest/hyperexecute:latest ./hyperexecute --help

⁠Usage

Below steps are mentioned explaining on how to run jobs via hyperexecute image. For reference this sample project is referred: https://github.com/LambdaTest/junit-selenium-hyperexecute-sample⁠

⁠Trigger job from the host machine by mounting root working directory of project

docker run -v "$(pwd)":/<your_work_dir_name> -it lambdatest/hyperexecute:latest ./hyperexecute --user <your_user_name> --key <your_access_key> --config /<your_work_dir_name>/<your_yaml_file_name> -t /<your_work_dir_name>

• As per the above command, current root working dir of the project is mounted to /<your_work_dir_name> directory inside the container.
• With --config flag, absolute path of hyperexecute config file is provided which in this case is /<your_work_dir_name>/<your_yaml_file_name>
• With -t, target directory is provided where test scripts are present which in this case is /<your_work_dir_name>

For example:

• Clone a sample project and change directory

git clone https://github.com/LambdaTest/junit-selenium-hyperexecute-sample.git && cd junit-selenium-hyperexecute-sample

• Trigger job like below:

docker run -v "$(pwd)":/junit-selenium-hyperexecute-sample -it lambdatest/hyperexecute:latest ./hyperexecute --user {{user_name}} --key {{access_key}} --config /junit-selenium-hyperexecute-sample/hyperexecute.yaml -t /junit-selenium-hyperexecute-sample

⁠Create custom image by using lambdatest/hyperexecute as base image

• Custom image can also be created by using lambdatest/hyperexecute image as base image. Below is one attached sample of Dockerfile for creating custom image

FROM lambdatest/hyperexecute:latest
CMD ["hyperexecute", "--user", "<your_user_name>", "--key", "<your_access_key>", "--config", "/<your_work_dir_name>/<your_yaml_file_name>", "-t", "/<your_work_dir_name>"]

• Save above file as Dockerfile and build custom image as:

docker build -t <custom_image_name> .

• To trigger job with custom image, create container as:

docker run -v "$(pwd)":/<your_work_dir_name> -it <custom_image_name>

⁠Trigger job from inside the container

• Start docker container

docker run -it lambdatest/hyperexecute:latest

• Clone a sample project and change directory

git clone https://github.com/LambdaTest/junit-selenium-hyperexecute-sample.git && cd junit-selenium-hyperexecute-sample

• Add your config yaml file
• Trigger job like below:

hyperexecute --user {{user_name}} --key {{access_key}} --config <your_yaml_file_name>

⁠About LambdaTest

LambdaTest⁠ is a cloud based selenium grid infrastructure that can help you run automated cross browser compatibility tests on 2000+ different browser and operating system environments. LambdaTest supports all programming languages and frameworks that are supported with Selenium, and have easy integrations with all popular CI/CD platforms. It's a perfect solution to bring your selenium automation testing⁠ to cloud based infrastructure that not only helps you increase your test coverage over multiple desktop and mobile browsers, but also allows you to cut down your test execution time by running tests on parallel.

⁠License

Licensed under the MIT license⁠.