Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 2.08 KB

environment.md

File metadata and controls

39 lines (28 loc) · 2.08 KB

Set up environment

Before running Terraform, you must set some Terraform variables defining the environment.

  • control_cidr: The CIDR of your IP. The Bastion will accept only traffic from this address. Note this is a CIDR, not a single IP. e.g. 123.45.67.89/32 (mandatory)
  • default_keypair_public_key: Valid public key corresponding to the Identity (PEM) you will use to SSH into VMs. e.g. "ssh-rsa AAA....xyz" (mandatory)

You may also optionally defines the following variables:

  • default_keypair_name: AWS KeyPair name for all instances (Default: "etcd-sample")
  • vpc_name: VPC Name. Must be unique in the AWS Account (Default: "ETCD")
  • elb_name: ELB Name. Can only contain characters valid for DNS names. Must be unique in the AWS Account (Default: "etcd")
  • owner: Owner tag added to all AWS resources. No functional use. It may become useful to filter your resources on AWS console if you are sharing the same AWS account with others. (Default: "ETCD").

The easiest way to do it is creating a terraform.tfvars variable file in ./terraform directory. Terraform automatically includes this file.

Example of terraform.tfvars variable file:

# Mandatory
default_keypair_public_key = "ssh-rsa AAA...zzz"
control_cidr = "123.45.67.89/32"
# Optional
default_keypair_name = "lorenzo-glf"
vpc_name = "Lorenzo ETCD"
elb_name = "lorenzo-etcd"
owner = "Lorenzo"

How To Change AWS Region

By default, it uses eu-west-1 AWS Region. To use a different Region, you have to set two additional Terraform variables:

  • region: AWS Region (default: "eu-west-1")
  • zones: Comma separated list of AWS Availability Zones, in the selected Region (default: "eu-west-1a,eu-west-1b,eu-west-1c")
  • zone_count: Number of AZ to use. Must be <= the number of AZ in zones (default: 3)
  • bastion_ami and etcd_ami: Choose AMI with Unbuntu 16.04 LTS HVM, EBS-SSD, available in the new Region

You also have to manually modify ./ansible/inventory/ec2.ini, changing regions = eu-west-1 to the Region you are using.