java-tutorials/terraform-modules/best-practices/ec2-simple/SETUP.md

1.2 KiB

EC2 Basic Sample

This Terraform sample project creates a single EC2 instance in the configured region.

IMPORTANT NOTICE: In order to run this sample you must have an active AWS Account. As you probably know, creating resources on AWS may result in additional charges in your bill. We recommend creating a test account to run this test as you can then use AWS's free tier to play around. When finished, ALWAYS REMEMBER TO DESTROY YOUR RESOURCES !!!

Setup instructions

  1. Make sure you have a working AWS environment. Use a simple command such as aws ec2 describe-instances and check its output. If you get a list of existing EC2 instances, you're good to go. Otherwise, please refer to AWS documentation in order to setup your CLI.
  2. Download the Terraform package for your environment from Hashicorp's site. Unzip it and put the terraform binary somewhere in the OS's PATH.
  3. Open a command prompt and cd into this folder
  4. Run the following commands: ''' $ terraform init $ terraform apply -auto-approve '''
  5. Wait until Terraform create all resources and run aws ec2 describe-instances. The output should list the newly creates EC2 instance
  6. Run terraform destroy to remove the previously creates namespace.