How-to check private module version status in HCP Terraform / Terraform Enterprise

Problem

When you publish a new version of a private module in HCP Terraform or Terraform Enterprise, it does not appear in the registry. This can occur due to a validation error in the Terraform configuration, an issue with the VCS connection, or a problem with the private module registry service.

This guide explains how to identify the error that prevented the module version from publishing successfully.

Procedure

To find the reason for the publishing failure, you can access the module's status page.

1. Construct the status URL for your module by using the following template. For Terraform Enterprise, replace app.terraform.io with your instance's hostname.

   https://app.terraform.io/app/<ORGANIZATION>/registry/modules/private/<ORGANIZATION>/<MODULE_NAME>/<PROVIDER>/status

   Replace the following placeholders with your specific values:

   • <ORGANIZATION>: The name of your organization.
   • <MODULE_NAME>: The name of the module.
   • <PROVIDER>: The provider for the module (e.g., aws, azurerm).

   Alternatively, you can navigate to the module in the registry and append /status to the URL in your browser's address bar.

2. Navigate to the constructed URL. This page displays the ingestion status for module versions and provides the full error message for any failures.

   

3. Review the error message to identify and resolve the issue with the module version.