Skip to main content

Configure, generate and apply Terraform modules to create and destroy Cloud Infrastructure

Project description

terragen

Terragen is a framework for generating and automatically applying Terraform modules to simplify the management of sophisticated Cloud Architectures

Key Features

  • Simplify the creation and destruction of infra across multiple accounts and regions, using one command
  • Fine grained CLI control, all config elements can be overridden on the CLI
  • View generated Terraform files before they are applied. Each run creates a timestamped output directory
  • Control common and app specific infra separately. Infra that is shared, eg VPCs, Databases can be controlled separately but still referenced by app specific infra
  • Create default config files you can "sub-class" for specific implementations, allows you to enforce config patterns across your estate
  • Boiler plate Terraform files, like config, tfvars automatically generated
  • Variable interpolation. You can lookup values from other config files.

Installing

Terragen can be installed via pip:

pip install terragen

ReadTheDocs

Full details on configuring and running Terragen on ReadTheDocs

Terragen Workspace

Terragen expects to be run in its own workspace containing its configuration and the Terraform modules you want to configure and apply.

Demo Commands

Once configured as defined in docs, Terragen is very powerful. Below we demonstrate some commands

Applying a Named Config

Terragen lets you define multiple apps and configs, just apply them by name

terragen --config-dir ./config --config-name sandbox

Specifying the environment we want to deploy to

Terragen lets you create the same infrastructure across multiple accounts by supplying the environment you want to deploy to

terragen --config-dir ./config build.environment=test

Debugging

Validate and resolve your config before you run it.

terragen -cd ./config --cfg job --resolve

Verbose debugging

You can enable verbose debug logging by passing the following:

terragen -cd ./config hydra.verbose=true

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

terragen-0.4.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

terragen-0.4.0-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

Details for the file terragen-0.4.0.tar.gz.

File metadata

  • Download URL: terragen-0.4.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for terragen-0.4.0.tar.gz
Algorithm Hash digest
SHA256 f4f41dc19752345966cef39ec63e7532bc036fe6bc81ebe8f5c9574ec4a2cc8c
MD5 351ccf44e7daa1725dd3cfb723ee03d8
BLAKE2b-256 dddf256e0df942047bf86d3db6befec9e70b190449ae50fa3d938eccbf63ee97

See more details on using hashes here.

File details

Details for the file terragen-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: terragen-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 12.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for terragen-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8701794e7fb5a7110caf1e404cb747d1f0ec05f0cf5ff257f3f3db92686cec22
MD5 33fd4fabb5639942ec12c3d7323487ea
BLAKE2b-256 41fb78f7bb2b7958abe400b4060e55320c60c63deb6d9b396975f44ebe71c6d8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page