mentoriaiac / iac-groundwork

Repositório usado para rodar o pipeline de IaC que irá construir o groundwork na cloud

Template Modulo Terraform

Este repositorio deve conter a estrutura básica para a criação de uma modulo do terraform.

$ module-example/

|--- main.tf
|--- variable.tf
|--- outputs.tf
|--- version.tf

Esses são os nomes de arquivos recomendados para um modulo mínimo, mesmo se estiverem vazios.

main.tf deve ser o ponto de entrada principal. Para um modulo simples, pode ser aqui que todos os recursos que são criados. Para uma modulo complexo pode ser divido em varios arquivos.

variables.tf e outputs.tf deve conter as declarações das variaves e as saidas respectivamente.

versions.tf deve contem as versões dos recursos/provedores

Requirements

Name	Version
Terraform	>= 0.13.0

Providers

Name	Version
local	n/a

Resources

Name	Type
local_file	resource
local_file	data source

Inputs

Name	Description	Type	Default	Required
ferramenta_1	exemplo de variavel	string	"terraform"	no
ferramenta_2	exemplo de variavel	string	"ansible"	no
programa	exemplo de variavel	string	"mentoria-iac"	no

Outputs

Name	Description
ferramentas	exemplo de saida

Testar localmente

Aqui você descreve como a pessoa que utilizar esse módulo pode testar localmente. Coloque todos os detalhes necessários para executar localmente.

Exemplos

A pasta how-to-use-this-module contém exemplos de utilização do módulo. Esta abordagem é interessante para auxiliar na exeperiência de quem for utilizar este módulo no futuro. Já foi criado um arquivo terraform chamado terrafile.tf e ele deve ser usado como referência pra colocar dentro deste diretório de exemplos.

iac-groundwork's Issues

Adicionar o output do Terraform plan no PR

Objetivo: Precisamos que o plano de execução do Terraform seja adicionado como comentário do PR.

Pode ser usado como referência: https://github.com/nerdtux/iac-modulo-rede-gcp/blob/main/.github/workflows/ci_plan.yml#L68

DoD:

• PR aberto com o output do terraform plan nos comentários.

O PR precisa ter um fluxo específico

DoD:

• PR tem um fluxo próprio que testa tudo que for possível, ou seja, tudo que não precisa de segredos do pipeline

Validar se PR de fork consegue usar o secret

Objetivo: Precisamos validar se um PR a partir de um fork consegue consumir as secrets no pipeline deste projeto.

DoD:

• PR aberto que consiga executar um terraform plan autenticado no GCP da Mentoria.

Aplicar modelo de apply com base no release

Objetivo: Precisamos aplicar modelo de execução do terraform apply com base na publicação de novos releases via tag.

DoD:

• Criar uma nova release que execute um pipeline com terraform apply.

Atualizar a versão do provider Google

DoD

• A versão do provider da GCP utilizada é >= 5.31.1.