Repository files navigation

Terraform GUI is a web application that allowsdevelopers andDevOps begginers to learn aboutTerraform, an open-source,Infrastructure as Code, software tool created byHashiCorp.

The main goal of this is tool is tomake Terraform understandable for everyone, with adifferent approach from the original HCL file structure.

This tool provides:

• Graphical User Interface withcell representation of web ressources of providers
• Ressources forms for templatingHCL files
• Terraform HCL file generation forprovider, ressources, variables, outputs [...] used for deployment
• ZIP downloaded solution for planning and applying Terraform files

• Terraform GUI
  • I - Introduction
  • II - Table of content
  • III - Folder structure
  • IV - Project setup
    • A - Stack
    • B - Makefile
  • V - CI/CD, release and container registry
    • A - CI
    • B - CD
  • VI - License

The structure of this project followsthese conventions.

• /.github: Conventions, template, labels, ci, cd, settings
• /api: Symfony API files
• /build: Dockerfiles
• /deploy: Deployment-related Terraform files
• /docs: Swagger documentation
• /samples: Terraform samples for usecase
• /web: ReactJS web files

The project useDocker andDocker Compose to build and run local and distant images in our workspace.

All the images use thesame network, more informations atdocker-compose.yml

API documentation:https://terraform-gui.github.io/terraform-gui/

make setup-env start logs

Display informations about other commands.

Setup the API,start containers &output logs in terminal.

Up the containers withfull cache reset to avoid cache errors.

Down the containers.

Display and follow the logs.

API-related commands

TheCI workflow is located at.github/workflows/web.ci.yml. It's triggered ateach push in /web folder onall branches.

It consist of:

• install Node on the VM
• get the dependanciesusing the cache of other Actions run
• install deps
• build the application

TheCD workflow is triggered aeach push onmain branches (main/dev/ops).

It consist of:

• login into the GitHub container registry (ghcr.io)
• build and push the Docker images using theproduction DockerfileAfter that, you can check thepushed container here:https://github.com/orgs/Terraform-GUI/packages?repo_name=terraform-gui

UnderMIT license.