open-nomad/e2e/terraform/README.md

Terraform provisioner for end to end tests
==========================================

This folder contains terraform resources for provisioning a nomad cluster on AWS for end to end tests.
It uses a Nomad binary identified by its commit SHA that's stored in a shared s3 bucket that Nomad team
developers can access. The commit SHA can be from any branch that's pushed to remote.

Use [envchain](https://github.com/sorah/envchain) to store your AWS credentials.


```
$ cd e2e/terraform/
$ TF_VAR_nomad_sha=<nomad_sha> envchain nomadaws terraform apply
```

After this step, you should have a nomad client address to point the end to end tests in the `e2e` folder to.

## SSH

Terraform will output node IPs that may be accessed via ssh:

```
ssh -i keys/nomad-e2e-*.pem ubuntu@${EC2_IP_ADDR}
```

The Windows client runs OpenSSH for conveniences, but has a different user and will drop you into a Powershell shell instead of bash:

```
ssh -i keys/nomad-e2e-*.pem Administrator@${EC2_IP_ADDR}
```


## Teardown
The terraform state file stores all the info, so the nomad_sha doesn't need to be valid during teardown.

```
$ cd e2e/terraform/
$ envchain nomadaws TF_VAR_nomad_sha=yyyzzz terraform destroy
```