Skip to content

Terraform

What is Terraform ?

Terraform gives the ability to automate provision and to manage resources in any cloud or data center in a stateful manner. It will allow us to deploy virtual machine from a customized packer template with pre-defined generic configuration.

What is Terragrunt ?

Terragrunt is a thin wrapper that provides extra tools for keeping your configurations DRY, working with multiple Terraform modules, and managing remote state.

List of supported configuration

Version is pinned in configuration file.

Hypervisors:

DNS :

How does it works ?

sequenceDiagram
    actor User
    User->>Packer: Launch Terragrunt command
    Terraform->>Hypervisor: Connect to hypervisor API,<br>upload cloud init configuration files<br>and ask hypervisor to create VM with it
    create participant VM
    Hypervisor->>VM: Create and start VM
    Terraform->>Terraform: Waiting availability of SSH server
    Terraform->>VM: SSH to the VM<br> and wait end of cloud init execution
    create participant DNS
    Terraform->>DNS: Connect to DNS API<br>and create A, AAAA (PTR are optionnals) records

Usage

Configuration is stored in terraform folder.

Fill account.hcl based on account.example.

cd terraform/prod
terragrunt run-all apply
How to execute only a part of terraform deployment ?

  • Deploy a group of machine

    Move over a subdirectory like dhcp and run the same command

  • Deploy one machine in a group

    Move over a subdirectory like dhcp/dchp1 and run the same command