iac-modulo-s3
Módulo s3 para criação e manutenção de bucket na AWS S3.
Requisitos
| Name | Version |
|---|---|
| aws | ~> 3.27 |
Providers
| Name | Version |
|---|---|
| aws | 3.75.1 |
Recursos
| Name | Type |
|---|---|
| aws_s3_bucket.my_bucket | resource |
| aws_s3_bucket_acl.acl_bucket | resource |
| aws_s3_bucket_logging.s3_log | resource |
| aws_s3_bucket_public_access_block.policy_s3 | resource |
| aws_s3_bucket_versioning.versioning_example | resource |
Inputs
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| acl | ACL aplicada ao bucket | string |
"private" |
no |
| bucket_name | Nome do bucket | string |
n/a | yes |
Outputs
| Name | Description |
|---|---|
| this_s3_bucket_acl | The acl applied to this bucket |
| this_s3_bucket_id | The id of this bucket. |
| this_s3_bucket_region | The aws region of this bucket |
Como utilizar o módulo
No diretório examples/ podem ser encontrados exemplos de utilização, incluindo instruções de como executá-los.
Mas para adiantar um exemplo simples, a utilização do módulo pode ser feita da seguinte maneira:
- Criação de um bucket com ACL private
module "s3_bucket" {
source = "github.com/marcelomansur/iac-modulo-s3"
bucket_name = "my-private-bucket"
}Como testar o módulo
No diretório tests/ podem ser encontrados os testes automatizados do módulos, usando terratest + localstack.
Para testar, executar comandos pelo Makefile:
$ make localtest-private-bucket # Executa teste de criação de um bucket privado
$ make localtest-public-bucket # Executa teste de criação de um bucket público
É necessário ter o Go >= 1.15 e Docker >= 20.10.5 para execução dos testes localmente.
TODO
- Criar novos recursos no módulo (policy, tags, etc)
- Adicionar mais exemplos (cenários de utilização do módulo)
- Adicionar mais testes em cada cenário de utilização
- Criar pipeline CI com testes automatizados (terratest + localstack)