A wrapper around terraform state commands.
tfstate provides simple guard rails and automatic backup recovery when running state commands.
Usage:
tfstate [flags]
tfstate [command]
Available Commands:
backup Backup the current state file
help Help about any command
mv A wrapper around terraform state mv
rm A wrapper around terraform state rm
rollback Rollback to an earlier State file version
Flags:
-h, --help help for tfstate
-v, --version get the current version of tfstate and terraform
tfstate is a wrapper around terraform state commands which alter the state file, such as terraform state mv and terraform state rm
tfstate automatically generates a backup inside .terraform/tfstate/* allowing for easy rollback if a mistake was made. This is possible due to the wrapper, by first performming a backup of the current state file, then running tfstate rollback --latest
tfstate adds a manual confirmation step, which also lists the possible resources affected by the requested state command.
Example:
resource "null_resource" "main" {}
resource "null_resource" "deps" {
depends_on = [null_resource.main]
}Running tfstate rm null_resource.main generates an ouptut containing a list of resources affected by the command, such as:
null_resource.deps
... Affected resources: 1
tfstate is a small wrapper around terraform state. To run the tool, simply use tfstate instead of terraform state for the following commands:
terraform state mv->tfstate mvterraform state rm->tfstate rm
You may also create a backup of your state file
tfstate backup
To rollback to a specific state file, you must first have ran your terraform state rm/mv using tfstate, as tfstate generates backups in .terraform/tfstate
Select a state file in .terraform/tfstate to rollback to
tfstate rollback state-0-123456.json
You may download the latest binary by visitng the tags and downloading the artifact. The zip file contains binary builds for Windows and Darwin machine types. Other architectures such as linux has not been tested yet but I'll get to it soon!