Network infrastructure

About

Network infrastructure describes network related resources involved to set up Marc Gavanier personal website.

This repository is NOT required for local development.

Table of contents

• 🪧 About
• 📦 Prerequisites
• 🚀 Installation
• 🛠️ Usage
• 🤝 Contribution
• 🏗️ Built with
• 📝 Licence

Prerequisites

• Docker or Terraform CLI

Installation

The following command allows to use the Terraform command line via Docker:

docker run --rm -it --name terraform -v ~/:/root/ -v $(pwd):/workspace -w /workspace hashicorp/terraform:light

For simplified use, you can create an alias:

alias terraform='docker run --rm -it --name terraform -v ~/:/root/ -v $(pwd):/workspace -w /workspace hashicorp/terraform:light'

Using this alias, there is no longer any difference between a terraform command executed via Docker or via Terraform CLI.

Usage

Check and fix .tf files format

terraform fmt

Verify ressources consistency

terraform validate

Retrieve Terraform Cloud authentication token locally

terraform login

Initialize state and plugins locally

terraform init

Plan a run to check differences between the current and the next infrastructure state to be deployed

terraform plan

Contribution

Apply the next state of the infrastructure

Simply push the changes to the main branch, to apply the next state of the infrastructure in production.

Built with

Langages & Frameworks

• Terraform is an infrastructure as code software tool that allow to define and provide infrastructure using a declarative configuration language

Tools

CI

• Github Actions is the continuous integration and deployment tool provided by GitHub
  • Deployment history is available under Actions tab
• Repository secrets:
  • TF_API_TOKEN: Terraform Cloud API token which allows the CI to operate actions on Terraform Cloud

Deployment

• Terraform Cloud is a cloud platform provided by HashiCorp to host Terraform infrastructure state and apply changes
  • Organization : marc-gavanier
  • Workspaces : marc-gavanier-network-*
    • marc-gavanier-network-production
• AWS is a cloud provider platform provided by Amazon
  • User : marc-gavanier.infrastructure.network
  • Group : network.deployer

Licence

See LICENSE.md file in this repository.