From f8579ae1954fac408b4a95c952996112670d936f Mon Sep 17 00:00:00 2001 From: uwe-mayer Date: Mon, 29 Jun 2026 09:52:21 +0200 Subject: [PATCH 1/5] feat(docs): add Catalog playbook --- charts/manager/alerts/catalog.alerts | 1 + .../playbooks/catalog/catalog-not-ready.md | 70 +++++++++++++++++++ 2 files changed, 71 insertions(+) create mode 100644 docs/operations/playbooks/catalog/catalog-not-ready.md diff --git a/charts/manager/alerts/catalog.alerts b/charts/manager/alerts/catalog.alerts index 50370dda2..83af804e1 100644 --- a/charts/manager/alerts/catalog.alerts +++ b/charts/manager/alerts/catalog.alerts @@ -12,3 +12,4 @@ groups: annotations: summary: "Catalog not ready for over 15 minutes" description: "The catalog {{ $labels.catalog }} in organization {{ $labels.organization }} has not been ready for more than 15 minutes. Reason: {{ $labels.reason }}." + playbook: "docs/operations/playbooks/catalog/catalog-not-ready.md" diff --git a/docs/operations/playbooks/catalog/catalog-not-ready.md b/docs/operations/playbooks/catalog/catalog-not-ready.md new file mode 100644 index 000000000..fc49c1688 --- /dev/null +++ b/docs/operations/playbooks/catalog/catalog-not-ready.md @@ -0,0 +1,70 @@ +--- +title: "CatalogNotReady" +linkTitle: "CatalogNotReady" +landingSectionIndex: false +weight: 1 +description: > + Playbook for the GreenhouseCatalogNotReady Alert +--- + +## Alert Description + +This alert fires when a Greenhouse catalog has not been ready for more than 15 minutes. + +## What does this alert mean? + +A Catalog in Greenhouse holds the available PluginDefinitions and acts as the source of truth for which plugins can be deployed within an organization. When a catalog is not ready, it indicates that the catalog source cannot be synchronized or that the catalog controller is unable to process it correctly. + +This could be due to: + +- The catalog source (e.g. Helm repository, OCI registry) being unavailable or unreachable +- Invalid or expired credentials for accessing the catalog source +- A misconfigured catalog resource (e.g. wrong URL, invalid reference) +- The catalog controller encountering errors during reconciliation +- Network connectivity issues between the Greenhouse operator and the catalog source + +## Diagnosis + +### Get the Catalog Resource + +Retrieve the catalog resource to view its current status: + +```bash +kubectl get catalog -n -o yaml +``` + +Or use kubectl describe for a more readable output: + +```bash +kubectl describe catalog -n +``` + +### Check the Status Conditions + +Look at the `status.statusConditions` section in the catalog resource. Pay special attention to: + +- **Ready**: The main indicator of catalog health +- **SourceSynced**: Indicates whether the catalog source was successfully synchronized + +### Check Controller Logs + +Review the Greenhouse controller logs for more detailed error messages: + +```bash +kubectl logs -n greenhouse -l app=greenhouse + --tail=100 | grep -i catalog # requires permissions on the greenhouse namespace +``` + +Or access your logs sink for Greenhouse logs. + +### List All Catalogs + +Check if multiple catalogs are affected: + +```bash +kubectl get catalog -A +``` + +## Additional Resources + +- [Greenhouse Catalog Documentation](../../../../reference/components/catalog) From a0e263956d9e84af5bcf719e623ab35c0a48966f Mon Sep 17 00:00:00 2001 From: uwe-mayer Date: Mon, 29 Jun 2026 10:27:08 +0200 Subject: [PATCH 2/5] bump chart --- charts/manager/Chart.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charts/manager/Chart.yaml b/charts/manager/Chart.yaml index aec267e71..011775f69 100644 --- a/charts/manager/Chart.yaml +++ b/charts/manager/Chart.yaml @@ -16,7 +16,7 @@ type: application # This is the chart version. This version number should be incremented each time you make changes # to the chart and its templates, including the app version. # Versions are expected to follow Semantic Versioning (https://semver.org/) -version: 0.13.1 +version: 0.13.2 # This is the version number of the application being deployed. This version number should be # incremented each time you make changes to the application. Versions are not expected to From 65b08049dc5e30cd466714723782afb7d274e0a3 Mon Sep 17 00:00:00 2001 From: Uwe Mayer <115539431+uwe-mayer@users.noreply.github.com> Date: Mon, 29 Jun 2026 10:28:12 +0200 Subject: [PATCH 3/5] one line cmd Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Signed-off-by: Uwe Mayer <115539431+uwe-mayer@users.noreply.github.com> --- docs/operations/playbooks/catalog/catalog-not-ready.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/operations/playbooks/catalog/catalog-not-ready.md b/docs/operations/playbooks/catalog/catalog-not-ready.md index fc49c1688..c709caf04 100644 --- a/docs/operations/playbooks/catalog/catalog-not-ready.md +++ b/docs/operations/playbooks/catalog/catalog-not-ready.md @@ -51,8 +51,7 @@ Look at the `status.statusConditions` section in the catalog resource. Pay speci Review the Greenhouse controller logs for more detailed error messages: ```bash -kubectl logs -n greenhouse -l app=greenhouse - --tail=100 | grep -i catalog # requires permissions on the greenhouse namespace +kubectl logs -n greenhouse -l app=greenhouse --tail=100 | grep -i catalog # requires permissions on the greenhouse namespace ``` Or access your logs sink for Greenhouse logs. From 9ad8910a38067c79e59c7adf94d641f1ff35e45c Mon Sep 17 00:00:00 2001 From: uwe-mayer Date: Mon, 29 Jun 2026 11:55:56 +0200 Subject: [PATCH 4/5] use label not annotation --- charts/manager/alerts/catalog.alerts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charts/manager/alerts/catalog.alerts b/charts/manager/alerts/catalog.alerts index 83af804e1..b51352ea3 100644 --- a/charts/manager/alerts/catalog.alerts +++ b/charts/manager/alerts/catalog.alerts @@ -9,7 +9,7 @@ groups: service: '{{ $labels.catalog }}' organization: '{{ $labels.organization }}' support_group: '{{ $labels.owned_by }}' + playbook: https://cloudoperators.github.io/greenhouse/docs/operations/playbooks/catalog/catalog-not-ready/ annotations: summary: "Catalog not ready for over 15 minutes" description: "The catalog {{ $labels.catalog }} in organization {{ $labels.organization }} has not been ready for more than 15 minutes. Reason: {{ $labels.reason }}." - playbook: "docs/operations/playbooks/catalog/catalog-not-ready.md" From a39437480f7d6737ecc5d9ee6ff10b45f293b3d4 Mon Sep 17 00:00:00 2001 From: uwe-mayer Date: Tue, 30 Jun 2026 09:06:45 +0200 Subject: [PATCH 5/5] bump umbrella --- charts/greenhouse/Chart.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/charts/greenhouse/Chart.yaml b/charts/greenhouse/Chart.yaml index 754897db8..cd36792a8 100644 --- a/charts/greenhouse/Chart.yaml +++ b/charts/greenhouse/Chart.yaml @@ -5,7 +5,7 @@ apiVersion: v2 name: greenhouse description: A Helm chart for deploying greenhouse type: application -version: 0.20.2 +version: 0.20.3‚ appVersion: "v0.14.0" dependencies: @@ -18,7 +18,7 @@ dependencies: repository: "file://../cors-proxy" version: 0.10.0 - name: manager - version: 0.13.1 + version: 0.13.2 repository: "file://../manager" - condition: dashboard.enabled name: dashboard