Manage artifact tags

This topic describes how to add and manage tags for modules and providers hosted in your private registry.

Overview

You can assign project tags to modules and providers in the registry, which helps you consistently use metadata across entities in your system. Use tags to indicate project association, describe intended environments, and apply other meaningful labels.

Requirements

You must be on an IBM HCP Terraform standard plan to add environment tags to individual artifact versions. Refer to the pricing page for more information.

You can only assign existing tags to registry artifacts. Refer to Define project tags for instructions on creating project tags that you can assign to artifacts. For instructions on how to create registry environment tags, refer to Create and manage reserved tag keys.

The following settings must be enabled for your organization to attach tags to artifacts in the registry:

• Assign project tags to modules and providers
• Assign reserved keys to module and provider version

Attach project tags to a single registry artifact

1. Sign in to HCP Terraform and navigate to your organization.
2. Click on Registry in the sidebar, then click either Modules or Providers .
3. Click on the artifact, then click Manage tags.
4. On the Manage tags page, browse for tags that you want to attach to the artifact. You can click on the link in either the Projects or Workspaces column view the projects and workspaces that have the tag.
5. Select the tags you want to attach to the artifact, the click Submit.

Attach registry environment tags to artifact versions

When you create reserved tags for the organization, you can enable the Registry environment tag option, which lets you assign the tag to module and provider versions in the registry.

1. Sign in to HCP Terraform and navigate to your organization.
2. Click on Registry in the sidebar, then click either Modules or Providers.
3. Click on the artifact to open its detail page.
4. In the Tags section, click the link to assign an environment to the artifact version.
5. When prompted, choose the artifact version to assign the tags to from the drop-down.
6. Choose one or more environment tags, then click Assign.

HCP Terraform attaches the selected environment tags to the artifact version.