Implement pipeform for Terraform Operations

[osterman]

Describe the Feature

Improve the console DX of terraform operations by presenting the user with a friendly UI to show terrafom progress.

https://github.com/magodo/pipeform

Expected Behavior

Running atmos terraform plan and atmos terraform apply will launch the pipeform UI. Note, this does not require pipeform to be installed, as it will be used as a native Go module.

Use Case

On the command line, the output from terraform is overwhelming and doesn't convey the overall progress of the operation. Terraform will feel much friendlier if we present the user with a progress indicator.

Describe Ideal Solution

The UI would be enabled by default, but can be disabled via the atmos.yaml configuration.

# atmos.yaml
terraform:
  ui:
    enable: [plan, apply]

pipeform.mp4

Requirements:

• If no TTY is attached, the UI should be automatically disabled
• If the CI=true environment variable is set, then UI should be automatically disabled
• If the --no-ui flag is explicitly passed, then the UI should be disabled.

Alternatives Considered

No response

Additional Context

The pipeform library is licensed MPL2 and is not currently implemented as a Go module. We've contacted the @magodo (author) and he said he would accept a PR converting it to a library. As part of this implementation, we will need to first open a PR for that work.

[suzuki-shunsuke]

pipeform is interesting, but honestly I'm not sure if we should really use this by default.
I tried pipeform a bit.
When we use pipeform, the plan result doesn't output in the terminal.

$ terraform plan -json | pipeform
# No output

I think this is inconvenient.
I'm not sure if we can convert the output of terraform plan -json to the conventional terraform output.

Furthermore, seems like we can't show the detail of changes.
I expected that we can choose a resource and show its detail, but seems like we can't.

By the way, the final view of terraform plan -json | pipeform looks strange.
I think we can contribute to pipeform.

pipeform shows nothing. This confused me.
I found I needed to move page by h and l key.

[osterman]

pipeform is interesting, but honestly I'm not sure if we should really use this by default. I tried pipeform a bit. When we use pipeform, the plan result doesn't output in the terminal.

$ terraform plan -json | pipeform
# No output

This sounds like a bug in pipeform. Per the docs, it says it's supported.

the following terraform commands are supported:

terraform refresh -json
terraform plan -json
terraform apply -auto-approve -json

---

Furthermore, seems like we can't show the detail of changes. I expected that we can choose a resource and show its detail, but seems like we can't.

This would definitely be a welcome enhancement. It would likely benefit your tooling for terraform as well. We can sponsor this development in pipeform, if you're interested.

---

By the way, the final view of terraform plan -json | pipeform looks strange. I think we can contribute to pipeform.

Yes, this is not good. It should probably work the way you described above, allowing individual resources to be expanded. They shouldn't "disappear".

---

Ideal World

• When using pipeform, raw terraform logs are written to disk, allowing further inspection upon failure
• The UI would enable inspection of any resource
• A flag like --ui=false would disable the UI on a per-run basis.
• When a TTY is not detected, or we're in CI (env), then UI is disabled

[suzuki-shunsuke]

This sounds like a bug in pipeform. Per the docs, it says it's supported.

Really? I can't find the docs.
In my envrionment, TUI is shown, but after TUI quits, no output is shown in the terminal.