project.md

Project

Project controller allows managing Terraform Cloud Projects via Kubernetes Custom Resources.

Please refer to the CRD and API Reference to get the full list of available options.

Below is a basic example of a Project Custom Resource:

apiVersion: app.terraform.io/v1alpha2
kind: Project
metadata:
  name: this
spec:
  organization: kubernetes-operator
  token:
    secretKeyRef:
      name: tfc-operator
      key: token
  name: project-demo

Once the above CR is applied, the Operator creates a new project project-demo under the kubernetes-operator organization.

The example can be extended with team access permission support:

apiVersion: app.terraform.io/v1alpha2
kind: Project
metadata:
  name: this
spec:
  organization: kubernetes-operator
  token:
    secretKeyRef:
      name: tfc-operator
      key: token
  name: project-demo
  teamAccess:
  - team:
      name: demo
    access: admin

The team demo will get Admin permission group access to workspaces under the project project-demo.

If you have any questions, please check out the FAQ.

If you encounter any issues with the Project controller please refer to the Troubleshooting.