zeerorg/docker-test-runner

Docker Test Runner

Run tests in docker container.

How TO:

git clone https://github.com/zeerorg/docker-test-runner.git
cd docker-test-runner
pip3 install -e .

Start by:

dock-runner

Goals:

--host (Optional): Specify a docker url. Will be taken from environment variable DOCKER_HOST if not specified.

• init : Takes 3 arguments.
• init-file : Initializes from dock-runner-init.json file.
• test : Run the test
• clean : Delete the previous test containers.
• logs : Accepts one of 3 arguments and gives logs.

init :

Creates the dock-runner-init.json file.

• install : Specify install commands for ubuntu installation. These are run first time to create a docker image. Expected: Install base dependencies. Example: apt-get update; apt-get install git python-pip; git clone $something. These are persisted.
• update : Specify commands which update the test environment every time they are run. These are run to fetch the newest code changes. These may or may not be persisted.
• test : Specify test commands which run the test. The output of these commands is logged on terminal.

dock-runner-init.json file:

• image : Specifies the image name
• install/update/test : Specifies the install/update/test command respectively. Also contains the logs for inspection. The logs are retrieved from closed containers and not directly stored in json.
• containers (list) : Contains list of containers run. TODO: also store logs.
• host : The host url (If specified)

Extra functionality:

• Determine if the test has completed.
• trigger post completion command

Sample dock-runner-init.json file

{
    "image" : "test-runner-abgfd",
    "install": {
        "command": "apt-get update; apt-get install git -y;",
        "container": "hungry_hyena"
    },
    "update": {
        "command": "apt-get update; apt-get install python3 -y;",
        "container": "heltic_picker",
        "image": ""
    },
    "test": {
        "command": "python --version",
        "container": "command_preach"
    }
}

An API for direct use in python projects.