This module provisions the infrasructure required for a static website hosted on AWS S3 and CloudFront and optionally allows syncronisation of the website content with a local directory.

• S3 Bucket to store website content.
• CloudFront Distribution to serve the website at edge locations at a low cost and high performance.
• Route 53 A records to utilise custom domain on website.
• Security First - S3 Bucket is private with IAM policies to provide permissions to CloudFront.
• Utilises aws S3 sync command to upload website content to S3 Bucket.

• Domain Name
• Route 53 Hosted zone which is the DNS provider for the domain. Making Amazon Route 53 the DNS service for an existing domain. Note: the hosted zone only needs to manage the DNS service, domain registration does not need to be migrated!
• A second aws porovider configured in us-east-1 as CloudFront and SSL certificates are only available in us-east-1.

For syncronisation of the website content with a local directory, the following is required:

• AWS CLI installed locally - installation instructions
• Configure a named profile using aws configure --profile NAME command. This is used for the aws s3 sync command which is executed locally. Profiles are preferred over keys and secrets.

Example available here

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "4.10.0"
    }
  }
}

# Default provider for resource creation
provider "aws" {
  region  = ""
  profile = ""
}

# Provider required in useast1 for cloudfront, SSLM Certificate
provider "aws" {
  alias   = "useast1"
  region  = "us-east-1"
  profile = ""
}

module "website" {
  
  source = "XXX"

  resource_uid   = "DevOpsNavy"
  domain_name    = "XXX"
  hosted_zone_id = "XXX"
  profile        = "XXX"

  sync_directories = [{
    local_source_directory = "./website_content"
    s3_target_directory    = ""
  }]

  providers = {
    aws.useast1 = aws.useast1
  }
}

No modules.

[
  "GET",
  "HEAD",
  "OPTIONS",
  "PUT",
  "POST",
  "PATCH",
  "DELETE"
]

[
  "GET",
  "HEAD",
  "OPTIONS"
]

list(object({
    local_source_directory = string
    s3_target_directory    = string
  }))

Bug Reports & Feature Requests Please use the issue tracker to report any bugs or file feature requests.

Developing If you are interested in being a contributor and want to get involved in developing this project or help out with our other projects, we would love to hear from you! Shoot us an email.

In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.

Fork the repo on GitHub Clone the project to your own machine Commit changes to your own branch Push your work back up to your fork Submit a Pull Request so that we can review your changes NOTE: Be sure to merge the latest changes from "upstream" before making a pull request!

To dos are documented in the project associated with this repo.

Please use the issue tracker to report any bugs or file feature requests.

If you are interested in being a contributor and want to get involved in developing this project or with our other projects, we would love to hear from you! Shoot us an [email][Admin@devopsnavy.co.uk].

In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Commit changes to your own branch
4. Push your work back up to your fork
5. Submit a Pull Request so that we can review your changes

NOTE: Be sure to merge the latest changes from "upstream" before making a pull request!

Terraform Docs used for generating documentation.