Skip to content

docs(ecosystem): add Knative Installation Guide (S2)#807

Merged
SuJinpei merged 4 commits into
mainfrom
docs/knative-installation-guide
Jul 17, 2026
Merged

docs(ecosystem): add Knative Installation Guide (S2)#807
SuJinpei merged 4 commits into
mainfrom
docs/knative-installation-guide

Conversation

@SuJinpei

Copy link
Copy Markdown
Contributor

Adds the end-user installation guide for the Knative Operator (S2 ecosystem plugin) on ACP 4.2/4.3, following the existing ecosystem solution format (front-matter + Overview / Supported Versions / Prerequisites / Install / Verify / Quick Start / Cleanup / FAQ).

Covers the ACP-specific install details

  • KnativeServing must live in the knative-serving namespace (the Kourier bootstrap ConfigMap hardcodes net-kourier-controller.knative-serving).
  • spec.registry.override + explicit queue-sidecar-image — the Operator references operands by digest and the platform image allowlist cannot rewrite digest references, so without this the Serving pods hit ImagePullBackOff.
  • Serving quick start (hello service) with verification, plus a FAQ built from the real failure modes.

Known limitation documented

Single-stack IPv6 / IPv6-primary clusters: the upstream autoscaler stat-forwarder hardcodes the bucket-lease EndpointSlice AddressType to IPv4, so the autoscaler CrashLoopBackOffs and KnativeServing never becomes Ready. Fixed upstream on main (knative/serving#16591), not yet in a released 1.22.x.

Validation

  • Install steps verified via e2e on ACP 4.3-x86 and 4.2-arm.
  • IPv6 limitation reproduced on ACP 4.3 single-stack IPv6.

id: TBD (assigned by CI add_id.sh). Version-variable slots are fenced with factory:auto:* markers for later automated per-release updates.

End-user installation guide for the Knative Operator on ACP 4.2/4.3, matching the
ecosystem solution format (front-matter + Overview/Supported Versions/Prerequisites/
Install/Verify/Quick Start/Cleanup/FAQ).

Covers the ACP-specific install details: KnativeServing must live in the
knative-serving namespace (Kourier bootstrap), spec.registry.override + explicit
queue-sidecar-image (operands are referenced by digest and the platform image
allowlist cannot rewrite digests), and a Serving quick start.

Documents the single-stack-IPv6 limitation (upstream autoscaler statforwarder
hardcodes EndpointSlice AddressType=IPv4; fixed on main via knative/serving#16591,
not yet in a released 1.22.x).

Version-variable slots are fenced with factory:auto:* markers for later automated
per-release updates.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Validated knative rc.8 end-to-end on ACP 4.1 (long-term C g2-c2, ARM,
single-stack IPv4): operator CSV Succeeded, KnativeServing Ready, sample
Knative Service Ready with URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Title + overview now name the product per the S2 support-level convention
(S2 = "Alauda support for XXX"), distinguishing this curated upstream-CNCF-Knative
listing from Alauda's own "DevOps Eventing v3". Technical OperatorHub references
kept as-is.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Match the renamed OLM package/CSV (alauda-support-for-knative), verified against a
real build: OperatorHub tile + plugin package + CSV/subscription names updated. Kept
the operator's own Deployment name (knative-operator) and the upstream bundle image,
which are unchanged.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@SuJinpei
SuJinpei merged commit 51037ce into main Jul 17, 2026
1 check passed
@SuJinpei
SuJinpei deleted the docs/knative-installation-guide branch July 17, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant