1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/rosa-adding-tuning.adoc
2024-10-21 15:18:46 -04:00

98 lines
3.0 KiB
Plaintext

// Module included in the following assemblies:
//
// * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-adding-tuning_{context}"]
= Adding node tuning to a machine pool
You can add tunings for compute, also called worker, nodes in a machine pool to control their configuration on {product-title} clusters.
.Prerequisites
* You installed and configured the latest {product-title} (ROSA) CLI, `rosa`, on your workstation.
* You logged in to your Red{nbsp}Hat account by using the ROSA CLI.
* You created a {product-title} cluster.
* You have an existing machine pool.
* You have an existing tuning configuration.
.Procedure
. List all of the machine pools in the cluster:
+
[source,terminal]
----
$ rosa list machinepools --cluster=<cluster_name>
----
+
.Example output
+
[source,terminal]
----
ID AUTOSCALING REPLICAS INSTANCE TYPE LABELS TAINTS AVAILABILITY ZONE SUBNET VERSION AUTOREPAIR
db-nodes-mp No 0/2 m5.xlarge us-east-2a subnet-08d4d81def67847b6 4.14.34 Yes
workers No 2/2 m5.xlarge us-east-2a subnet-08d4d81def67847b6 4.14.34 Yes
----
. You can add tuning configurations to an existing or new machine pool.
.. Add tunings when creating a machine pool:
+
[source,terminal]
----
$ rosa create machinepool -c <cluster-name> --name <machinepoolname> --tuning-configs <tuning_config_name>
----
+
.Example output
[source,terminal]
----
? Tuning configs: sample-tuning
I: Machine pool 'db-nodes-mp' created successfully on hosted cluster 'sample-cluster'
I: To view all machine pools, run 'rosa list machinepools -c sample-cluster'
----
.. Add or update the tunings for a machine pool:
+
[source,terminal]
----
$ rosa edit machinepool -c <cluster-name> --name <machinepoolname> --tuning-configs <tuning_config_name>
----
+
.Example output
[source,terminal]
----
I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'
----
.Verification
. Describe the machine pool for which you added a tuning config:
+
[source,terminal]
----
$ rosa describe machinepool --cluster=<cluster_name> --machinepool=<machine_pool_name>
----
+
.Example output
[source,terminal]
----
ID: db-nodes-mp
Cluster ID: <cluster_ID>
Autoscaling: No
Desired replicas: 2
Current replicas: 2
Instance type: m5.xlarge
Labels:
Tags:
Taints:
Availability zone: us-east-2a
Subnet: subnet-08d4d81def67847b6
Version: 4.14.34
EC2 Metadata Http Tokens: optional
Autorepair: Yes
Tuning configs: sample-tuning
...
----
. Verify that the tuning config is included for your machine pool in the output.