Workspace run remains in a pending state

Problem

A run initiated in an HCP Terraform or Terraform Enterprise workspace remains in a pending state indefinitely and does not proceed.

Cause

Starting with Terraform Enterprise v202202-1 and in HCP Terraform, enforcement of valid workspace tag names has been added. Tags must start and end with an alphanumeric character. If a workspace contains invalid tags that were created prior to this enforcement, any new runs will remain in a pending state until you remove the invalid tags.

The updated tag name requirements are as follows:

Tag names must include only letters, numbers, colons, hyphens, and underscores, and must begin and end with an alphanumeric character.

Solution

To resolve this issue, you must identify and remove any invalid tags from the affected workspace.

Procedure

1. Navigate to the affected workspace's settings page. The URL is structured like https://app.terraform.io/app/$ORGANIZATION_NAME/workspaces/$WORKSPACE_NAME.
2. Locate the Tags section on the right side of the page.
3. Identify any tags that do not comply with the naming requirements. Delete each invalid tag by clicking the x next to its name.
4. After you remove the invalid tag, the pending run should change its state and begin to process.
5. If the run's state does not change, cancel the pending run and queue a new one.

To manage and remove invalid tags across your entire organization, navigate to the Tag Management page at https://app.terraform.io/app/$ORGANIZATION_NAME/settings/tags.

Additional Information

• For additional assistance please contact HashiCorp Support to request additional assistance.