HCP Terraform Workspaces Factory

Code which manages configuration and life-cycle of the HCP Terraform workspaces factory. It is designed to be used from a dedicated API-Driven HCP Terraform workspace that would provision and manage the configuration using Terraform code (IaC).

Workspace creation and management is facilitated through a no-code module. Each no-code module must be provisioned within the dedicated project to ensure proper variable input configuration and management.

Permissions

HCP Terraform Permissions

To manage resources, provide a user token from an account with appropriate permissions. This user should have the Manage Projects, Manage Workspaces, Manage Teams, Manage Membership, and Manage Organization Access permission. Alternatively, you can use a token from a team instead of a user token.

Authentication

HCP Terraform Authentication

The HCP Terraform provider requires a HCP Terraform/Terraform Enterprise API token in order to manage resources.

There are several ways to provide the required token:

• Set the token argument in the provider configuration. You can set the token argument in the provider configuration. Use an input variable for the token.
• Set the TFE_TOKEN environment variable. The provider can read the TFE\_TOKEN environment variable and the token stored there to authenticate.

Features

• Manages configuration and life-cycle of HCP Terraform resources:
  • Project
  • Variable Set
    • Variables
  • Teams
    • Team token

Documentation

Requirements

The following requirements are needed by this module:

• terraform (>= 1.13.0)

• tfe (~>0.70)

Modules

The following Modules are called:

workspaces_factory_team_hcp

Source: app.terraform.io/benoitblais-hashicorp/team/tfe

Version: 1.0.1

Required Inputs

The following input variables are required:

organization_name

Description: (Required) Name of the organization.

Type: string

Optional Inputs

The following input variables are optional (have default values):

project_description

Description: (Optional) A description for the project.

Type: string

Default: null

project_name

Description: (Optional) Name of the project.

Type: string

Default: "Terraform Workspaces Factory"

project_tags

Description: (Optional) A map of key-value tags to add to the project.

Type: map(string)

Default: null

Resources

The following resources are used by this module:

• tfe_project.this (resource)
• tfe_variable.organization (resource)
• tfe_variable.tfe_token (resource)
• tfe_variable_set.this (resource)

Outputs

No outputs.