stewartshea
0d2508b599
Iteration 1 validation surfaced two bugs in runwhen-local 0.11.0 that
prevent cluster-scoped CRDs (like Crossplane GCP Buckets) from being
discovered:
1. NameError: KubernetesResourceTypeSpec is not defined
(kubeapi.py:1125 references a symbol never imported)
2. list_namespaced_custom_object returns 404 for cluster-scoped CRDs
(the loop always calls the namespaced API path)
Added docs/08-current-limitations.md with symptoms, causes, and
one-line / small-patch proposed fixes for both. Updated the iteration
checklist in docs/07 to reflect this and added the missing docs entry
to the top-level README.
Co-authored-by: Cursor <cursoragent@cursor.com>
58 lines
2.4 KiB
Markdown
58 lines
2.4 KiB
Markdown
# simple-private-codecollection
|
||
|
||
An **educational, generation-rule-only** RunWhen CodeCollection. It ships **no**
|
||
Robot Framework code of its own — instead it teaches how a private repository
|
||
can define **discovery rules** and **SLX templates** that reuse a generic
|
||
runtime already loaded by the RunWhen runner (in this case
|
||
[`k8s-kubectl-cmd`](https://github.com/runwhen-contrib/rw-generic-codecollection/tree/main/codebundles/k8s-kubectl-cmd)
|
||
from `rw-generic-codecollection`).
|
||
|
||
## What it demonstrates
|
||
|
||
- How **workspace-builder** discovers a Kubernetes **Custom Resource** (a
|
||
Crossplane `Bucket` from the Upbound GCP provider) via a generation rule.
|
||
- How the resulting SLX points its `codeBundle.repoUrl` at a **different**
|
||
code collection where the runtime actually lives.
|
||
- How to compute a fractional **SLI** (0.0–1.0) from
|
||
`.status.conditions[]` with `jq`, and how to emit a **detailed
|
||
TaskSet** with per-condition issues via `RW.DynamicIssues`.
|
||
|
||
## Layout
|
||
|
||
```
|
||
codebundles/
|
||
gcp-bucket-crossplane-health/ # rules + templates only, no *.robot
|
||
.runwhen/
|
||
generation-rules/gcp-bucket-crossplane-health.yaml
|
||
templates/
|
||
gcp-bucket-crossplane-health-slx.yaml
|
||
gcp-bucket-crossplane-health-sli.yaml
|
||
gcp-bucket-crossplane-health-taskset.yaml
|
||
docs/
|
||
01-overview.md
|
||
02-generation-rules-only-pattern.md
|
||
03-crossplane-crd-discovery.md
|
||
04-generation-rule-walkthrough.md
|
||
05-slx-and-templates.md
|
||
06-runner-integration.md
|
||
07-validate-and-observe.md
|
||
08-current-limitations.md
|
||
images/ # screenshots referenced from the chapters
|
||
```
|
||
|
||
## Start here
|
||
|
||
Open [`docs/01-overview.md`](docs/01-overview.md) and read the chapters in
|
||
order. Each chapter has a short "What you'll do" preamble, an inline diagram
|
||
or code snippet, and screenshot placeholders that we fill in as we iterate.
|
||
|
||
## Target environment
|
||
|
||
This training example is wired for the RunWhen **airgap** environment (in-cluster
|
||
workspace-builder in `runwhen-env-airgap-runner`, Gitea at
|
||
`gitea.airgap.shared.runwhen.com`). The generation rule targets real Crossplane
|
||
`Bucket` resources already present in that cluster (see
|
||
[llm-storage.yaml](https://github.com/runwhen/infra-flux-nonprod-shared/blob/main/infrastructure/crossplane/llm-storage/llm-storage.yaml)
|
||
and similar). The pattern applies to any RunWhen environment; only the
|
||
`repoUrl` in the templates needs to change.
|