diff --git a/README.md b/README.md index c4c1735..e8773fe 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,18 @@ What might you use this for? We're not entirely sure. It definitely accesses inf - Use the backend configuration to create a `provider` that has the same permissions/access as the internal provider Terraform uses for the backend - Using a provider with the backend configuration, combined with data about where the state is stored (e.g. which S3 bucket and object) to load the raw state data for use in the configuration (be warned, this is a MAJOR hack) +Current state: +- The backend config should work for all backend types and workspace settings +- The `output_state` should work for all backend types and workspace settings +- The `raw_state` should work for `S3` and `local` backend types (for `local` backends, `terraform plan` and `terraform apply` must be run with `-lock=false`) + Usage: ``` module "backend_config" { source = "Invicton-Labs/backend-config/null" - fetch_state = true + fetch_output_state = true + // Currently only supported for S3 and local backends + fetch_raw_state = false } output "backend_config" { @@ -31,9 +38,10 @@ backend_config = { ... } } - "state" = { + "output_state" = { // Equivalent output to the terraform_remote_state data source's `outputs` field } + "raw_state" = null "workspace" = "myworkspace" } ```