initial import of working version

mipmip · mipmip · commit 6a10828d70c3 · 2022-10-14T17:02:28.000+02:00
diff --git a/README.md b/README.md
@@ -1,84 +1,65 @@
-> START INSTRUCTION FOR TECHNATIVE ENGINEERS
+# terraform-aws-route53-s3-http-redirect ![](https://img.shields.io/github/workflow/status/TechNative-B-V/terraform-aws-route53-s3-http-redirect/Lint?style=plastic)
 
-# terraform-aws-module-template
+Implements creates a simple http url forwarding redirect using a route 53 alias
+records and a s3 bucket.
 
-Template for creating a new TerraForm AWS Module. For TechNative Engineers.
+This is the most simple method to create a HTTP redirect within AWS.
 
-## Instructions
-
-### Your Module Name
-
-Think hard and come up with the shortest descriptive name for your module.
-Look at competition in the [terraform
-registry](https://registry.terraform.io/).
-
-Your module name should be max. three words seperated by dashes. E.g.
-
-- html-form-action
-- new-account-notifier
-- budget-alarms
-- fix-missing-tags
-
-### Setup Github Project
-
-1. Click the template button on the top right...
-2. Name github project `terraform-aws-[your-module-name]`
-3. Make project private untill ready for publication
-2. Install `pre-commit`
-
-### Develop your module
-
-1. Develop your module
-2. Try to use the [best practices for TerraForm
-   development](https://www.terraform-best-practices.com/) and [TerraForm AWS
-   Development](https://github.com/ozbillwang/terraform-best-practices).
-
-## Finish project documentation
+[![](we-are-technative.png)](https://www.technative.nl)
 
-1. Set well written title
-2. Add one or more shields
-3. Start readme with a short and complete as possible module description. This
-   is the part where you sell your module.
-4. Complete README with well written documentation. Try to think as a someone
-   with three months of Terraform experience.
-5. Check if pre-commit correctly generates the standard Terraform documentation.
+## How does it work
 
-## Publish module
+This module creates a S3 bucket and a Route 53 A record.
 
-If your module is in a state that it could be useful for others and ready for
-publication, you can publish a first version.
+The S3 bucket is empty and has a website configuration which redirects all
+traffic to the target url.
 
-1. Create a [Github
-   Release](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases)
-2. Publish in the TerraForm Registry under the Technative Namespace (the GitHub
-   Repo must be in the TechNative Organization)
+The Route 53 A record will alias to the S3 endpoint.
 
----
+## Usage
 
-> END INSTRUCTION FOR TECHNATIVE ENGINEERS
+```
+module "redirect_technative_nl_techdd" {
+  source = "Technative-B-V/terraform-aws-route53-s3-http-redirect/aws"
+  version = "0.1.0"
 
+  zone_name = "example.com" # THIS ZONE SHOULD EXIST IN ROUTE53
+  domain_name = "sample-google-form.example.com"
+  redirect_target_url = "https://docs.google.com/forms/d/e/1FAIpQLSeI8_vYyaJgM7SJM4Y9AWfLq-tglWZh6yt7bEXEOJr_L-hV1A/viewform?formkey=dGx0b1ZrTnoyZDgtYXItMWVBdVlQQWc6MQ"
+}
+```
 
-# Terraform AWS [Module Name] ![](https://img.shields.io/github/workflow/status/TechNative-B-V/terraform-aws-module-name/Lint?style=plastic)
+<!-- BEGIN_TF_DOCS -->
+## Providers
 
-<!-- SHIELDS -->
+| Name | Version |
+|------|---------|
+| <a name="provider_aws"></a> [aws](#provider\_aws) | >= 4.0.0 |
 
-This module implements ...
+## Modules
 
-[![](we-are-technative.png)](https://www.technative.nl)
+| Name | Source | Version |
+|------|--------|---------|
+| <a name="module_route53_http_redirect_target_url"></a> [route53\_http\_redirect\_target\_url](#module\_route53\_http\_redirect\_target\_url) | TechNative-B-V/url-parser/null | 0.1.1 |
 
-## How does it work
+## Resources
 
-...
+| Name | Type |
+|------|------|
+| [aws_route53_record.domains](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/route53_record) | resource |
+| [aws_s3_bucket.route53_http_redirect_bucket](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket) | resource |
+| [aws_s3_bucket_website_configuration.route53_http_redirect_webconf](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_website_configuration) | resource |
+| [aws_route53_zone.route53_http_redirect_zone](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/route53_zone) | data source |
 
-## Usage
+## Inputs
 
-To use this module ...
+| Name | Description | Type | Default | Required |
+|------|-------------|------|---------|:--------:|
+| <a name="input_domain_name"></a> [domain\_name](#input\_domain\_name) | Domain to provide the redirect including subdomain if applicable | `string` | n/a | yes |
+| <a name="input_redirect_target_url"></a> [redirect\_target\_url](#input\_redirect\_target\_url) | Redirect target - should be a full URL. If http:// or https:// is excluded, the scheme of the request will be used | `string` | n/a | yes |
+| <a name="input_zone_name"></a> [zone\_name](#input\_zone\_name) | Domain name of the Route53 hosted zone | `string` | n/a | yes |
 
-```json
-{
-  "some_conf": "might need explanation"
-}
-```
+## Outputs
 
-<!-- BEGIN_TF_DOCS -->
+No outputs.
 <!-- END_TF_DOCS -->
diff --git a/examples/README.md b/examples/README.md
diff --git a/examples/complete/README.md b/examples/complete/README.md
@@ -0,0 +1,3 @@
+# Example route53 s3 http redirect - Redirect to Google Forms
+
+This example demonstrates how to create a redirect to a Google Form.
diff --git a/examples/complete/main.tf b/examples/complete/main.tf
@@ -0,0 +1,9 @@
+module "redirect_technative_nl_techdd" {
+  source = "Technative-B-V/terraform-aws-route53-s3-http-redirect/aws"
+  version = "0.1.0"
+
+  zone_name = "example.com" # THIS ZONE SHOULD EXIST IN ROUTE53
+  domain_name = "sample-google-form.example.com"
+  redirect_target_url = "https://docs.google.com/forms/d/e/1FAIpQLSeI8_vYyaJgM7SJM4Y9AWfLq-tglWZh6yt7bEXEOJr_L-hV1A/viewform?formkey=dGx0b1ZrTnoyZDgtYXItMWVBdVlQQWc6MQ"
+}
+
diff --git a/main.tf b/main.tf
@@ -1 +1,47 @@
-# YOU MAIN CODE HERE
+data "aws_route53_zone" "route53_http_redirect_zone" {
+  name = var.zone_name
+}
+
+resource "aws_s3_bucket" "route53_http_redirect_bucket" {
+  bucket        = var.domain_name
+  force_destroy = "true"
+}
+
+module "route53_http_redirect_target_url" {
+  source  = "TechNative-B-V/url-parser/null"
+  version = "0.1.1"
+
+  url    = var.redirect_target_url
+}
+
+resource "aws_s3_bucket_website_configuration" "route53_http_redirect_webconf" {
+  bucket = aws_s3_bucket.route53_http_redirect_bucket.bucket
+
+  index_document {
+    suffix = "index.html"
+  }
+
+  routing_rules = <<EOF
+[{
+    "Redirect": {
+        "Hostname": "${module.route53_http_redirect_target_url.hostname}",
+        "Protocol": "${module.route53_http_redirect_target_url.protocol}",
+        "ReplaceKeyWith": "${module.route53_http_redirect_target_url.path_and_param}"
+    }
+}]
+EOF
+}
+
+resource "aws_route53_record" "domains" {
+  zone_id = data.aws_route53_zone.route53_http_redirect_zone.zone_id
+  name    = var.domain_name
+  type    = "A"
+
+  alias {
+    name                   = "s3-website.${aws_s3_bucket.route53_http_redirect_bucket.region}.amazonaws.com"
+    zone_id                = aws_s3_bucket.route53_http_redirect_bucket.hosted_zone_id
+    evaluate_target_health = true
+  }
+}
+
+
diff --git a/outputs.tf b/outputs.tf
diff --git a/variables.tf b/variables.tf
@@ -1 +1,15 @@
-# VARIABLES
+variable "zone_name" {
+  description = "Domain name of the Route53 hosted zone"
+  type        = string
+}
+
+variable "domain_name" {
+  description = "Domain to provide the redirect including subdomain if applicable"
+  type        = string
+}
+
+variable "redirect_target_url" {
+  description = "Redirect target - should be a full URL. If http:// or https:// is excluded, the scheme of the request will be used"
+  type        = string
+}
+
diff --git a/versions.tf b/versions.tf
@@ -0,0 +1,11 @@
+
+terraform {
+  required_version = ">= 1.0.0"
+
+  required_providers {
+    aws = {
+      source  = "hashicorp/aws"
+      version = ">= 4.0.0"
+    }
+  }
+}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Example route53 s3 http redirect - Redirect to Google Forms`
	`2`	`+`
	`3`	`+This example demonstrates how to create a redirect to a Google Form.`