feat: initial Terraform configuration files

Author: jasonwalsh

.github/workflows/pipeline.yaml

@@ -0,0 +1,35 @@
+jobs:
+  documentation:
+    name: Run terraform-docs
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          ref: main
+      - uses: terraform-docs/gh-actions@main
+        with:
+          git-commit-message: |
+            docs: Run terraform-docs
+          git-push: "true"
+          output-file: README.md
+          output-method: inject
+          working-dir: .
+  release:
+    name: Run semantic-release
+    needs:
+      - documentation
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+      - run: npm ci
+      - env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release@18
+name: Run release pipeline
+on:
+  push:
+    branches:
+      - main

.github/workflows/prettier.yaml

@@ -0,0 +1,15 @@
+jobs:
+  prettier:
+    name: Run prettier
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+      - run: npm ci
+      - run: npx prettier --check .
+name: Run prettier
+on:
+  - pull_request
+  - push

.gitignore

@@ -27,3 +27,5 @@ override.tf.json
 
 # Include tfplan files to ignore the plan output of command: terraform plan -out=tfplan
 # example: *tfplan*
+
+node_modules/

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx lint-staged

.prettierignore

@@ -0,0 +1,2 @@
+# Local .terraform directories
+**/.terraform/*

.prettierrc.json

@@ -0,0 +1 @@
+{}

.terraform.lock.hcl

@@ -8,7 +8,92 @@
   <p>Returns descriptive information about an Amazon VPC</p>
 </div>
 
+## Purpose
+
+This module is considered to be a [data-only](https://www.terraform.io/docs/language/modules/develop/composition.html#data-only-modules) module. Given the name of a VPC and an optional set of availability zones, this module returns information about a VPC, such as public and private subnets, the VPC ID, etc. See the [outputs](outputs.tf) file for which data is returned from this module. This module is useful for workspaces that require such information without declaring repetitive `data` sources in your Terraform configurations.
+
+## Usage
+
+The following example creates a security group and an application load balancer.
+
+```hcl
+provider "aws" {}
+
+module "networking" {
+  source  = "github.com/mongodb-ansible-roles/terraform-aws-networking-readonly"
+  version = "1.1.0"
+
+  vpc_name = "tutorial-vpc"
+}
+
+resource "aws_security_group" "this" {
+  ingress = [
+    {
+      cidr_blocks = ["0.0.0.0/0"]
+      from_port   = 443
+      protocol    = "TCP"
+      to_port     = 443
+    }
+  ]
+
+  vpc_id = module.networking.vpc_id
+}
+
+resource "aws_lb" "this" {
+  internal           = false
+  load_balancer_type = "application"
+  security_groups    = [aws_security_group.this.id]
+  subnets            = module.networking.public_subnets
+}
+```
+
 <!-- BEGIN_TF_DOCS -->
+
+## Requirements
+
+| Name                                                                     | Version   |
+| ------------------------------------------------------------------------ | --------- |
+| <a name="requirement_terraform"></a> [terraform](#requirement_terraform) | >= 1.0    |
+| <a name="requirement_aws"></a> [aws](#requirement_aws)                   | >= 3.64.2 |
+
+## Providers
+
+| Name                                             | Version |
+| ------------------------------------------------ | ------- |
+| <a name="provider_aws"></a> [aws](#provider_aws) | 3.70.0  |
+
+## Modules
+
+No modules.
+
+## Resources
+
+| Name                                                                                                                             | Type        |
+| -------------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| [aws_availability_zones.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/availability_zones) | data source |
+| [aws_subnet.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/subnet)                         | data source |
+| [aws_subnet_ids.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/subnet_ids)                 | data source |
+| [aws_vpc.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/vpc)                               | data source |
+
+## Inputs
+
+| Name                                                                                    | Description                          | Type          | Default | Required |
+| --------------------------------------------------------------------------------------- | ------------------------------------ | ------------- | ------- | :------: |
+| <a name="input_availability_zones"></a> [availability_zones](#input_availability_zones) | Select subnets only in the given AZs | `set(string)` | `[]`    |    no    |
+| <a name="input_vpc_name"></a> [vpc_name](#input_vpc_name)                               | The name of the VPC                  | `string`      | n/a     |   yes    |
+
+## Outputs
+
+| Name                                                                                               | Description                                                                |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| <a name="output_dns_hostnames_enabled"></a> [dns_hostnames_enabled](#output_dns_hostnames_enabled) | Indicates if instances launched in this VPC will have public DNS hostnames |
+| <a name="output_dns_support_enabled"></a> [dns_support_enabled](#output_dns_support_enabled)       | Indicates if DNS support is enabled for this VPC                           |
+| <a name="output_private_subnets"></a> [private_subnets](#output_private_subnets)                   | List of private subnets in this VPC                                        |
+| <a name="output_public_subnets"></a> [public_subnets](#output_public_subnets)                      | List of public subnets in this VPC                                         |
+| <a name="output_vpc_arn"></a> [vpc_arn](#output_vpc_arn)                                           | Arn of this VPC                                                            |
+| <a name="output_vpc_cidr_block"></a> [vpc_cidr_block](#output_vpc_cidr_block)                      | CIDR range for this VPC                                                    |
+| <a name="output_vpc_id"></a> [vpc_id](#output_vpc_id)                                              | The ID of the VPC                                                          |
+
 <!-- END_TF_DOCS -->
 
 ## Contributing

README.md

@@ -0,0 +1,34 @@
+data "aws_availability_zones" "this" {
+  filter {
+    name   = "zone-name"
+    values = var.availability_zones
+  }
+}
+
+data "aws_vpc" "this" {
+  filter {
+    name   = "tag:Name"
+    values = [var.vpc_name]
+  }
+
+  state = "available"
+}
+
+data "aws_subnet_ids" "this" {
+  dynamic "filter" {
+    for_each = length(data.aws_availability_zones.this.names) > 0 ? range(1) : range(0)
+
+    content {
+      name   = "availability-zone"
+      values = data.aws_availability_zones.this.names
+    }
+  }
+
+  vpc_id = data.aws_vpc.this.id
+}
+
+data "aws_subnet" "this" {
+  for_each = data.aws_subnet_ids.this.ids
+
+  id = each.value
+}

main.tf

@@ -0,0 +1,34 @@
+output "dns_hostnames_enabled" {
+  description = "Indicates if instances launched in this VPC will have public DNS hostnames"
+  value       = data.aws_vpc.this.enable_dns_hostnames
+}
+
+output "dns_support_enabled" {
+  description = "Indicates if DNS support is enabled for this VPC"
+  value       = data.aws_vpc.this.enable_dns_support
+}
+
+output "private_subnets" {
+  description = "List of private subnets in this VPC"
+  value       = sort([for subnet in data.aws_subnet.this : subnet.id if !subnet.map_public_ip_on_launch])
+}
+
+output "public_subnets" {
+  description = "List of public subnets in this VPC"
+  value       = sort([for subnet in data.aws_subnet.this : subnet.id if subnet.map_public_ip_on_launch])
+}
+
+output "vpc_arn" {
+  description = "Arn of this VPC"
+  value       = data.aws_vpc.this.arn
+}
+
+output "vpc_cidr_block" {
+  description = "CIDR range for this VPC"
+  value       = data.aws_vpc.this.cidr_block
+}
+
+output "vpc_id" {
+  description = "The ID of the VPC"
+  value       = data.aws_vpc.this.id
+}