Atlantis official document and latest release version are not in sync

[WSMathias]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request. Searching for pre-existing feature requests helps us consolidate datapoints for identical requirements into a single place, thank you!
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

---

Overview of the Issue

Atlantis documentation at https://www.runatlantis.io/docs/repo-level-atlantis-yaml is ahead of the latest release available.

Reproduction Steps

As shown in the documentation, terraform_distribution can be configured for any project.
the #5167) that added this feature has been merged to the master but is not part of the latest release v0.32.0

Logs

atlantis.yaml

version: 3
autodiscover:
  mode: enabled
projects:
  - name: steampipe
    dir: somedir
    workspace: default
    terraform_distribution: opentofu
    terraform_version: 1.9.0

atlantis log

January 28, 2025 at 15:52 (UTC+5:30)
	
January 28, 2025 at 15:52 (UTC+5:30)
	
{"level":"error","ts":"2025-01-28T10:22:56.708Z","caller":"events/pull_updater.go:18","msg":"parsing atlantis.yaml: yaml: unmarshal errors:\n line 8: field terraform_distribution not found in type raw.Project","json":{"repo":"********","pull":"34"},"stacktrace":"github.com/runatlantis/atlantis/server/events.(*PullUpdater).updatePull\n\tgithub.com/runatlantis/atlantis/server/events/pull_updater.go:18\ngithub.com/runatlantis/atlantis/server/events.(*PlanCommandRunner).runAutoplan\n\tgithub.com/runatlantis/atlantis/server/events/plan_command_runner.go:91\ngithub.com/runatlantis/atlantis/server/events.(*PlanCommandRunner).Run\n\tgithub.com/runatlantis/atlantis/server/events/plan_command_runner.go:305\ngithub.com/runatlantis/atlantis/server/events.(*DefaultCommandRunner).RunAutoplanCommand\n\tgithub.com/runatlantis/atlantis/server/events/command_runner.go:231"}
	
atlantis
January 28, 2025 at 15:52 (UTC+5:30)
	
{"level":"error","ts":"2025-01-28T10:22:56.013Z","caller":"events/instrumented_project_command_builder.go:75","msg":"Error building auto plan commands: parsing atlantis.yaml: yaml: unmarshal errors:\n line 8: field terraform_distribution not found in type raw.Project","json":{},"stacktrace":"github.com/runatlantis/atlantis/server/events.(*InstrumentedProjectCommandBuilder).buildAndEmitStats\n\tgithub.com/runatlantis/atlantis/server/events/instrumented_project_command_builder.go:75\ngithub.com/runatlantis/atlantis/server/events.(*InstrumentedProjectCommandBuilder).BuildAutoplanCommands\n\tgithub.com/runatlantis/atlantis/server/events/instrumented_project_command_builder.go:26\ngithub.com/runatlantis/atlantis/server/events.(*PlanCommandRunner).runAutoplan\n\tgithub.com/runatlantis/atlantis/server/events/plan_command_runner.go:86\ngithub.com/runatlantis/atlantis/server/events.(*PlanCommandRunner).Run\n\tgithub.com/runatlantis/atlantis/server/events/plan_command_runner.go:305\ngithub.com/runatlantis/atlantis/server/events.(*DefaultCommandRunner).RunAutoplanCommand\n\tgithub.com/runatlantis/atlantis/server/events/command_runner.go:231"}

GitHub comment by atlantis

Plan Error

parsing atlantis.yaml: yaml: unmarshal errors:
  line 8: field terraform_distribution not found in type raw.Project

Environment details

• Atlantis version: v0.32.0
• Deployment method: ecs

[dosubot]

Hello, @WSMathias! I'm here to help you with any bugs, questions, or contributions you have. Let's work together to resolve the issue you've encountered.

The issue you're encountering is due to the terraform_distribution field not being supported in Atlantis version v0.32.0. Although the feature was merged into the master branch, it hasn't been included in the latest release. The validation function in the code only recognizes "terraform" and "opentofu" as valid values for this field, and any other value will cause an error ^[1].

To resolve this, you can either wait for a new release that includes this feature or build Atlantis from the master branch where the feature is already merged.

To continue talking to Dosu, mention @dosu.

---

^{Help Dosu learn! Give it feedback: Great Response | Irrelevant Answer | Incorrect Sources | Too Verbose | Hallucination | Other}

[abborg]

This issue may be resolved after the release of v0.33.0 as mentioned in #5299.

[obscurerichard]

It looks to me as if this is resolved as of v0.33.0 - the latest version now supports terraform_distribution.

Update: I've personally tested this feature with v0.33.0 and it works beautifully.