Skip to content

Commit 8acc289

Browse files
authored
chore: update documentation based on latest terraform-docs which includes module and resource sections (#200)
1 parent 41d41ea commit 8acc289

File tree

5 files changed

+82
-9
lines changed

5 files changed

+82
-9
lines changed

.gitignore

+29-4
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,29 @@
1-
.terraform
2-
terraform.tfstate
3-
*.tfstate*
4-
terraform.tfvars
1+
# Local .terraform directories
2+
**/.terraform/*
3+
4+
# Terraform lockfile
5+
.terraform.lock.hcl
6+
7+
# .tfstate files
8+
*.tfstate
9+
*.tfstate.*
10+
11+
# Crash log files
12+
crash.log
13+
14+
# Exclude all .tfvars files, which are likely to contain sentitive data, such as
15+
# password, private keys, and other secrets. These should not be part of version
16+
# control as they are data points which are potentially sensitive and subject
17+
# to change depending on the environment.
18+
*.tfvars
19+
20+
# Ignore override files as they are usually used to override resources locally and so
21+
# are not checked in
22+
override.tf
23+
override.tf.json
24+
*_override.tf
25+
*_override.tf.json
26+
27+
# Ignore CLI configuration files
28+
.terraformrc
29+
terraform.rc

.pre-commit-config.yaml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
repos:
22
- repo: git://github.com/antonbabenko/pre-commit-terraform
3-
rev: v1.44.0
3+
rev: v1.46.0
44
hooks:
55
- id: terraform_fmt
66
- id: terraform_validate
@@ -21,6 +21,6 @@ repos:
2121
- '--args=--only=terraform_standard_module_structure'
2222
- '--args=--only=terraform_workspace_remote'
2323
- repo: git://github.com/pre-commit/pre-commit-hooks
24-
rev: v3.3.0
24+
rev: v3.4.0
2525
hooks:
2626
- id: check-merge-conflict

README.md

+10-1
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,16 @@ data "aws_ami" "ubuntu-xenial" {
105105
|------|---------|
106106
| aws | >= 2.65 |
107107

108+
## Modules
109+
110+
No Modules.
111+
112+
## Resources
113+
114+
| Name |
115+
|------|
116+
| [aws_instance](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/instance) |
117+
108118
## Inputs
109119

110120
| Name | Description | Type | Default | Required |
@@ -171,7 +181,6 @@ data "aws_ami" "ubuntu-xenial" {
171181
| tags | List of tags of instances |
172182
| volume\_tags | List of tags of volumes of instances |
173183
| vpc\_security\_group\_ids | List of associated security groups of instances, if running in non-default VPC |
174-
175184
<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
176185

177186
## Authors

examples/basic/README.md

+24-1
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,30 @@ Note that this example may create resources which can cost money. Run `terraform
2828
|------|---------|
2929
| aws | >= 2.65 |
3030

31+
## Modules
32+
33+
| Name | Source | Version |
34+
|------|--------|---------|
35+
| ec2 | ../../ | |
36+
| ec2_with_metadata_options | ../../ | |
37+
| ec2_with_network_interface | ../../ | |
38+
| ec2_with_t2_unlimited | ../../ | |
39+
| ec2_with_t3_unlimited | ../../ | |
40+
| ec2_zero | ../../ | |
41+
| security_group | terraform-aws-modules/security-group/aws | ~> 3.0 |
42+
43+
## Resources
44+
45+
| Name |
46+
|------|
47+
| [aws_ami](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/ami) |
48+
| [aws_eip](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/eip) |
49+
| [aws_kms_key](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/kms_key) |
50+
| [aws_network_interface](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/network_interface) |
51+
| [aws_placement_group](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/placement_group) |
52+
| [aws_subnet_ids](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/subnet_ids) |
53+
| [aws_vpc](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/vpc) |
54+
3155
## Inputs
3256

3357
No input.
@@ -51,5 +75,4 @@ No input.
5175
| t2\_instance\_id | EC2 instance ID |
5276
| tags | List of tags |
5377
| vpc\_security\_group\_ids | List of VPC security group ids assigned to the instances |
54-
5578
<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

examples/volume-attachment/README.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,23 @@ Note that this example may create resources which can cost money. Run `terraform
3232
|------|---------|
3333
| aws | >= 2.65 |
3434

35+
## Modules
36+
37+
| Name | Source | Version |
38+
|------|--------|---------|
39+
| ec2 | ../../ | |
40+
| security_group | terraform-aws-modules/security-group/aws | ~> 3.0 |
41+
42+
## Resources
43+
44+
| Name |
45+
|------|
46+
| [aws_ami](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/ami) |
47+
| [aws_ebs_volume](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/ebs_volume) |
48+
| [aws_subnet_ids](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/subnet_ids) |
49+
| [aws_volume_attachment](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/resources/volume_attachment) |
50+
| [aws_vpc](https://registry.terraform.io/providers/hashicorp/aws/2.65/docs/data-sources/vpc) |
51+
3552
## Inputs
3653

3754
| Name | Description | Type | Default | Required |
@@ -45,5 +62,4 @@ Note that this example may create resources which can cost money. Run `terraform
4562
| ebs\_volume\_attachment\_id | The volume ID |
4663
| ebs\_volume\_attachment\_instance\_id | The instance ID |
4764
| instances\_public\_ips | Public IPs assigned to the EC2 instance |
48-
4965
<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

0 commit comments

Comments
 (0)