Mauro/cluster

[MauroKinderknecht]

Summary by CodeRabbit

• New Features

  • Introduces a Terraform module to provision a DevZero cluster and install associated components via Helm.
  • Adds configurable options (cloud provider, runtime, scheduler, Prometheus, live migration, paths, and extra values).
  • Exposes outputs for cluster ID and a sensitive token.

• Documentation

  • Expands README with full module documentation: usage, requirements, providers, resources, inputs, and outputs.

• Chores

  • Adds GitHub Actions workflow to run Terraform linting on pull requests.
  • Adds .gitignore for Terraform artifacts.
  • Adds Makefile target to generate/inject docs into README.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Introduces a Terraform module to provision a DevZero cluster and deploy zxporter and devzero-operator via Helm, with variables, outputs, and provider constraints. Adds a README generated via terraform-docs, a Makefile target for docs, a .gitignore for Terraform artifacts, and a GitHub Actions workflow running TFLint on PRs.

Changes

Cohort / File(s)	Summary
CI Lint Workflow .github/workflows/lint.yaml	New GitHub Actions workflow to install and run TFLint on PRs to main, with plugin cache and rate-limit env setup.
Terraform Module Core providers.tf, variables.tf, main.tf, outputs.tf	Defines required Terraform and providers (devzero, helm); adds variables (cluster settings, runtime, toggles, extra values); provisions devzero_cluster and Helm releases (zxporter, devzero_operator) with dependencies; exposes cluster_id and sensitive cluster_token outputs; includes locals for containerd paths.
Documentation & Tooling README.md, Makefile	Replaces README with terraform-docs sections and inject markers; adds docs Makefile target invoking terraform-docs markdown table --output-file README.md --output-mode inject ..
VCS Hygiene .gitignore	Ignores Terraform directories, lock/state files, crash logs, tfvars, override files, and CLI rc files.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Dev as Developer
  participant TF as Terraform CLI
  participant DZ as devzero Provider
  participant HL as helm Provider
  participant API as DevZero API
  participant K8s as Kubernetes Cluster

  Dev->>TF: terraform apply
  TF->>DZ: create devzero_cluster (cluster)
  DZ->>API: POST /clusters
  API-->>DZ: cluster id, token
  DZ-->>TF: cluster resource (id, token)

  note over TF,HL: helm_release depends_on devzero_cluster

  TF->>HL: install release zxporter (values incl. token)
  HL->>K8s: helm install zxporter (namespace devzero)
  K8s-->>HL: release status

  TF->>HL: install release devzero_operator (values incl. config, endpoints, tokens)
  HL->>K8s: helm install dakr-operator
  K8s-->>HL: release status

  TF-->>Dev: Outputs cluster_id, cluster_token (sensitive)

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• Add cluster module #1 — Appears to introduce the same module structure and resources (devzero_cluster, zxporter, devzero_operator), outputs, and the TFLint workflow, indicating a direct code-level overlap.

Poem

A rabbit taps the Terraform drum,
Helm charts march—here they come! 🥁
Clusters bloom with zxporter’s song,
Operators hop along.
Linting skies keep clouds in line,
Docs sprout fresh—how neat, how fine.
Thump-thump: applied, and all is prime. 🐇✨

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch mauro/cluster

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d657a41 and ae619b5.

📒 Files selected for processing (8)

• .github/workflows/lint.yaml (1 hunks)
• .gitignore (1 hunks)
• Makefile (1 hunks)
• README.md (1 hunks)
• main.tf (1 hunks)
• outputs.tf (1 hunks)
• providers.tf (1 hunks)
• variables.tf (1 hunks)

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}