TFC/TFE Project Managment with a TF Output of the Project ID

This repository documents an example workflow for managing TFC/TFE projects that has an output of the project ID.

Current Challenge

As noted in the open issue here there is currently no project_id data block for TFC projects. This could be probelematic for teams who would like to integrate projects in their workflow and require a project id for those integrations. A couple current examples of resources within the tfe provider that can leverage a project_id include tfe_workspace & tfe_team_project_access.

Solution

As shown in this repo, create all projects with the tfe provider and tfe_project resource then have a tf output for the project id, share that output within the organization, then make a call to that output for the Project ID.

Example of Leveraging Project ID Output

The below repo references the output from this workspace to create a new workspace. Most notably, it shows how to retrieve the id for a given project that was created from this repository.

https://github.com/omeeomi/tfc-project-list-test/

Considerations

• Projects created outside this workspace will not have a Project ID recorded, so projects should not be created through UI
• "default" project is pre-existing so the Project ID can not be logged in the output and used in further workflows via this solution
• To enforce all projects be created through IaC, manual project creation via the UI can be disabled
• Ideally all projects are created from a single repository to simplify things
• Workspace outputs need to be shared with other workspaces that need access to project_id
• The API token used needs to have permissions to create/manage workspaces & projects

Documentation of Terraform Code Used:

Providers

Name	Version
tfe	n/a

Resources

Name	Type
tfe_project.project	resource

Inputs

Name	Description	Type	Default	Required
hostname	Optional- defaults to Terraform Cloud app.terraform.io. Normally this is only set for self-managed TFE enviroments.	string	"app.terraform.io"	no
org_name	Name of TFC Organization.	string	n/a	yes
project_list	Name of the TFC project	list(string)	[ "ProjectX", "ProjectY", "ProjectZ" ]	no
token	Token for TFC Organization.	string	n/a	yes

Outputs

Name	Description
project_list	List of project names with corresponding project id