You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
== Backing up and restoring etcd on a hosted cluster in AWS
20
+
== Backing up and restoring etcd on a hosted cluster on {aws-short}
24
21
25
22
If you use hosted control planes for {product-title}, the process to back up and restore etcd is different from xref:../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backing-up-etcd-data_backup-etcd[the usual etcd backup process].
26
23
27
-
The following procedures are specific to hosted control planes on AWS.
24
+
The following procedures are specific to hosted control planes on {aws-short}.
25
+
26
+
:FeatureName: Hosted control planes on the {aws-short} platform
== Disaster recovery for a hosted cluster within an AWS region
36
+
== Disaster recovery for a hosted cluster within an {aws-short} region
37
37
38
-
In a situation where you need disaster recovery (DR) for a hosted cluster, you can recover a hosted cluster to the same region within AWS. For example, you need DR when the upgrade of a management cluster fails and the hosted cluster is in a read-only state.
38
+
In a situation where you need disaster recovery (DR) for a hosted cluster, you can recover a hosted cluster to the same region within {aws-short}. For example, you need DR when the upgrade of a management cluster fails and the hosted cluster is in a read-only state.
39
39
40
40
:FeatureName: Hosted control planes
41
41
include::snippets/technology-preview.adoc[]
@@ -77,10 +77,10 @@ Consider an scenario where you have three clusters to restore. Two are managemen
77
77
* HC Kubeconfig: The hosted cluster `kubeconfig` file
78
78
* SSH key file: The SSH public key
79
79
* Pull secret: The pull secret file to access the release images
80
-
* AWS credentials
81
-
* AWS region
80
+
* {aws-short} credentials
81
+
* {aws-short} region
82
82
* Base domain: The DNS base domain to use as an external DNS
83
-
* S3 bucket name: The bucket in the AWS region where you plan to upload the etcd backup
83
+
* S3 bucket name: The bucket in the {aws-short} region where you plan to upload the etcd backup
84
84
85
85
This information is shown in the following example environment variables.
Copy file name to clipboardExpand all lines: hosted_control_planes/hcp-configuring.adoc
+22-21Lines changed: 22 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,45 +8,46 @@ toc::[]
8
8
9
9
To get started with hosted control planes for {product-title}, you first configure your hosted cluster on the provider that you want to use. Then, you complete a few management tasks.
10
10
11
-
:FeatureName: Hosted control planes
12
-
include::snippets/technology-preview.adoc[]
13
-
14
11
You can view the procedures by selecting from one of the following providers:
15
12
16
-
[id="hcp-configuring-aws"]
17
-
== Amazon Web Services (AWS)
18
-
19
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosting-cluster-aws-infra-reqs[AWS infrastructure requirements]: Review the infrastructure requirements to create a hosted cluster on AWS.
20
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosting-service-cluster-configure-aws[Configuring the hosting cluster on AWS]: The tasks to configure a hosted cluster on AWS include creating the AWS S3 OIDC secret, creating a routable public zone, enabling external DNS, enabling AWS PrivateLink, enabling the hosted control planes feature, and installing the hosted control planes CLI.
21
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosted-control-planes-manage-aws[Managing hosted control plane clusters on AWS]: Management tasks include creating, importing, accessing, or deleting a hosted cluster on AWS.
22
-
* xref:../networking/hardware_networks/configuring-sriov-operator.adoc#sriov-operator-hosted-control-planes_configuring-sriov-operator[Deploying the SR-IOV Operator for hosted control planes]: After you configure and deploy your hosting service cluster, you can create a subscription to the Single Root I/O Virtualization (SR-IOV) Operator on a hosted cluster. The SR-IOV pod runs on worker machines rather than the control plane.
23
-
* xref:../scalability_and_performance/using-node-tuning-operator.adoc#node-tuning-hosted-cluster_node-tuning-operator[Configuring node tuning in a hosted cluster]: To set node-level tuning on the nodes in your hosted cluster, you can use the Node Tuning Operator. In hosted control planes, you can configure node tuning by creating config maps that contain `Tuned` objects and referencing those config maps in your node pools.
24
-
* xref:../scalability_and_performance/using-node-tuning-operator.adoc#advanced-node-tuning-hosted-cluster_node-tuning-operator[Advanced node tuning for hosted clusters by setting kernel boot parameters]: More advanced tuning in hosted control planes requires setting kernel boot parameters.
25
-
26
13
[id="hcp-configuring-bm"]
27
14
== Bare metal
28
15
29
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#infrastructure-reqs-bare-metal[Bare metal infrastructure requirements]: Review the infrastructure requirements to create a hosted cluster on bare metal.
30
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#configuring-hosting-service-cluster-configure-bm[Configuring the hosting cluster on bare metal]:
16
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#infrastructure-reqs-bare-metal[Bare metal infrastructure requirements]: Review the infrastructure requirements to create a hosted cluster on bare metal.
17
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#configuring-hosting-service-cluster-configure-bm[Configuring the hosting cluster on bare metal]:
31
18
** Configure DNS
32
19
** Create an `InfraEnv` resource and add agents to it
33
20
** Create a hosted cluster and verify cluster creation
34
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosted-control-planes-manage-bm[Managing hosted control plane clusters on bare metal]:
21
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosted-control-planes-manage-bm[Managing hosted control plane clusters on bare metal]:
35
22
** Scale the `NodePool` object for a hosted cluster
36
-
** Handle Ingress for a hosted cluster
23
+
** Handle ingress traffic for a hosted cluster
37
24
** Enable node auto-scaling for a hosted cluster
38
25
** Destroy a hosted cluster
39
26
40
27
[id="hcp-configuring-virt"]
41
28
== {VirtProductName}
42
29
43
-
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosted-control-planes-manage-kubevirt[Managing hosted control plane clusters on OpenShift Virtualization]: Create {product-title} clusters with worker nodes that are hosted by KubeVirt virtual machines.
30
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosted-control-planes-manage-kubevirt[Managing hosted control plane clusters on OpenShift Virtualization]: Create {product-title} clusters with worker nodes that are hosted by KubeVirt virtual machines.
44
31
45
-
// To be added after ACM 2.9 goes live:
32
+
[id="hcp-configuring-aws"]
33
+
== {aws-first}
46
34
47
-
// IBM Power
48
-
// IBM Z
35
+
:FeatureName: Hosted control planes on the {aws-short} platform
36
+
include::snippets/technology-preview.adoc[]
49
37
38
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosting-cluster-aws-infra-reqs[AWS infrastructure requirements]: Review the infrastructure requirements to create a hosted cluster on {aws-short}.
39
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosting-service-cluster-configure-aws[Configuring the hosting cluster on AWS]: The tasks to configure a hosted cluster on {aws-short} include creating the {aws-short} S3 OIDC secret, creating a routable public zone, enabling external DNS, enabling {aws-short} PrivateLink, enabling the hosted control planes feature, and installing the hosted control planes CLI.
40
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosted-control-planes-manage-aws[Managing hosted control plane clusters on AWS]: Management tasks include creating, importing, accessing, or deleting a hosted cluster on {aws-short}.
41
+
* xref:../networking/hardware_networks/configuring-sriov-operator.adoc#sriov-operator-hosted-control-planes_configuring-sriov-operator[Deploying the SR-IOV Operator for hosted control planes]: After you configure and deploy your hosting service cluster, you can create a subscription to the Single Root I/O Virtualization (SR-IOV) Operator on a hosted cluster. The SR-IOV pod runs on worker machines rather than the control plane.
50
42
43
+
[id="hcp-configuring-ibmz"]
44
+
== {ibm-z-title}
51
45
46
+
:FeatureName: Hosted control planes on the {ibm-z-title} platform
47
+
include::snippets/technology-preview.adoc[]
48
+
49
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#configuring-hosting-service-cluster-ibmz[Configuring the hosting cluster on x86 bare metal for IBM Z compute nodes]
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#trouble-hosted-cluster-backplane[Must-gather for a hosted cluster]
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosted-control-planes-intro[Hosted control planes (Technology Preview)]
16
+
* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosted-control-planes-intro[Hosted control planes]
* xref:../scalability_and_performance/using-node-tuning-operator.adoc#node-tuning-hosted-cluster_node-tuning-operator[Configuring node tuning in a hosted cluster]
25
+
* xref:../scalability_and_performance/using-node-tuning-operator.adoc#advanced-node-tuning-hosted-cluster_node-tuning-operator[Advanced node tuning for hosted clusters by setting kernel boot parameters]
= Advanced node tuning for hosted clusters by setting kernel boot parameters
9
9
10
-
:FeatureName: Hosted control planes
11
-
include::snippets/technology-preview.adoc[]
12
-
13
10
For more advanced tuning in hosted control planes, which requires setting kernel boot parameters, you can also use the Node Tuning Operator. The following example shows how you can create a node pool with huge pages reserved.
Copy file name to clipboardExpand all lines: modules/hosted-control-planes-overview.adoc
+2-5Lines changed: 2 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,14 +6,11 @@
6
6
7
7
:_mod-docs-content-type: CONCEPT
8
8
[id="hosted-control-planes-overview_{context}"]
9
-
= Introduction to hosted control planes (Technology Preview)
9
+
= Introduction to hosted control planes
10
10
11
11
You can use hosted control planes for Red Hat {product-title} to reduce management costs, optimize cluster deployment time, and separate management and workload concerns so that you can focus on your applications.
12
12
13
-
You can enable hosted control planes as a Technology Preview feature by using the link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#cluster_mce_overview[multicluster engine for Kubernetes operator version 2.0 or later] on Amazon Web Services (AWS), bare metal by using the Agent provider, or {VirtProductName}.
14
-
15
-
:FeatureName: Hosted control planes
16
-
include::snippets/technology-preview.adoc[]
13
+
You can enable hosted control planes by using the link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#cluster_mce_overview[multicluster engine for Kubernetes operator version 2.0 or later] on bare metal by using the Agent provider, or {VirtProductName}. Hosted control planes is available as a Technology Preview feature on the {aws-first} and {ibm-z-title} platforms.
Copy file name to clipboardExpand all lines: modules/node-tuning-hosted-cluster.adoc
-3Lines changed: 0 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,9 +8,6 @@
8
8
9
9
//# Manage node-level tuning with the Node Tuning Operator
10
10
11
-
:FeatureName: Hosted control planes
12
-
include::snippets/technology-preview.adoc[]
13
-
14
11
To set node-level tuning on the nodes in your hosted cluster, you can use the Node Tuning Operator. In hosted control planes, you can configure node tuning by creating config maps that contain `Tuned` objects and referencing those config maps in your node pools.
For more information about hosted control planes, see link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview#hosted-control-planes-intro[Hosted control planes (Technology Preview)].
33
+
For more information about hosted control planes, see link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#hosted-control-planes-intro[Hosted control planes].
0 commit comments