Skip to main content

PyPI Python Version License

Read the documentation at https://tf-restore-helper.readthedocs.io/ Tests Codecov

pre-commit Black

Features

  • Constructs Terraform import commands to assist an operator aligning a terraform state after volume restores have taken place by an external tool, which results in terraform misalignment.

  • Tool is currently only compatible with AWS volumes (PRs welcome) and is used at own risk. Operators that do not understand the terraform state file or what the produced commands will do, should not use this tool as a helper and proper state backup and recovery procedures should be well understood before making use of this.

Installation

You can install Tf Restore Helper via pip from PyPI:

$ pip install tf-restore-helper

Usage

Please see the Command-line Reference for details.

Examples of usage:

> tf-restore-helper --planfile tests/assets/plan.json
 2021-05-03 13:28:43 sbpltc1nplvdl botocore.credentials[79705] INFO Found credentials in environment variables.
 2021-05-03 13:28:46 sbpltc1nplvdl postrestoretfcli[79705]   WARNING THIS INFORMATION SHOULD BE USED ONLY IF YOU KNOW WHAT YOU ARE DOING!
 -----------Terraform volume alignment commands-----------
 terraform state rm "aws_ebs_volume.test-instance-volume-1"
 terraform state rm "aws_volume_attachment.test-instance-volume-1"

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Tf Restore Helper is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.

Metadata

Release files for tf-restore-helper 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tf-restore-helper 0.1.1
File Size Uploaded
tf-restore-helper-0.1.1.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tf-restore-helper 0.1.1
File Interpreter ABI Platform
tf_restore_helper-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 15.1 kB

Release files / tf-restore-helper-0.1.1.tar.gz

Download URL tf-restore-helper-0.1.1.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
19661f590c0fd442b8715dba99fd7ece6bf78e7d5e1e28437fd8e4b74b9e4533
BLAKE2b-256 checksum
How to use checksums
9d25273bbab863f07d436e361452b125ad5d1662e03250d7daed23a56504e7e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Release files / tf_restore_helper-0.1.1-py3-none-any.whl

Download URL tf_restore_helper-0.1.1-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49f3a86b82e86557c284cb89b7c0bfb342b348f018bc86d72580e54ab6d08f16
BLAKE2b-256 checksum
How to use checksums
eba9dca137b4f467863517729831758e21401b27d2f5804453a4dfe4a649e07b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page