github.com/adelq/deis@v0.13.2-0.20141021145840-f05550607c59/tests/README.md (about) 1 # Deis Tests 2 3 This directory contains a [Go](http://golang.org/) package with integration 4 tests for the [Deis](http://deis.io/) open source PaaS. 5 6 [![GoDoc](https://godoc.org/github.com/deis/deis/tests?status.svg)](https://godoc.org/github.com/deis/deis/tests) 7 8 **NOTE**: These integration tests are targeted for use in Deis' 9 [continuous integration system](http://ci.deis.io/). The tests currently assume 10 they are targeting a freshly provisioned Deis cluster. **Don't** run the 11 integration tests on a Deis installation with existing users; the tests will 12 fail and could overwrite data. 13 14 ## Test Setup 15 16 Check out [Deis' source code](https://github.com/deis/deis) into the `$GOPATH`: 17 18 ```console 19 $ go get -u -v github.com/deis/deis 20 $ cd $GOPATH/src/github.com/deis/deis/tests 21 ``` 22 23 Provision a Deis cluster as usual, and ensure that a matching `deis` 24 command-line client is available in your `$PATH`. 25 26 Create two SSH keys: 27 28 ```console 29 $ ssh-keygen -q -t rsa -f ~/.ssh/deis -N '' -C deis 30 $ ssh-keygen -q -t rsa -f ~/.ssh/deiskey -N '' -C deiskey 31 ``` 32 33 The first key `deis` is used for authentication against Deis by the `test` user 34 who runs the integration tests. The second `deiskey` is used only for testing 35 `deis keys:add`, `deis keys:list`, and related commands. 36 37 ## Test Execution 38 39 Run all the integration tests: 40 41 ```console 42 $ make test-full 43 ``` 44 45 Or run just the [smoke test](http://www.catb.org/jargon/html/S/smoke-test.html): 46 47 ```console 48 $ make test-smoke 49 ``` 50 51 ## Customizing Test Runs 52 53 These environment variables can be set to customize the test run: 54 * `DEIS_TEST_AUTH_KEY` - SSH key used to register with the Deis controller 55 (default: `~/.ssh/deis`) 56 * `DEIS_TEST_SSH_KEY` - SSH key used to login to the controller machine 57 (default: `~/.vagrant.d/insecure_private_key`) 58 * `DEIS_TEST_DOMAIN` - the domain to use for testing 59 (default: `local.deisapp.com`) 60 * `DEIS_TEST_HOSTS` - comma-separated list of IPs for nodes in the cluster, 61 should be internal IPs for cloud providers (default: `172.17.8.100`) 62 * `DEIS_TEST_APP` - name of the 63 [Deis example app](https://github.com/deis?query=example-) to use, which is 64 cloned from GitHub (default: random)