mikelv702 / simple-terraform-backend

This is a simple Terraform http backend built with FastAPI.

Terraform FastAPI Backend

This project implements a custom HTTP backend for Terraform using FastAPI. It provides endpoints for state management and locking, allowing Terraform to store and retrieve state information, as well as implement state locking for concurrent operations.

Features

• Store and retrieve Terraform state
• Implement state locking mechanism
• Compatible with Terraform's HTTP backend

Requirements

see requirements.txt

Installation

1. Clone this repository:

git clone [email protected]:mikelv702/simple-terraform-backend.git

2. Install the required packages:

uv pip install -r requirements.txt

Usage

1. Start the FastAPI server:

cd src/
fastapi dev main.py

2. Configure Terraform to use this backend:

terraform {
  backend "http" {
    address = "http://localhost:8000/tfstate/${PROJECT_ID}"
    lock_address = "http://localhost:8000/tfstate/${PROJECT_ID}/lock"
    unlock_address = "http://localhost:8000/tfstate/${PROJECT_ID}/lock"
  }
}

3. Use Terraform as normal. The state will be stored and retrieved from your FastAPI backend.

Note

This is a basic implementation and should not be used in production without further security measures and persistent storage solutions.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.

simple-terraform-backend's Issues

Multiple State Files

Is your feature request related to a problem? Please describe.
No

Describe the solution you'd like
User should be able to save multiple state files for different terraform projects or environments

Describe alternatives you've considered
None

Additional context
N/A