🚀 Add annotations to the Workspace controller to trigger a new run

[arybolovlev]

Description

This PR adds three new annotations to the Workspace controller to trigger a new run.

• workspace.app.terraform.io/run-new
• workspace.app.terraform.io/run-terraform-version
• workspace.app.terraform.io/run-type

Tests

• https://github.com/hashicorp/terraform-cloud-operator/actions/runs/8299715723
• https://github.com/hashicorp/terraform-cloud-operator/actions/runs/8299717215

Usage Example

$ kubectl annotate workspace this \
    workspace.app.terraform.io/run-new="true" \
    workspace.app.terraform.io/run-terraform-version=1.7.2 \
    workspace.app.terraform.io/run-type=plan --overwrite

apiVersion: app.terraform.io/v1alpha2
kind: Workspace
metadata:
  annotations:
    workspace.app.terraform.io/run-new: "true"
    workspace.app.terraform.io/run-type: plan
    workspace.app.terraform.io/run-terraform-version: 1.7.2

...
status:
  observedGeneration: 1
  plan:
    id: run-H1Ttm8HEP88xTW2w
    status: planned_and_finished
    terraformVersion: 1.7.2
  runStatus:
    configurationVersion: cv-ryQ2p4c1Ro4Jy23G
    id: run-iS61fqGde6WH49Np
    outputRunID: run-iS61fqGde6WH49Np
    status: applied
...

References

• Close: https://github.com/hashicorp/terraform-cloud-operator/issues/212
• Close: https://github.com/hashicorp/terraform-cloud-operator/issues/266

Community Note

• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.
• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

[patoarvizu]

Is the intention of this feature to enable a behavior equivalent to setting queue_all_runs = true in the tfe_workspace resource of the TFE Terraform provider? Or am I misunderstanding?

I just gave this a try and I'm seeing the workspaces being created on TFC, but without any plans being automatically triggered. If I inspect the operator logs I see:

2024-03-22T21:25:19Z    ERROR   Reconcile Runs  {"workspace": {"name":"kubernetes-tfc-workspace","namespace":"tfc-operator-system"}, "msg": "failed to create a new plan run", "error": "resource not found"}
2024-03-22T21:25:19Z    ERROR   Reconcile Runs  {"workspace": {"name":"kubernetes-tfc-workspace","namespace":"tfc-operator-system"}, "msg": "failed to reconcile runs", "error": "resource not found"}
2024-03-22T21:25:19Z    ERROR   Workspace Controller    {"workspace": {"name":"kubernetes-tfc-workspace","namespace":"tfc-operator-system"}, "msg": "reconcile workspace", "error": "resource not found"}