mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
240 lines
15 KiB
Plaintext
240 lines
15 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
:telco-hub:
|
|
[id="telco-hub-ref-design-specs"]
|
|
= Telco hub reference design specification
|
|
include::_attributes/common-attributes.adoc[]
|
|
:context: telco-hub
|
|
|
|
toc::[]
|
|
|
|
The telco hub reference design specification (RDS) describes the configuration for a hub cluster that deploys and operates fleets of {product-title} clusters in a telco environment.
|
|
|
|
include::modules/telco-ran-core-ref-design-spec.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-deviations-from-the-ref-design.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-architecture-overview.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-telco-management-cluster-use-model.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* For more information about core clusters or far edge clusters that host RAN distributed unit (DU) workloads, see the following:
|
|
** xref:../scalability_and_performance/telco-core-rds.adoc#telco-core-ref-design-specs[Telco core RDS]
|
|
** xref:../scalability_and_performance/telco-ran-du-rds.adoc#telco-ran-du-ref-design-specs[Telco RAN DU RDS]
|
|
|
|
* For more information about lifecycle management for the fleet of managed clusters see:
|
|
** xref:../edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc#cnf-understanding-image-based-upgrade[Image-based upgrade for {sno} clusters]
|
|
** xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#cnf-talm-for-cluster-updates[Updating managed clusters with the {cgu-operator-full}]
|
|
** xref:../edge_computing/day_2_core_cnf_clusters/telco-day-2-welcome.adoc#telco-day-2-welcome[Upgrading a telco core CNF cluster]
|
|
|
|
* For more information about declarative cluster provisioning with {ztp} see:
|
|
** xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Installing managed clusters with {rh-rhacm} and SiteConfig resources]
|
|
|
|
* For more information about observability metrics and alerts, see:
|
|
** link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/about/index#multicluster-architecture[Multicluster architecture]
|
|
** link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/about/index#observability-arch[Observability]
|
|
|
|
include::modules/telco-hub-scaling-targets.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-resource-utilization.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/governance/index#template-comparison-table[Comparison of hub cluster and managed cluster templates]
|
|
|
|
include::modules/telco-hub-cluster-topology.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../welcome/learn_more_about_openshift.adoc#architecture[{product-title} architecture]
|
|
* xref:../post_installation_configuration/node-tasks.adoc#post-install-node-tasks[Postinstallation node tasks]
|
|
|
|
include::modules/telco-hub-networking.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../disconnected/installing.adoc#installing-disconnected-environments[Installing a cluster in a disconnected environment]
|
|
* xref:../disconnected/using-olm.adoc#olm-restricted-networks[Using Operator Lifecycle Manager on restricted networks]
|
|
* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-configuring-the-cluster-for-a-disconnected-environment_ztp-preparing-the-hub-cluster[Configuring the hub cluster to use a disconnected mirror registry]
|
|
* xref:../networking/networking_overview/cidr-range-definitions.adoc#cidr-range-definitions[CIDR range definitions]
|
|
* xref:../installing/overview/index.adoc#ocp-installation-overview[Installing {product-title}]
|
|
* xref:../networking/networking_overview/understanding-networking.adoc#understanding-networking[Networking in {product-title}]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/networking/index[Networking in {rh-rhacm}]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/clusters/cluster_mce_overview#mce-network-configuration[Network configuration in {rh-rhacm}]
|
|
|
|
include::modules/telco-hub-memory-and-cpu-requirements.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../scalability_and_performance/index.adoc#scalability-and-performance-overview[Scaling your {product-title} cluster and tuning performance in production environments]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/install/installing#sizing-your-cluster[Sizing your cluster]
|
|
|
|
include::modules/telco-hub-storage-requirements.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-assisted-service.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/clusters/cluster_mce_overview#enable-cim-disconnected[Enabling central infrastructure management in disconnected environments]
|
|
|
|
include::modules/telco-hub-acm-observability.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-storage-considerations.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../storage/understanding-persistent-storage.adoc#persistent-storage-overview_understanding-persistent-storage[Persistent storage overview]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_openshift_data_foundation/latest/html/red_hat_openshift_data_foundation_architecture/index[{rh-storage} architecture]
|
|
* xref:../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]
|
|
* xref:../etcd/etcd-practices.adoc#recommended-etcd-practices[Recommended etcd practices]
|
|
|
|
include::modules/telco-hub-git-repository.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-hub-cluster-openshift-deployment.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../installing/overview/index.adoc#installation-overview_ocp-installation-overview[{product-title} installation overview]
|
|
* xref:../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-with-agent-based-installer[Installing a cluster with customizations]
|
|
* xref:../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#preparing-to-install-with-agent-based-installer[Preparing to install with the Agent-based Installer]
|
|
|
|
include::modules/telco-hub-hub-cluster-day-2-operators.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://access.redhat.com/articles/7073065[Red Hat Advanced Cluster Management for Kubernetes 2.11 Support Matrix]
|
|
* link:https://access.redhat.com/support/policy/updates/openshift_operators[OpenShift Operator lifecycles]
|
|
|
|
* For more information about telco hub cluster update requirements, see:
|
|
** xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-gitops-ztp-max-spoke-clusters_ztp-preparing-the-hub-cluster[Recommended hub cluster specifications and managed cluster limits for {ztp}].
|
|
** link:https://access.redhat.com/articles/7073065[Red Hat Advanced Cluster Management for Kubernetes 2.11 Support Matrix]
|
|
** link:https://access.redhat.com/support/policy/updates/openshift_operators[OpenShift Operator Life Cycles]
|
|
|
|
* For more information about updating the hub cluster, see:
|
|
** xref:../updating/understanding_updates/intro-to-updates.adoc#understanding-openshift-updates[Introduction to OpenShift updates]
|
|
** link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html-single/install/index#upgrading-hub[Upgrading your hub cluster]
|
|
** xref:../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Updating {ztp}]
|
|
|
|
include::modules/telco-hub-observability.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* For more information about observability, see:
|
|
** link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#exporting-metrics-to-external-endpoints[Exporting metrics to external endpoints]
|
|
** link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#enabling-observability-service[Enabling the Observability service]
|
|
|
|
* For more information about custom metrics, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#adding-custom-metrics[Adding custom metrics]
|
|
|
|
* For more information about forwarding alerts to other external systems, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#forward-alerts[Forwarding alerts]
|
|
|
|
* For more information about CPU and memory requirements see: link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#observability-pod-capacity-requests[Observability pod capacity requests]
|
|
|
|
* For more information about custom dashboards, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/observability/index#using-grafana-dashboards[Using Grafana dashboards]
|
|
|
|
include::modules/telco-hub-managed-clusters-lifecycle-management.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* xref:../edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-deploying-far-edge-clusters-at-scale[Challenges of the network far edge]
|
|
|
|
include::modules/telco-hub-managed-cluster-deployment.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/multicluster_engine_operator_with_red_hat_advanced_cluster_management/siteconfig-intro#siteconfig-intro[SiteConfig]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/apis/apis#rhacm-docs_apis_clusterinstance_jsonclusterinstance[ClusterInstance]
|
|
* xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-creating-the-site-secrets_ztp-deploying-far-edge-sites[Creating the managed bare-metal host secrets]
|
|
|
|
include::modules/telco-hub-managed-cluster-updates-and-upgrades.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/governance/governance#configuration-policy-yaml[Configuration policy YAML structure]
|
|
* xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#talo-about-cgu-crs_cnf-topology-aware-lifecycle-manager[About the ClusterGroupUpgrade CR]
|
|
* xref:../edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc#cnf-understanding-image-based-upgrade[Understanding the image-based upgrade for {sno} clusters]
|
|
* xref:../edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc#ztp-image-based-upgrade[Performing an image-based upgrade for {sno} clusters using {ztp}]
|
|
|
|
include::modules/telco-hub-hub-disaster-recovery.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.13/html-single/business_continuity/index[Business continuity]
|
|
|
|
include::modules/telco-hub-hub-components.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-red-hat-advanced-cluster-management-rhacm.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html-single/clusters/index#cluster_mce_overview[Multi Cluster Engine]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html-single/governance/index[Governance]
|
|
* xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#cnf-talm-for-cluster-updates[{cgu-operator-full}]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html/observability/index[MultiClusterHub Observability]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html-single/business_continuity/index#business-cont-overview[Business continuity]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html/install/installing#performance-and-scalability[Performance and scalability]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html-single/clusters/index#mce-network-configuration[Network configuration]
|
|
|
|
include::modules/telco-hub-topology-aware-lifecycle-manager-talm.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-gitops-operator-and-ztp-plugins.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/html/multicluster_engine_operator_with_red_hat_advanced_cluster_management/siteconfig-intro[ClusterInstance CR]
|
|
* xref:../edge_computing/policygentemplate_for_ztp/ztp-configuring-managed-clusters-policies.adoc#ztp-configuring-managed-clusters-policies[PolicyGenTemplate CRs]
|
|
* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository-ver-ind_ztp-preparing-the-hub-cluster[{ztp} version independence]
|
|
|
|
include::modules/telco-hub-local-storage-operator.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-openshift-data-foundation.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_openshift_data_foundation/4.13/html-single/4.13_release_notes/index#support_openshift_dual_stack_with_odf_using_ipv4[Support OpenShift dual stack with {rh-storage} using IPv4]
|
|
* link:https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.15/html-single/planning_your_deployment/index#infrastructure-requirements_rhodf[Infrastructure requirements]
|
|
* link:https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.15/html-single/planning_your_deployment/index#network-requirements_rhodf[Network requirements]
|
|
* link:https://docs.redhat.com/en/documentation/red_hat_openshift_data_foundation/4.17/html-single/planning_your_deployment/index#network-requirements_rhodf[Storage cluster deployment approaches]
|
|
|
|
include::modules/telco-hub-logging.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-oadp-operator.adoc[leveloffset=+2]
|
|
|
|
include::modules/telco-hub-rds-container.adoc[leveloffset=+1]
|
|
|
|
include::modules/hub-cluster-ref-config-crs.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-advanced-cluster-management.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-storage.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-gitops-ztp.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-logging.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-container-registry.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-image-mirroring.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-crs-installation.adoc[leveloffset=+1]
|
|
|
|
include::modules/telco-hub-software-stack.adoc[leveloffset=+1]
|
|
|
|
:!telco-hub:
|