docs: add ephemeral namespace workflow how-to#590
Conversation
Add documentation for the new ephemeral-namespace Prow workflow that automates reserving and releasing consoledot ephemeral namespaces in OpenShift CI jobs. Covers background concepts (bonfire, the ephemeral namespace operator, Firelink/InScope UIs), architecture, quick start, environment variables, full ci-operator examples, and troubleshooting. 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
Remove Clowder/ClowdApp references (Clowder is being decommissioned), consoledot/console.redhat.com team-specific language (ephemeral is now open to all engineering teams), and the bonfire deploy documentation section (deployment API is being reworked to remove Clowder dependency). 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
The Konflux ephemeral cluster feature is unrelated enough to omit. 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
Add a Namespace Pools section documenting all four available pools (default, default-pvc, minimal, ai-development) with their pool sizes, included services, ResourceQuota limits, and shared LimitRange defaults. Data sourced from app-interface NamespacePool CRs. 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
Show concrete oc commands (apply, wait) and explain that once KUBECONFIG is set, users can run oc commands exactly as they would against any OpenShift cluster. 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
|
/cc @bsquizz |
|
/cc @maknop |
|
Workflow verified to work on this PR: openshift-online/osci-workflow-validation#2 |
Firelink and InScope URLs are internal Red Hat services that fail SSL validation in CI. Convert them from hyperlinks to inline code URLs so the link checker does not try to validate them. 💘 Generated with Crush Assisted-by: Claude Opus 4.6 via Crush <crush@charm.land>
|
The The remaining 6 link failures are all pre-existing broken links in other docs (ci-operator, testgrid, artifacts, onboarding, steps) — unrelated to this change. |
|
/lgtm |
|
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: deepsm007, gurnben The full list of commands accepted by this bot can be found here. The pull request process is described here DetailsNeeds approval from an approver in each of these files:
Approvers can indicate their approval by writing |
openshift-ci
Bot
added
the
approved
|
/override ci/prow/links |
|
@jupierce: Overrode contexts on behalf of jupierce: ci/prow/links DetailsIn response to this:
Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. |
|
@gurnben: all tests passed! Full PR test history. Your PR dashboard. DetailsInstructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here. |
…space workflow In OpenShift CI, "ephemeral cluster" conventionally refers to temporary clusters that are created, tested, and destroyed. The permanent central cluster used for Bonfire namespace management is not ephemeral — it is a long-lived host cluster. This commit updates the ephemeral-namespace-workflow documentation (introduced in PR openshift#590) to use "Bonfire host cluster" instead of "ephemeral cluster" when referring to the permanent cluster that hosts the Ephemeral Namespace Operator and namespace pools. File names in SHARED_DIR (ephemeral-kubeconfig, ephemeral-cluster-server, ephemeral-namespace) are left unchanged as they are actual artifact names used by the workflow steps.
3 participants
Summary
ephemeral-namespaceProw workflow for reserving and releasing consoledot ephemeral namespaces in OpenShift CI jobs.ci-operatorexamples, deploying with bonfire, and troubleshooting.Details
This workflow was recently contributed to openshift/release under
ci-operator/step-registry/ephemeral/namespace/. It provides a reusable pre/post step pair that:SHARED_DIRbest_effortThe documentation is aimed at new users who haven't worked with ephemeral namespaces before and links out to bonfire docs, Firelink, and InScope.
Test plan
💘 Generated with Crush