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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4f41dc19752345966cef39ec63e7532bc036fe6bc81ebe8f5c9574ec4a2cc8c |
|
MD5 | 351ccf44e7daa1725dd3cfb723ee03d8 |
|
BLAKE2b-256 | dddf256e0df942047bf86d3db6befec9e70b190449ae50fa3d938eccbf63ee97 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8701794e7fb5a7110caf1e404cb747d1f0ec05f0cf5ff257f3f3db92686cec22 |
|
MD5 | 33fd4fabb5639942ec12c3d7323487ea |
|
BLAKE2b-256 | 41fb78f7bb2b7958abe400b4060e55320c60c63deb6d9b396975f44ebe71c6d8 |