Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pvarentsov/terraform-aws-free-tier
Getting started with the Terraform for managing a base free-tier AWS resources.
https://github.com/pvarentsov/terraform-aws-free-tier
aws infrastructure-as-code learning terraform
Last synced: 1 day ago
JSON representation
Getting started with the Terraform for managing a base free-tier AWS resources.
- Host: GitHub
- URL: https://github.com/pvarentsov/terraform-aws-free-tier
- Owner: pvarentsov
- License: mit
- Created: 2020-01-09T11:06:07.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T18:33:21.000Z (over 1 year ago)
- Last Synced: 2023-03-05T04:58:22.318Z (over 1 year ago)
- Topics: aws, infrastructure-as-code, learning, terraform
- Language: HCL
- Homepage:
- Size: 25.4 KB
- Stars: 28
- Watchers: 3
- Forks: 31
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terraform AWS Free Tier
> Getting started with the Terraform for managing a base free-tier AWS resources.
[](./LICENSE)
### Project description
This is a [Terraform](https://www.terraform.io/) project for managing AWS resources.
It can build the next infrastructure:
* [VPC](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html)
* Public [Subnet](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet) in the `VPC`
* [IGW](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html) to enable access to or from the Internet for `VPC`
* [Route Table](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Route_Tables.html) to associate `IGW`, `VPC` and `Subnet`
* [EC2 Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html) in the public `Subnet` with the HTTP(s) & SSH access
### Pre steps
1. [Install Terraform](https://learn.hashicorp.com/terraform/getting-started/install.html)
2. Create AWS account
3. If the file `~/.aws/credentials` does't exist, create it and add you Terraform profile to the file. For example:
```text
[terraform]
aws_access_key_id = Your access key
aws_secret_access_key = Your secret access key
```
4. Create S3 bucket to store Terraform state
5. Create config file `./src/free-tier/backend/config.tf` that will contain information how to store state in a given bucket. See [example](./src/free-tier/backend/example.config.tf).
6. Create SSH key pair to connect to EC2 instance:
```bash
cd ./src/free-tier/provision/access
# it creates "free-tier-ec2-key" private key and "free-tier-ec2-key.pub" public key
ssh-keygen -f free-tier-ec2-key
```
### Build infrastructure
1. `cd ./src/free-tier`
2. `terraform init -backend-config="./backend/config.tf"`
3. `terraform plan`
4. `terraform apply`
### Post steps
After building the infrastructure you can try to connect to you `EC2 instance` via SSH:
1. `cd ./src/free-tier`
2. `ssh -i ./provision/access/free-tier-ec2-key ubuntu@[EC2 public IP]`
To check HTTP access you can install `apache2` on your EC2 instance:
1. `sudo apt update && sudo apt install apache2` (on EC2 machine)
2. `sudo service apache2 start` (on EC2 machine)
3. Check in browser: `http://[EC2 public IP]/`. You can see `Apache2 Default Page` (something like [this](https://annex.exploratorium.edu/))
To destroy infrastructure:
1. `cd ./src/free-tier`
2. `terraform destroy`
### Similar projects
* https://github.com/rogeriomm/aws-lab