Skip to content

Commit 4014684

Browse files
Merge pull request #3 from DevOpsNavy/proofread
proofread readme
2 parents cac06aa + 413d02d commit 4014684

File tree

1 file changed

+25
-10
lines changed

1 file changed

+25
-10
lines changed

README.md

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,6 @@
22

33
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.
44

5-
creates an [S3 Bucket](https://aws.amazon.com/s3/) to creates a [CloudFront Distribution](https://aws.amazon.com/cloudfront/),
6-
7-
85
## Key Features
96

107
- [S3 Bucket](https://aws.amazon.com/s3/) to store website content.
@@ -21,16 +18,29 @@ This module provisions the infrasructure required for a static website hosted on
2118
- [Route 53 Hosted zone](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-working-with.html) which is the DNS provider for the domain. [Making Amazon Route 53 the DNS service for an existing domain](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/MigratingDNS.html). Note: the hosted zone only needs to manage the DNS service, domain registration does not need to be migrated!
2219
- [A second aws porovider configured in us-east-1](https://www.terraform.io/language/providers/configuration) as CloudFront and SSL certificates are only available in us-east-1.
2320

24-
To syncronisation of the website content with a local directory, the following is required:
21+
For syncronisation of the website content with a local directory, the following is required:
2522
- [AWS CLI](https://aws.amazon.com/cli/) installed locally - [installation instructions](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
26-
- [Configure a named profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) using `aws configure --profile NAME` command. This is used for the aws s3 sync command.
23+
- [Configure a named profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) 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.
2724

2825

2926
## Usage
3027
[Example available here](https://github.com/DevOpsNavy/s3-cloudfront-static-website/tree/main/examples/static_website_with_sync)
3128

3229
```javascript
33-
# Module AP
30+
terraform {
31+
required_providers {
32+
aws = {
33+
source = "hashicorp/aws"
34+
version = "4.10.0"
35+
}
36+
}
37+
}
38+
39+
# Default provider for resource creation
40+
provider "aws" {
41+
region = ""
42+
profile = ""
43+
}
3444

3545
# Provider required in useast1 for cloudfront, SSLM Certificate
3646
provider "aws" {
@@ -177,17 +187,17 @@ NOTE: Be sure to merge the latest changes from "upstream" before making a pull r
177187

178188
## To Do
179189

180-
## Contributing
190+
To dos are documented in the [project associated](https://github.com/DevOpsNavy/s3-cloudfront-static-website/projects/1) with this repo.
181191

182-
[ToDo are captured within the GitHub project associated with this module](https://github.com/DevOpsNavy/s3-cloudfront-static-website/projects/1)
192+
## Contributing
183193

184194
### Bug Reports & Feature Requests
185195

186196
Please use the [issue tracker](https://github.com/DevOpsNavy/s3-cloudfront-static-website/issues) to report any bugs or file feature requests.
187197

188198
### Developing
189199

190-
If you are interested in being a contributor and want to get involved in developing this project or [help out](https://cpco.io/help-out) with our other projects, we would love to hear from you! Shoot us an [email][email].
200+
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].
191201

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

@@ -204,4 +214,9 @@ In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
204214
| Name | Role |
205215
|------|---------|
206216
| [Faizan Raza](https://www.linkedin.com/in/faizan-raza-997808206/) | Lead Developer |
207-
| [Vic Hassan](https://www.linkedin.com/in/vic-prince-hassan-619505171/) | Developer |
217+
| [Vic Hassan](https://www.linkedin.com/in/vic-prince-hassan-619505171/) | Developer |
218+
219+
220+
## Resources Used
221+
222+
[Terraform Docs](https://terraform-docs.io/) used for generating documentation.

0 commit comments

Comments
 (0)