Skip to content

Commit a3d170e

Browse files
committed
docs: update readme file
1 parent 2d0aad8 commit a3d170e

File tree

2 files changed

+32
-104
lines changed

2 files changed

+32
-104
lines changed

.header.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
# Main
1+
# terraform-aws-security-group
22

3-
asdfadsfas
3+
Terraform module to create security groups and rules

README.md

Lines changed: 30 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -1,115 +1,43 @@
1-
# Terraform Module Template
1+
# terraform-aws-security-group
22

3-
This repository serves as a template for creating Terraform modules. It provides a structured approach to organizing and maintaining Terraform code, along with examples and best practices.
3+
Terraform module to create security groups and rules
44

5-
## Table of Contents
5+
## Requirements
66

7-
- [Prerequisites](#prerequisites)
8-
- [Usage](#usage)
9-
- [Examples](#examples)
10-
- [Module Structure](#module-structure)
7+
| Name | Version |
8+
|------|---------|
9+
| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.8.4 |
10+
| <a name="requirement_aws"></a> [aws](#requirement\_aws) | >= 5.51.0 |
1111

12-
## Prerequisites
12+
## Providers
1313

14-
Before you begin, ensure you have met the following requirements:
14+
| Name | Version |
15+
|------|---------|
16+
| <a name="provider_aws"></a> [aws](#provider\_aws) | 5.59.0 |
1517

16-
1. [install terraform](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli)
17-
2. [install pre-commit](https://pre-commit.com/#install)
18-
3. configure pre-commit: `pre-commit install`
19-
4. install required tools
20-
- [tflint](https://github.com/terraform-linters/tflint)
21-
- [terraform-docs](https://github.com/terraform-docs/terraform-docs)
18+
## Modules
2219

23-
## Usage
20+
No modules.
2421

25-
To use this template, clone the repository and customize it according to your module's requirements. Below is a quick start guide:
22+
## Resources
2623

27-
1. **Clone the repository:**
24+
| Name | Type |
25+
|------|------|
26+
| [aws_security_group.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/security_group) | resource |
27+
| [aws_vpc.default](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/vpc) | data source |
2828

29-
```sh
30-
git clone https://github.com/your-username/terraform-module-template.git
31-
cd terraform-module-template
32-
```
33-
2. **Customize the module:**
29+
## Inputs
3430

35-
- Update `main.tf`, `variables.tf`, `outputs.tf`, and `versions.tf` files as needed.
36-
- Add your own resources and logic.
37-
3. **Run Terraform commands:**
31+
| Name | Description | Type | Default | Required |
32+
|------|-------------|------|---------|:--------:|
33+
| <a name="input_description"></a> [description](#input\_description) | (Optional, Forces new resource) Security group description. | `string` | `"Managed by Terraform"` | no |
34+
| <a name="input_name"></a> [name](#input\_name) | (Optional, Forces new resource) Name of the security group. | `string` | n/a | yes |
35+
| <a name="input_tags"></a> [tags](#input\_tags) | (Optional) Map of tags to assign to the resource. | `map(string)` | `{}` | no |
36+
| <a name="input_vpc_id"></a> [vpc\_id](#input\_vpc\_id) | (Optional, Forces new resource) VPC ID. | `string` | `null` | no |
3837

39-
```sh
40-
terraform init
41-
terraform plan
42-
terraform apply
43-
```
38+
## Outputs
4439

45-
## Examples
46-
47-
This repository includes example configurations to help you understand how to use the module:
48-
49-
- **Complete Example:** Located in `examples/complete`
50-
51-
- Demonstrates a full-featured usage of the module.
52-
53-
```sh
54-
cd examples/complete
55-
terraform init
56-
terraform apply
57-
```
58-
- **Minimal Example:** Located in `examples/minimal`
59-
60-
- Shows a minimal configuration for using the module.
61-
62-
```sh
63-
cd examples/minimal
64-
terraform init
65-
terraform apply
66-
```
67-
68-
## Module Structure
69-
70-
The repository is organized as follows:
71-
72-
```plaintext
73-
.
74-
├── .editorconfig
75-
├── examples
76-
│ ├── complete
77-
│ │ ├── main.tf
78-
│ │ ├── outputs.tf
79-
│ │ ├── provider.tf
80-
│ │ ├── README.md
81-
│ │ ├── variables.tf
82-
│ │ └── versions.tf
83-
│ └── minimal
84-
│ ├── main.tf
85-
│ ├── outputs.tf
86-
│ ├── provider.tf
87-
│ ├── README.md
88-
│ ├── variables.tf
89-
│ └── versions.tf
90-
├── .github
91-
│ └── workflows
92-
│ ├── documentation.yaml
93-
│ ├── pre-commit.yaml
94-
│ └── pr-title.yaml
95-
├── .gitignore
96-
├── main.tf
97-
├── modules
98-
│ └── sample-resource
99-
│ ├── main.tf
100-
│ ├── outputs.tf
101-
│ ├── variables.tf
102-
│ └── version.tf
103-
├── outputs.tf
104-
├── .pre-commit-config.yaml
105-
├── README.md
106-
├── .terraform-docs.yml
107-
├── tests
108-
│ ├── examples_minimal.tftest.hcl
109-
│ └── unit_tests.tftest.hcl
110-
├── .tflint.hcl
111-
├── variables.tf
112-
└── versions.tf
113-
```
114-
115-
## Reference [Getoutline](https://infraspec.getoutline.com/doc/terraform-Xkko7xHwM5) Document for Conventions to follow in your module
40+
| Name | Description |
41+
|------|-------------|
42+
| <a name="output_security_group_arn"></a> [security\_group\_arn](#output\_security\_group\_arn) | The ARN of the security group |
43+
| <a name="output_security_group_id"></a> [security\_group\_id](#output\_security\_group\_id) | The ID of the security group |

0 commit comments

Comments
 (0)