Terraform has become one of my favorite tools I tried out recently. If you are reading this article, then I’m guessing you are already familiar with it. But if not, check out this 👉 introduction to get some basics first.
Write configuration
For this tutorial, we will primarily use 3 tf config files. Let’s create a dedicated directory to store them.
mkdir aws-ec2-with-key-pairs
cd aws-ec2-with-key-pairs
Now that we are in the directory, create the config files and open them on your favorite code editor. I’m using Visual Studio Code.
touch main.tf variable.tf output.tf
code .
variable.tf
This is where we will save our config variables which will be used in main.tf,
variable "instance-region" {
description = "Value of AWS region"
type = string
default = "eu-central-1"
}
variable "instance-name" {
description = "Value of the Name tag for the EC2 instance"
type = string
default = "OverEngineeredVPS"
}
variable "key-pair" {
description = "Value of AWS SSH key-pair name"
type = string
default = "oei-key-pair"
}
main.tf
Let’s use the variables we set to create an EC2 instance.
terraform {
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 4.16"
}
}
required_version = ">= 1.2.0"
}
resource "tls_private_key" "oei-key" {
algorithm = "RSA"
rsa_bits = 4096
}
resource "aws_key_pair" "oei-key-pair" {
key_name = "oei-key-pair"
public_key = tls_private_key.oei-key.public_key_openssh
}
provider "aws" {
region = var.instance-region
}
resource "aws_instance" "oei-server" {
ami = "ami-09042b2f6d07d164a" // for frankfurt + ubuntu
instance_type = "t2.small" // $0.023/H
key_name = "oei-key-pair"
tags = {
Name = var.instance-name
}
}
Now if we run this file, it will create an ec2 server on eu-central-1(as we specified in variable.tf) with a key-pair called oei-key-pair. But if you wish to use a different location, make sure to change your ami value according to the AWS configuration.
output.tf
We will use this file to output the results on the console.
output "instance_id" {
description = "ID of the EC2 instance"
value = aws_instance.oei-server.id
}
output "instance_public_ip" {
description = "Public IP address of the EC2 instance"
value = aws_instance.oei-server.public_ip
}
output "instance_public_DNS" {
description = "Public IP address of the EC2 instance"
value = aws_instance.oei-server.public_dns
}
output "instance_public_key" {
description = "Public key of oe-key-pair"
value = tls_private_key.oei-key.public_key_openssh
sensitive = true
}
output "instance_private_key" {
description = "Private key of oe-key-pair"
value = tls_private_key.oei-key.private_key_pem
sensitive = true
}
Notice I used the sensitive flag on instance_public_key & instance_private_key so that it does not show the plain output by default.
Apply the configuration
Now that we have written our config file, let’s run these 👇🏼 commands to let Terraform do its job.
terraform init
This will download and install the AWS plugins for the providers we used. After the installation is done, run terraform plan to see the changes that will take place on the infrastructure. If everything looks alright, let’s apply the changes by running 👇🏼
terraform apply
This will take some time. But once it is done, you should be able to run terraform output to see the results we specified on output.tf.
To check the sensitive output, just run terraform output -raw “key name”. Example: 👇🏼
Conclusion
Thanks for reading the article guys. Hope it helped!
Top comments (0)