HySDS cluster provisioning using Terraform
- Install Terraform from https://www.terraform.io/. You can run
terraform
from any machine or your laptop. - 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
.
- Clone the repo
git clone https://github.com/hysds/hysds-terraform.git cd hysds-terraform
- Copy the variables.tf.tmpl to variables.tf:
cp variables.tf.tmpl variables.tf
- Initialize so plugins are installed:
terraform init
- 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.
vi variables.tf
- Determine the
project
,venue
andcounter
for your HySDS cluster. They will be used to uniquely name and identify your cluster's resources.project
e.g. swot, smap, aria, grfn, eosvenue
e.g. ops, dev, test, geraldcounter
e.g. 1, 2, 3
- Validate your configuration:
terraform validate --var project=aria --var venue=ops --var counter=1
- Build your HySDS clustser:
terraform apply --var project=aria --var venue=ops --var counter=1
- Show status of your HySDS cluster:
terraform show --var project=aria --var venue=ops --var counter=1
- Destroy your HySDS cluster once it's no longer needed:
terraform destroy --var project=aria --var venue=ops --var counter=1