From 46fd7a5b256c2ce4c2bfd844e3ca8099e515c12e Mon Sep 17 00:00:00 2001 From: Laura Hinson Date: Fri, 10 Jul 2026 13:56:51 -0400 Subject: [PATCH] [OSDOCS-20636]: CQA: HCP overview (2 of 2) --- hosted_control_planes/index.adoc | 2 ++ modules/hcp-acm-discover.adoc | 7 +++++-- modules/hosted-control-planes-concepts-personas.adoc | 8 +++++--- modules/hosted-control-planes-version-support.adoc | 7 +++++-- 4 files changed, 17 insertions(+), 7 deletions(-) diff --git a/hosted_control_planes/index.adoc b/hosted_control_planes/index.adoc index 2f59e46bf78a..c321538692e6 100644 --- a/hosted_control_planes/index.adoc +++ b/hosted_control_planes/index.adoc @@ -24,6 +24,8 @@ include::modules/hosted-control-planes-version-support.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources + +* link:https://kubernetes.io/docs/reference/using-api/#api-versioning[Kubernetes API versioning] * link:https://amd64.ocp.releases.ci.openshift.org/[AMD64 release images] * link:https://arm64.ocp.releases.ci.openshift.org/[ARM64 release images] * link:https://multi.ocp.releases.ci.openshift.org/[Multi-arch release images] diff --git a/modules/hcp-acm-discover.adoc b/modules/hcp-acm-discover.adoc index e44a0a8bfca5..9cfdf369eb25 100644 --- a/modules/hcp-acm-discover.adoc +++ b/modules/hcp-acm-discover.adoc @@ -4,6 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="hcp-acm-discover_{context}"] -= Discovering {mce-short} hosted clusters in {rh-rhacm} += Hosted clusters in {rh-rhacm-title} -If you want to bring hosted clusters to a {rh-rhacm-first} hub cluster to manage them with {rh-rhacm} management components, see the instructions in the link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.11/html/clusters/cluster_mce_overview#discover-hosted-acm[{rh-rhacm-title} official documentation]. +[role="_abstract"] +You can bring hosted clusters to a {rh-rhacm-title} hub cluster to manage them with {rh-rhacm-title} management components. + +For more information, see "Discovering {mce-short} hosted clusters in {rh-rhacm-title}". diff --git a/modules/hosted-control-planes-concepts-personas.adoc b/modules/hosted-control-planes-concepts-personas.adoc index be203a2bc900..80b1f3c7d765 100644 --- a/modules/hosted-control-planes-concepts-personas.adoc +++ b/modules/hosted-control-planes-concepts-personas.adoc @@ -4,10 +4,11 @@ // * hosted-control-planes/index.adoc -:_mod-docs-content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="hosted-control-planes-concepts-personas_{context}"] = Glossary of common concepts and personas for {hcp} +[role="_abstract"] When you use {hcp} for {product-title}, it is important to understand its key concepts and the personas that are involved. [id="hosted-control-planes-concepts_{context}"] @@ -38,9 +39,10 @@ cluster instance administrator:: Users who assume this role are the equivalent o cluster instance user:: Users who assume this role are the equivalent of developers in standalone {product-title}. This user does not have a view into the software catalog or machines. -cluster service consumer:: Users who assume this role can request control planes and worker nodes, drive updates, or modify externalized configurations. Typically, this user does not manage or access cloud credentials or infrastructure encryption keys. The cluster service consumer persona can request hosted clusters and interact with node pools. Users who assume this role have RBAC to create, read, update, or delete hosted clusters and node pools within a logical boundary. +cluster service consumer:: Users who assume this role can request control planes and worker nodes, drive updates, or modify externalized configurations. Typically, this user does not manage or access cloud credentials or infrastructure encryption keys. The cluster service consumer persona can request hosted clusters and interact with node pools. Users who assume this role have role-based access control (RBAC) to create, read, update, or delete hosted clusters and node pools within a logical boundary. + +cluster service provider:: Users who assume this role typically have the `cluster-admin` role on the management cluster and have RBAC to monitor and own the availability of the HyperShift Operator and the control planes for the tenant's hosted clusters. The cluster service provider persona is responsible for several activities, including the following examples: -cluster service provider:: Users who assume this role typically have the `cluster-admin` role on the management cluster and have RBAC to monitor and own the availability of the HyperShift Operator as well as the control planes for the tenant's hosted clusters. The cluster service provider persona is responsible for several activities, including the following examples: ** Owning service-level objects for control plane availability, uptime, and stability ** Configuring the cloud account for the management cluster to host control planes ** Configuring the user-provisioned infrastructure, which includes the host awareness of available compute resources diff --git a/modules/hosted-control-planes-version-support.adoc b/modules/hosted-control-planes-version-support.adoc index d5276c5dc844..38bfc2a6eea8 100644 --- a/modules/hosted-control-planes-version-support.adoc +++ b/modules/hosted-control-planes-version-support.adoc @@ -8,7 +8,10 @@ [id="hosted-control-planes-version-support_{context}"] = Versioning for {hcp} -The {hcp} feature includes the following components, which might require independent versioning and support levels: +[role="_abstract"] +The {hcp} feature includes several components that might require independent versioning and support levels. + +Those components are as follows: * Management cluster * HyperShift Operator @@ -62,7 +65,7 @@ You can use the `hcp` CLI to create hosted clusters. You can download the CLI fr You can use the `hypershift.openshift.io` API resources, such as, `HostedCluster` and `NodePool`, to create and manage {product-title} clusters at scale. A `HostedCluster` resource contains the control plane and common data plane configuration. When you create a `HostedCluster` resource, you have a fully functional control plane with no attached nodes. A `NodePool` resource is a scalable set of worker nodes that is attached to a `HostedCluster` resource. -The API version policy generally aligns with the policy for link:https://kubernetes.io/docs/reference/using-api/#api-versioning[Kubernetes API versioning]. +The API version policy generally aligns with the policy for Kubernetes API versioning. Updates for {hcp} involve updating the hosted cluster and the node pools. For more information, see "Updates for {hcp}".