pwolfram / ci-bots

Automated Test Suite Tools for MPAS

testbot setup

This repository contains all the code necessary to create a new CI service At the moment is has support for github statuses and uses github wiki for commit test logs

ssh agents

Central to the system is the ability of the machines to push to github w/o human interaction

On Linux machines this can be done via ssh-agent

eval `ssh-agent `
ssh-add ~/.ssh/id_rsa

Tester machines setup

The tester setup is fairly easy You will need to create json config file in that directory That json file contains the following information:

{
  "projects": {
    "doutriaux1/mpas-dummy": {
      "tester_id" : "LLNL-LOKI",
      "github_status_token" : "*****"
      "source_path" : "/git/mpas-dummy",
      "wiki_path" : "/git/mpas-dummy.wiki",
      "commits_backlog" : 1,
      "test_command" : "dummy.bash 10",
      "test_execute_directory" : "/Users/doutriaux1",
      "simultaneous_tests" : false
    }
  }
}

Where:

• "doutriaux1/mpas-dummy" is the github repo you wish to test
• tester_id is a unique identifier that will appear in the github status and representing the test machine id
• github_status_token is your personal github token
• source_path directory on tester machine where the repo is cloned
• wiki_path the local path on your machine where you cloned your repo's wiki ( git clone [e-mail]:user/repo.wiki ) repo mustbe writable
• commits_backlog number of commits to go back
• test_command command to run to test the repo
• test_execute_directory directory on tester machine where to run the test command from
• simultaneous_tests mutliple commits can be tested at the same time (default to false)

When that is done, install the requirements listed in requirements.txt

Install this into your python

python setup.py install

to start the service and check for new commits every 30 seconds

ci-bot -p project.json -f 30

You can also test a single commit by runnnig:

ci-bot -p project.json -c **YOUR_COMMIT_SHA1** -r **REPO_HANDLE**

You can obtain more help by typing:

ci-bot -h