Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tmknom/terraform-aws-s3-lb-log
Terraform module which creates S3 Bucket resources for Load Balancer Access Logs on AWS.
https://github.com/tmknom/terraform-aws-s3-lb-log
aws s3 terraform terraform-module
Last synced: 12 days ago
JSON representation
Terraform module which creates S3 Bucket resources for Load Balancer Access Logs on AWS.
- Host: GitHub
- URL: https://github.com/tmknom/terraform-aws-s3-lb-log
- Owner: tmknom
- License: apache-2.0
- Created: 2018-11-14T14:17:57.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-04-01T19:01:24.000Z (over 2 years ago)
- Last Synced: 2024-08-01T17:31:00.203Z (3 months ago)
- Topics: aws, s3, terraform, terraform-module
- Language: HCL
- Homepage:
- Size: 34.2 KB
- Stars: 8
- Watchers: 3
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# terraform-aws-s3-lb-log
[](https://github.com/tmknom/terraform-aws-s3-lb-log/actions?query=workflow%3ATerraform)
[](https://github.com/tmknom/terraform-aws-s3-lb-log/actions?query=workflow%3AMarkdown)
[](https://github.com/tmknom/terraform-aws-s3-lb-log/actions?query=workflow%3AYAML)
[](https://github.com/tmknom/terraform-aws-s3-lb-log/actions?query=workflow%3AJSON)
[](https://registry.terraform.io/modules/tmknom/s3-lb-log/aws)
[](https://opensource.org/licenses/Apache-2.0)
Terraform module which creates S3 Bucket resources for Load Balancer Access Logs on AWS.
## Description
Provision [S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/Welcome.html) bucket
designed for [Load Balancer Access Logs](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-access-logs.html).
This module provides recommended settings.
- Enable Access Logging
- Enable Default Encryption
- Enable Versioning
- Enable Lifecycle Configuration
- Protected from deletion
## Usage
### Minimal
```hcl
module "s3_lb_log" {
source = "git::https://github.com/tmknom/terraform-aws-s3-lb-log.git?ref=tags/2.0.0"
name = "s3-lb-log"
logging_target_bucket = "s3-access-log"
}
```
### Complete
```hcl
module "s3_lb_log" {
source = "git::https://github.com/tmknom/terraform-aws-s3-lb-log.git?ref=tags/2.0.0"
name = "s3-lb-log"
logging_target_bucket = "s3-access-log"
versioning_enabled = false
force_destroy = true
region = "ap-northeast-1"
lifecycle_rule_enabled = true
lifecycle_rule_prefix = ""
standard_ia_transition_days = "60"
glacier_transition_days = "90"
expiration_days = "180"
glacier_noncurrent_version_transition_days = "60"
noncurrent_version_expiration_days = "90"
tags = {
Environment = "prod"
Name = "s3-lb-log"
}
}
```
## Examples
- [Minimal](https://github.com/tmknom/terraform-aws-s3-lb-log/tree/master/examples/minimal)
- [Complete](https://github.com/tmknom/terraform-aws-s3-lb-log/tree/master/examples/complete)
## Requirements
| Name | Version |
| --------- | ------- |
| terraform | >= 0.12 |
## Providers
| Name | Version |
| ---- | ------- |
| aws | n/a |
## Inputs
| Name | Description | Type | Default | Required |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------- | ------- | :------: |
| logging_target_bucket | The name of the bucket that will receive the log objects. | `string` | n/a | yes |
| name | The name of the bucket, which must comply with DNS naming conventions. | `string` | n/a | yes |
| expiration_days | Specifies a period in the object's expire. | `string` | `"90"` | no |
| force_destroy | A boolean that indicates all objects should be deleted from the bucket so that the bucket can be destroyed without error. | `string` | `false` | no |
| glacier_noncurrent_version_transition_days | Specifies when noncurrent object versions transitions. | `string` | `"30"` | no |
| glacier_transition_days | Specifies a period in the object's Glacier transitions. | `string` | `"60"` | no |
| lifecycle_rule_enabled | Specifies lifecycle rule status. | `string` | `true` | no |
| lifecycle_rule_prefix | Object key prefix identifying one or more objects to which the rule applies. | `string` | `""` | no |
| noncurrent_version_expiration_days | Specifies when noncurrent object versions expire. | `string` | `"60"` | no |
| region | (Optional) If specified, the AWS region this bucket should reside in. Otherwise, the region used by the callee. | `string` | `""` | no |
| standard_ia_transition_days | Specifies a period in the object's STANDARD_IA transitions. | `string` | `"30"` | no |
| tags | A mapping of tags to assign to the bucket. | `map(string)` | `{}` | no |
| versioning_enabled | Enable versioning. Versioning is a means of keeping multiple variants of an object in the same bucket. | `string` | `true` | no |
## Outputs
| Name | Description |
| ------------------------ | ---------------------------------------------------------------------- |
| s3_bucket_arn | The ARN of the bucket. Will be of format arn:aws:s3:::bucketname. |
| s3_bucket_domain_name | The bucket domain name. Will be of format bucketname.s3.amazonaws.com. |
| s3_bucket_hosted_zone_id | The Route 53 Hosted Zone ID for this bucket's region. |
| s3_bucket_id | The name of the bucket. |
| s3_bucket_region | The AWS region this bucket resides in. |
## Development
### Development Requirements
- [Docker](https://www.docker.com/)
### Configure environment variables
```shell
export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_DEFAULT_REGION=ap-northeast-1
```
### Installation
```shell
git clone [email protected]:tmknom/terraform-aws-s3-lb-log.git
cd terraform-aws-s3-lb-log
make install
```
### Makefile targets
```text
apply-complete Run terraform apply examples/complete
apply-minimal Run terraform apply examples/minimal
check-format Check format code
clean Clean .terraform
destroy-complete Run terraform destroy examples/complete
destroy-minimal Run terraform destroy examples/minimal
diff Word diff
docs Generate docs
format Format code
help Show help
install Install requirements
lint Lint code
plan-complete Run terraform plan examples/complete
plan-minimal Run terraform plan examples/minimal
release Release GitHub and Terraform Module Registry
upgrade Upgrade makefile
```
### Releasing new versions
Bump VERSION file, and run `make release`.
### Terraform Module Registry
-
## License
Apache 2 Licensed. See LICENSE for full details.