|
| 1 | +--- |
| 2 | +title: Configuration |
| 3 | +weight: 20 |
| 4 | +aliases: /telco-hub/configuration/ |
| 5 | +--- |
| 6 | + |
| 7 | +:toc: |
| 8 | +:imagesdir: /images |
| 9 | +:_mod-docs-content-type: ASSEMBLY |
| 10 | +include::modules/comm-attributes.adoc[] |
| 11 | + |
| 12 | +[id="telco-hub-pattern-configuration"] |
| 13 | += Telco hub pattern configuration |
| 14 | + |
| 15 | +The Telco Hub pattern uses the following file hierarchy to control what runs in your hub. |
| 16 | + |
| 17 | +* `values-global.yaml`: global, cross-environment pattern settings. |
| 18 | +* `values-hub.yaml`: hub-specific ArgoCD and cluster definitions. |
| 19 | +* `kustomize/overlays/telco-hub/kustomization.yaml`: enable optional components and apply environment-specific patches. |
| 20 | +* `kustomize/air-gapped/imageset-config.yaml`: image set config to mirror required images and catalogs (disconnected). |
| 21 | +* `kustomize/air-gapped/prerequisites/kustomization.yaml`: prerequisites for air-gapped deployments, apply proxy, CA, and catalog sources (disconnected). |
| 22 | + |
| 23 | +[id="global-pattern-configuration"] |
| 24 | +== Global pattern configuration |
| 25 | + |
| 26 | +The `values-global.yaml` file defines configuration values that apply across all clusters and environments in the pattern, establishing the overall pattern behavior. |
| 27 | + |
| 28 | +Key parameters within the global section include: |
| 29 | + |
| 30 | +* `pattern`: Defines the name of the validated pattern, set to `telco-hub-pattern`. |
| 31 | +* `secretLoader`: Use it to disable the secret loading process. For example, `disabled: true`. |
| 32 | +* `options`: Affects all clusters by defining default behaviors: |
| 33 | + |
| 34 | +** `syncPolicy`: Sets the default ArgoCD synchronization policy. Options include `Automatic` or `Manual`. |
| 35 | +** `installPlanApproval`: Sets the default operator install plan approval. Options include `Automatic` or `Manual`. |
| 36 | +** `useCSV`: Specifies whether to use specific `ClusterServiceVersions` for operators. The default value is `false`. |
| 37 | +* `main`: Defines settings for the main cluster (hub) that manages the pattern, including the `clusterGroupName: hub`. |
| 38 | +* Disconnected Configuration: This file also specifies sources for operators in disconnected environments, such as `patternsOperator: source: community-operators-disconnected` and `gitops: operatorSource: redhat-operators-disconnected`. |
| 39 | + |
| 40 | +[id="hub-cluster-configuration"] |
| 41 | +== Hub cluster configuration |
| 42 | +The `values-hub.yaml` file has configuration specific to the hub cluster within the Telco Hub pattern. It is crucial as it defines the hub cluster, which acts as the central management point for GitOps, cluster management, and policy enforcement across the infrastructure. |
| 43 | + |
| 44 | +Cluster group identification:: |
| 45 | +The `clusterGroup` section identifies the cluster's role and name: |
| 46 | +[source,terminal] |
| 47 | +---- |
| 48 | +clusterGroup: |
| 49 | + name: hub # Name of this cluster group |
| 50 | + isHubCluster: true # Designates this as the hub/management cluster |
| 51 | +---- |
| 52 | + |
| 53 | +Management of the `subscriptions` and `projects` resources within this file is delegated to the `telco-hub` kustomization application to prevent systematic conflicts between the Pattern Operator and the Telco Hub Reference Design Specification. |
| 54 | + |
| 55 | +ArgoCD application configuration:: |
| 56 | + |
| 57 | +The `applications` section defines the core ArgoCD application for the Telco Hub pattern: |
| 58 | + |
| 59 | +* `telco-hub` application: Uses Kustomize for manifest processing `kustomize: true` and points to the overlay path `kustomize/overlays/telco-hub`. |
| 60 | +* Synchronization Policy: The `syncPolicy` is configured to be automated `automated: prune: true` to remove resources not present in git. |
| 61 | +* Retry Mechanism: The application uses a configured retry mechanism to handle temporary failures during synchronization: |
| 62 | + ◦ `limit: 6`: maximum number of sync retries, adjusted for about 20 minutes total. |
| 63 | + ◦ `backoff`: configured with an initial duration of `15s`, a factor of `2`, and a `maxDuration` of `15m`. |
| 64 | + |
| 65 | +[id="component-selection-and-environment-customization"] |
| 66 | +== Component selection and environment customization |
| 67 | + |
| 68 | +Components are enabled by uncommenting the corresponding remote base resource declarations within the `resources:` array of the `kustomization.yaml` file. |
| 69 | +The pattern uses remote base resources from the telco-reference git repository. |
| 70 | + |
| 71 | +Required components:: |
| 72 | +These components are essential for hub cluster functionality: |
| 73 | + |
| 74 | +* Local Registry: The Telco Hub Reference Design Specifications targets disconnected environments, therefore this component is enabled by default. |
| 75 | +* {rh-rhacm-first}: The {rh-rhacm} telco-hub component requires a storage backend to support its observability functionality. You need to configure a storage backend for the hub cluster along with {rh-rhacm}. |
| 76 | +* GitOps Operator: This component's configuration is currently provided by default through the Validated Patterns Operator, and its resource URL from telco-reference is not yet supported by the pattern itself. |
| 77 | +* {cgu-operator-first}: This component is required and enabled by default. |
| 78 | + |
| 79 | +Zero Touch Provisioning (ZTP) Workflow Components:: |
| 80 | +This component provides ArgoCD applications for synchronizing cluster deployment (ClusterInstance) CRs and configuration (Policy and/or PolicyGenerator) CRs. Enable this resource if you intend to use the GitOps ZTP workflow for automated cluster deployment: |
| 81 | + |
| 82 | +* ZTP Installation: Uncomment the dedicated resource URL for `ztp-installation`. |
| 83 | + |
| 84 | +Optional components:: |
| 85 | +These components should be enabled based on specific workload and storage requirements: |
| 86 | + |
| 87 | +* LocalStorage Operator (LSO): Enable if you plan to use LSO as your storage backend. |
| 88 | +* Red Hat OpenShift Data Foundation (ODF): Enable if you plan to use ODF as your storage backend. |
| 89 | +* Cluster Logging Operator (Logging): Enable if you require the cluster logging operator for log aggregation. |
| 90 | + |
| 91 | +Environment Customization (Kustomize Patches):: |
| 92 | +The `patches:` section allows you to apply modifications to the base configurations sourced from the telco-reference without directly editing those upstream files. This is vital for maintaining upstream compatibility. |
| 93 | +Patches are defined using a target specification `group`, `version`, `kind`, or `name` and the specific patch content. |
| 94 | + |
| 95 | +[id="example-patch"] |
| 96 | +=== Examples |
| 97 | + |
| 98 | +The following examples illustrate how to customize Operator configurations for specific environments, such as disconnected setups or storage class adjustments. |
| 99 | + |
| 100 | +[source,yaml] |
| 101 | +---- |
| 102 | +patches: |
| 103 | + # Example: Update Red Hat operators catalog to use specific version |
| 104 | + - target: |
| 105 | + group: operators.coreos.com |
| 106 | + version: v1alpha1 |
| 107 | + kind: CatalogSource |
| 108 | + name: redhat-operators-disconnected |
| 109 | + patch: |- |
| 110 | + - op: replace |
| 111 | + path: /spec/image |
| 112 | + value: <registry.example.com:8443>/openshift-marketplace/redhat-operators-disconnected:v4.20 |
| 113 | +
|
| 114 | + # Example: Add registry CA to the hub cluster |
| 115 | + - target: |
| 116 | + version: v1 |
| 117 | + kind: ConfigMap |
| 118 | + name: registry-ca |
| 119 | + patch: |- |
| 120 | + - op: replace |
| 121 | + path: /data |
| 122 | + value: |
| 123 | + registry.example.com..8443 | |
| 124 | + -----BEGIN CERTIFICATE----- |
| 125 | + MIIGcjCCBFqgAwIBAgIFICIE... |
| 126 | + -----END CERTIFICATE----- |
| 127 | +
|
| 128 | + # Example: AgentServiceConfig storage and OS images configuration |
| 129 | + - target: |
| 130 | + group: agent-install.openshift.io |
| 131 | + version: v1beta1 |
| 132 | + kind: AgentServiceConfig |
| 133 | + name: agent |
| 134 | + patch: |- |
| 135 | + - op: replace |
| 136 | + path: "/spec/osImages" |
| 137 | + value: |
| 138 | + - cpuArchitecture: x86_64 |
| 139 | + openshiftVersion: "4.18" |
| 140 | + rootFSUrl: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.18/latest/rhcos-live-rootfs.x86_64.img |
| 141 | + url: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.18/latest/rhcos-live.x86_64.iso |
| 142 | + version: 418.94.202502100215-0 |
| 143 | + - cpuArchitecture: x86_64 |
| 144 | + openshiftVersion: "4.19" |
| 145 | + rootFSUrl: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.19/latest/rhcos-live-rootfs.x86_64.img |
| 146 | + url: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.19/latest/rhcos-live-iso.x86_64.iso |
| 147 | + version: 9.6.20250530-0 |
| 148 | + - cpuArchitecture: x86_64 |
| 149 | + openshiftVersion: "4.20" |
| 150 | + rootFSUrl: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.20/latest/rhcos-live-rootfs.x86_64.img |
| 151 | + url: https://mirror.example.com/pub/openshift-v4/x86_64/dependencies/rhcos/4.20/latest/rhcos-live-iso.x86_64.iso |
| 152 | + version: 9.6.20250530-0 |
| 153 | +
|
| 154 | + # Example: LocalVolume disk paths configuration |
| 155 | + - target: |
| 156 | + group: local.storage.openshift.io |
| 157 | + version: v1 |
| 158 | + kind: LocalVolume |
| 159 | + name: local-disks |
| 160 | + namespace: openshift-local-storage |
| 161 | + patch: |- |
| 162 | + - op: replace |
| 163 | + path: /spec/storageClassDevices/0/devicePaths |
| 164 | + value: |
| 165 | + - /dev/nvme1n1 |
| 166 | +---- |
| 167 | + |
| 168 | +For more examples and detailed configurations, see link:https://github.com/openshift-kni/telco-reference/tree/main/telco-hub/configuration/example-overlays-config[telco-reference example overlays]. |
0 commit comments