Overview
This article explains the "nomad address must be set" error that occurs when installing Terraform Enterprise (TFE) on a Nomad Enterprise cluster. The issue typically affects users attempting to install Terraform Enterprise on Nomad Enterprise clusters. To resolve the error, you must ensure that Terraform Enterprise and Nomad Enterprise are running compatible versions.
Error Message
[ERROR] terraform-enterprise: check failed: name=config duration="42.294µs" err="nomad address must be set","component":"terraform-enterprise"
This error occurs when Terraform Enterprise fails to configure properly with a Nomad Enterprise cluster due to incorrect or missing configuration parameters.
Root Cause
The error is triggered by an incompatibility between older Terraform Enterprise versions and Nomad Enterprise. Specifically:
- TFE versions prior to v202408-1 have a known issue causing them to fail when integrating with Nomad.
- This issue affects environments using Nomad versions older than 1.5.0+ent.
Affected Versions
- Terraform Enterprise Versions: Any version below v202408-1.
- Nomad Enterprise Versions: Ensure that Nomad is v1.5.0+ent or newer.
Starting with Terraform Enterprise v202408-1, the issue has been fixed, ensuring smooth communication between Terraform Enterprise and Nomad Enterprise.
Solution
To permanently resolve the "nomad address must be set" error, you need to:
- Upgrade Terraform Enterprise to v202408-1 or later.
- Ensure that Nomad Enterprise is running version 1.5.0+ent or newer.
By updating both Terraform Enterprise and Nomad Enterprise to compatible versions, you can eliminate this error and ensure proper functionality.
Validation
After upgrading, validate the following:
- Check the Terraform Enterprise logs to ensure the error no longer appears.
- Test a simple job deployment to verify that Terraform Enterprise can communicate successfully with the Nomad cluster.
Conclusion
The "nomad address must be set" error results from a version incompatibility between Terraform Enterprise and Nomad Enterprise. To resolve the issue:
- Ensure Terraform Enterprise is updated to v202408-1 or later.
- Verify that Nomad Enterprise is running v1.5.0+ent or newer.
This compatibility fix will allow Terraform Enterprise to integrate properly with Nomad and eliminate the configuration error.