From e2ad1e89dc72d8d25d18e2b4de904c2d27129af3 Mon Sep 17 00:00:00 2001 From: Chuck McAndrew <6248903+dcmcand@users.noreply.github.com> Date: Fri, 20 Nov 2026 13:33:12 +0100 Subject: [PATCH] fix(chart): issue the operator webhook certificate from nebari-ca-issuer by default The webhook serving Certificate hardcoded ClusterIssuer selfsigned-issuer, which neither the chart nor NIC on main creates, so a fresh install left the operator pod in ContainerCreating. Add the chart value operator.webhook.clusterIssuer and default it to nebari-ca-issuer, the internal CA NIC creates in releases that include nebari-infrastructure-core#787. A missing operator.webhook block (values reused from an older release with --reuse-values) renders the same default; an explicitly empty value fails the render. This changes the default for existing installs. The upgrade notes cover keeping selfsigned-issuer, the brief admission failures while the operator reloads the reissued certificate, and what happens when the configured issuer does not exist. The installation guide, quickstart, README and values reference list the new prerequisite, and docs/architecture/contracts.md records the value as a contract. --- AGENTS.md | 1 + README.md | 1 + .../templates/operator-webhook-cert.yaml | 5 ++- charts/nebari-llm-serving/values.yaml | 11 +++++ docs/architecture/contracts.md | 8 ++++ .../outsider-landing-page.png | Bin 0 -> 44147 bytes docs/src/content/docs/configuration.mdx | 1 + docs/src/content/docs/installation.md | 36 ++++++++++++++++- docs/src/content/docs/quickstart.mdx | 1 + docs/src/content/docs/upgrading.mdx | 38 ++++++++++++++++++ 10 files changed, 100 insertions(+), 2 deletions(-) create mode 100644 AGENTS.md create mode 100644 docs/architecture/contracts.md create mode 100644 docs/install-production-screenshots/outsider-landing-page.png diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..2d002619 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1 @@ +Contracts are documented in docs/architecture/contracts.md. Changing a contract updates that file in the same PR. diff --git a/README.md b/README.md index b9700e30..5a20cd2b 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,7 @@ Models can be loaded from HuggingFace (default) or mounted as OCI/modelcar image - Envoy AI Gateway 1.1.0 installed. **Note**: the `envoyAIGateway.install` flag in this chart is not yet implemented - tracked in [#44](https://github.com/nebari-dev/llm-serving-pack/issues/44). Until that is done, install it manually as an ArgoCD app (see [examples/envoy-ai-gateway.yaml](examples/envoy-ai-gateway.yaml)). - [Gateway API Inference Extension](https://github.com/kubernetes-sigs/gateway-api-inference-extension) (GIE) CRDs installed - v1.5.0 validated. The pack needs `InferencePool`; the llm-d End-Point Picker crashloops without it. - A cert-manager `ClusterIssuer` the operator can use for the shared-hostname Certificate. Default expected name is `letsencrypt-issuer`, the one NIC creates; override with `platform.tls.clusterIssuer` in the chart values. +- A cert-manager `ClusterIssuer` for the operator's webhook certificate. Default expected name is `nebari-ca-issuer`, which NIC creates in releases that include [nebari-infrastructure-core#787](https://github.com/nebari-dev/nebari-infrastructure-core/pull/787); otherwise set `operator.webhook.clusterIssuer`. See the [Installation guide](https://packs.nebari.dev/llm-serving-pack/installation/#1-what-this-runbook-assumes). - DNS for `llm.` and `llm-internal.` resolving to the shared Gateway's load balancer (a wildcard CNAME on the base domain is the simplest way). Required for HTTP-01 issuance on the shared Certificate. - A StorageClass for model storage (EFS, EBS gp3, or any CSI-backed storage that can provision PVCs large enough for your models). diff --git a/charts/nebari-llm-serving/templates/operator-webhook-cert.yaml b/charts/nebari-llm-serving/templates/operator-webhook-cert.yaml index f7d58e28..ff76d541 100644 --- a/charts/nebari-llm-serving/templates/operator-webhook-cert.yaml +++ b/charts/nebari-llm-serving/templates/operator-webhook-cert.yaml @@ -11,5 +11,8 @@ spec: - {{ include "nebari-llm-serving.fullname" . }}-webhook-service.{{ include "nebari-llm-serving.operatorNamespace" . }}.svc - {{ include "nebari-llm-serving.fullname" . }}-webhook-service.{{ include "nebari-llm-serving.operatorNamespace" . }}.svc.cluster.local issuerRef: - name: selfsigned-issuer + {{- /* The dig fallback covers values reused from releases without + operator.webhook. Keep it in sync with operator.webhook.clusterIssuer in + values.yaml. */}} + name: {{ required "operator.webhook.clusterIssuer is required: name an existing cert-manager ClusterIssuer to sign the operator webhook certificate" (dig "webhook" "clusterIssuer" "nebari-ca-issuer" .Values.operator) | quote }} kind: ClusterIssuer diff --git a/charts/nebari-llm-serving/values.yaml b/charts/nebari-llm-serving/values.yaml index 6c405880..e535646e 100644 --- a/charts/nebari-llm-serving/values.yaml +++ b/charts/nebari-llm-serving/values.yaml @@ -351,6 +351,17 @@ operator: # Floating on main; pinned to a build sha at release time (see cicd-and-releasing). tag: "latest" pullPolicy: Always + webhook: + # clusterIssuer - the cert-manager ClusterIssuer that signs the + # operator's admission webhook serving Certificate (DNS names + # ..svc and ..svc.cluster.local). NIC creates + # nebari-ca-issuer, its internal CA for in-cluster and webhook + # certificates, in releases that include nebari-infrastructure-core#787. + # On a cluster without it, set this to an existing ClusterIssuer, for + # example a self-signed one named selfsigned-issuer. Must not be empty. + # Keep in sync with the dig fallback in + # templates/operator-webhook-cert.yaml. + clusterIssuer: nebari-ca-issuer # modelDownloader - the init/job image the operator uses to fetch model # weights before a serving Deployment starts. Rendered into the operator's diff --git a/docs/architecture/contracts.md b/docs/architecture/contracts.md new file mode 100644 index 00000000..63b75921 --- /dev/null +++ b/docs/architecture/contracts.md @@ -0,0 +1,8 @@ +# Contracts + +Contracts the operator owns or depends on. Changing one updates its entry in the same PR. + +### Chart value `operator.webhook.clusterIssuer` +**Owner:** `charts/nebari-llm-serving` (`values.yaml`, `templates/operator-webhook-cert.yaml`) ยท **Consumers:** every chart install, through the webhook serving Certificate's `issuerRef`; the docs site (`configuration.mdx`, `installation.md`, `quickstart.mdx`, `upgrading.mdx`) and `README.md` (verified: `rg -n "operator\.webhook\.clusterIssuer|\.Values\.operator\.webhook" --glob '!node_modules' --glob '!.worktrees' .`). The kind dev cluster installs from `dev/manifests/`, not the chart, and is unaffected. +**Promises:** A string naming a cert-manager `ClusterIssuer` (the `kind` stays `ClusterIssuer`). It signs the operator's admission webhook serving Certificate, whose DNS names are `..svc` and `..svc.cluster.local`. Default `nebari-ca-issuer`, which NIC creates in releases that include nebari-infrastructure-core#787; before this value existed the issuer was hardcoded to `selfsigned-issuer`. A missing key or `operator.webhook` block (for example values reused from an older release with `helm upgrade --reuse-values`) renders the default. An explicitly empty value fails the render with `operator.webhook.clusterIssuer is required: ...`. The chart does not create the issuer. +**Since:** 2026-11-20 diff --git a/docs/install-production-screenshots/outsider-landing-page.png b/docs/install-production-screenshots/outsider-landing-page.png new file mode 100644 index 0000000000000000000000000000000000000000..c7b14227e5776deb0325b1e0a04caffc6d956c74 GIT binary patch literal 44147 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 literal 0 HcmV?d00001 diff --git a/docs/src/content/docs/configuration.mdx b/docs/src/content/docs/configuration.mdx index 3d5109a7..642ce52b 100644 --- a/docs/src/content/docs/configuration.mdx +++ b/docs/src/content/docs/configuration.mdx @@ -149,6 +149,7 @@ The `openmeter` values configure the `nebari-openmeter` subchart; every key unde | `operator.image.repository` | `ghcr.io/nebari-dev/llm-serving-pack/operator` | Operator container image repository. | | `operator.image.tag` | `""` | Image tag. Defaults to `.Chart.AppVersion` when empty. Override only when testing a specific build. | | `operator.image.pullPolicy` | `Always` | Image pull policy. | +| `operator.webhook.clusterIssuer` | `nebari-ca-issuer` | The cert-manager `ClusterIssuer` that signs the operator's admission webhook serving certificate. NIC creates `nebari-ca-issuer` in releases that include [nebari-infrastructure-core#787](https://github.com/nebari-dev/nebari-infrastructure-core/pull/787). On a cluster without it, set this to an existing `ClusterIssuer`, for example a self-signed one named `selfsigned-issuer`. Must not be empty: the chart will not render. | ### Defaults (cluster-wide fallbacks for LLMModel resources) diff --git a/docs/src/content/docs/installation.md b/docs/src/content/docs/installation.md index bf8ca79e..ab8a0c72 100644 --- a/docs/src/content/docs/installation.md +++ b/docs/src/content/docs/installation.md @@ -30,6 +30,7 @@ This runbook starts from a NIC-foundational Nebari cluster. > next `nic deploy --regen-apps` silently reverts. [nic499]: https://github.com/nebari-dev/nebari-infrastructure-core/pull/499 +[nic787]: https://github.com/nebari-dev/nebari-infrastructure-core/pull/787 NIC ships, out of the box, the components below; if any are missing or in a different namespace on your cluster, adjust the commands @@ -71,6 +72,24 @@ In addition you need: ships `letsencrypt-issuer`, which is the chart's default `platform.tls.clusterIssuer`. If your cluster uses a different issuer, set it in section 8. +- **A ClusterIssuer for the operator's webhook certificate.** The + chart's `operator.webhook.clusterIssuer` defaults to + `nebari-ca-issuer`, NIC's internal CA for in-cluster and webhook + certificates. NIC creates it in releases that include + [nebari-infrastructure-core#787][nic787]. Without it, the operator + pod stays in `ContainerCreating` because its webhook certificate is + never issued. On a cluster without `nebari-ca-issuer`, set + `operator.webhook.clusterIssuer` in section 8 to an existing + ClusterIssuer, for example a self-signed one: + + ```yaml + apiVersion: cert-manager.io/v1 + kind: ClusterIssuer + metadata: + name: selfsigned-issuer + spec: + selfSigned: {} + ``` - **A cluster-config git repo** that ArgoCD's AppProject is configured to read from. New `Application` manifests in this runbook will be committed there, under a path of your own choosing (shown throughout @@ -150,7 +169,9 @@ kubectl get clusterissuer Expected: at least one ClusterIssuer with `READY=True`. Capture its exact name; you will set `platform.tls.clusterIssuer` to that value in -section 8. +section 8. Also check for `nebari-ca-issuer` with `READY=True`; if it +is not listed, pick the ClusterIssuer you will set as +`operator.webhook.clusterIssuer` in section 8 (see section 1). ### 2.5 Confirm the Gateway HTTPS:443 listener has a usable cert @@ -1073,6 +1094,13 @@ spec: tls: # NIC's ClusterIssuer, and the chart default. clusterIssuer: letsencrypt-issuer + operator: + webhook: + # Signs the operator's webhook certificate. The default, + # nebari-ca-issuer, exists on NIC releases that include + # nebari-infrastructure-core#787. On other clusters, name + # an existing ClusterIssuer here (see section 1). + clusterIssuer: nebari-ca-issuer defaults: storage: # NIC's default StorageClass is longhorn; the vLLM model @@ -1112,6 +1140,12 @@ different hostname (`llm.` and `llm-internal.`) and a different SecurityPolicy (API-key-protected on external, JWT-protected on internal). +The `operator.webhook.clusterIssuer` value names the ClusterIssuer +that signs the operator's admission webhook certificate +(`nebari-llm-serving-webhook-cert`). Leave it at `nebari-ca-issuer` +when your cluster has that issuer; otherwise set it to the issuer you +picked in section 2.4. An empty value stops the chart from rendering. + If you want to split traffic across two physical Gateways instead (e.g. one with a public LB, one with an internal-only LB), point `platform.gateway.internal` at a different Gateway resource. diff --git a/docs/src/content/docs/quickstart.mdx b/docs/src/content/docs/quickstart.mdx index 077d71fe..d471f695 100644 --- a/docs/src/content/docs/quickstart.mdx +++ b/docs/src/content/docs/quickstart.mdx @@ -17,6 +17,7 @@ For a full production-grade setup (air-gapped clusters, HuggingFace token secret - **Envoy AI Gateway** v1.1.0 installed. **Note**: the `envoyAIGateway.install` chart flag is not yet implemented ([#44](https://github.com/nebari-dev/llm-serving-pack/issues/44)). Install manually via ArgoCD (see [`examples/envoy-ai-gateway.yaml`](https://github.com/nebari-dev/llm-serving-pack/blob/main/examples/envoy-ai-gateway.yaml)). ([Installation §5](/installation/#5-install-the-envoy-ai-gateway-controller)) - [Gateway API Inference Extension](https://github.com/kubernetes-sigs/gateway-api-inference-extension) CRDs, v1.5.0 validated - `InferencePool` is the one the pack requires ([Installation §4](/installation/#4-install-ai-gateway-and-inference-extension-crds)) - A cert-manager `ClusterIssuer` for the shared TLS certificate (default name: `letsencrypt-issuer`, the one NIC creates; override with `platform.tls.clusterIssuer`) ([Installation §2.4](/installation/#24-confirm-the-cluster-issuer-is-ready)) +- A cert-manager `ClusterIssuer` for the operator's webhook certificate (default name: `nebari-ca-issuer`, created by NIC releases that include [nebari-infrastructure-core#787](https://github.com/nebari-dev/nebari-infrastructure-core/pull/787); otherwise set `operator.webhook.clusterIssuer`) ([Installation §1](/installation/#1-what-this-runbook-assumes)) - DNS for `llm.` and `llm-internal.` pointing at the shared Gateway load balancer ([Installation §2.3](/installation/#23-confirm-dns-resolves-to-the-gateway-lb)) - A StorageClass that can provision PVCs large enough for your models (EFS, EBS gp3, or equivalent) ([Installation §1](/installation/#1-what-this-runbook-assumes); [sizing guidance](/shared-storage/)) diff --git a/docs/src/content/docs/upgrading.mdx b/docs/src/content/docs/upgrading.mdx index 8399d393..4a2d756b 100644 --- a/docs/src/content/docs/upgrading.mdx +++ b/docs/src/content/docs/upgrading.mdx @@ -84,6 +84,44 @@ A release that changes a behavior listed on its heading here, says what changed, and says what a deployment that relies on it must do. +### Upgrading from 0.1.4 or earlier: the webhook certificate issuer + +The ClusterIssuer that signs the operator's admission webhook certificate +is now the chart value `operator.webhook.clusterIssuer`, and its default +changed from `selfsigned-issuer` to `nebari-ca-issuer`. NIC creates +`nebari-ca-issuer` in releases that include +[nebari-infrastructure-core#787](https://github.com/nebari-dev/nebari-infrastructure-core/pull/787). + +Check which issuers the cluster has: + +```bash +kubectl get clusterissuer +``` + +If `nebari-ca-issuer` is listed with `READY=True`, no change is needed: +cert-manager reissues the webhook certificate from it right away and +updates the webhook's CA bundle. The operator picks up the new certificate +only when the kubelet next syncs its Secret volume, about a minute later. +In that window, creating or updating an `LLMModel` or `PassthroughModel` +fails with `x509: certificate signed by unknown authority`; retry after +a minute. + +Otherwise, **keep the old issuer before upgrading** by adding it to your +values: + +```yaml +operator: + webhook: + clusterIssuer: selfsigned-issuer +``` + +If you upgrade with neither, cert-manager leaves the existing certificate +Secret untouched, the Certificate goes `Ready=False` with reason +`IncorrectIssuer`, and its CertificateRequest stays `Pending`. Admission +keeps working with the old certificate, so the upgrade looks healthy, but +the certificate cannot be renewed and admission fails once it expires. +Create the issuer or set the value to fix it. + ### Upgrading from 0.1.4 or earlier: access groups compared as group paths `access.groups` is now compared with the token's groups claim as Keycloak