Prerequisites

1. Install Terraform from https://www.terraform.io/. You can run terraform from any machine or your laptop.

2. If you are using AWS, make sure you have your credentials setup up. To set them up, install the AWS CLI from https://aws.amazon.com/cli/ and run aws configure.

Usage

1. Clone the repo

   git clone https://github.com/hysds/hysds-terraform.git

   
   
   

   
   
   

   
   
   

   cd hysds-terraform

   
   
   

2. Copy the variables.tf.tmpl to variables.tf:

   
   
   

   cp variables.tf.tmpl variables.tf

   
   Initialize so plugins are installed:

   
   
   

3. Updated the values starting with two underscores, e.g. __region__, for your provider account and settings. Edit the variables.tf file with custom variables for this installation venue. Many of these values can be acquired from the aws console.

   
   
   

4. Determine the project, venue and counter for your HySDS cluster. They will be used to uniquely name and identify your cluster's resources.

   • project e.g. swot, smap, aria, grfn, eos

   • venue e.g. ops, dev, test, gerald

   • counter e.g. 1, 2, 3

5. Validate your configuration:

   
   
   

6. Build your HySDS clustser:

   
   
   

7. Show status of your HySDS cluster:

   
   
   

8. Destroy your HySDS cluster once it's no longer needed:

   
   
   

Next Step

Step 4: Initial Cluster Setup