mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
51 lines
1.7 KiB
Plaintext
51 lines
1.7 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * machine_management/cpmso-configuration.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="cpmso-config-prefix_{context}"]
|
|
= Adding a custom prefix to control plane machine names
|
|
|
|
You can customize the prefix of machine names that the control plane machine set creates.
|
|
This can be done by editing the `ControlPlaneMachineSet` custom resource (CR).
|
|
|
|
.Procedure
|
|
|
|
. Edit the `ControlPlaneMachineSet` CR by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc edit controlplanemachineset.machine.openshift.io cluster \
|
|
-n openshift-machine-api
|
|
----
|
|
|
|
. Edit the `.spec.machineNamePrefix` field of the `ControlPlaneMachineSet` CR:
|
|
+
|
|
[source,yaml]
|
|
----
|
|
apiVersion: machine.openshift.io/v1
|
|
kind: ControlPlaneMachineSet
|
|
metadata:
|
|
name: cluster
|
|
namespace: openshift-machine-api
|
|
spec:
|
|
machineNamePrefix: <machine_prefix>
|
|
# ...
|
|
----
|
|
+
|
|
where `<machine_prefix>` specifies a prefix name that follows the requirements for a lowercase RFC 1123 subdomain.
|
|
+
|
|
[IMPORTANT]
|
|
====
|
|
A lowercase RFC 1123 subdomain must consist of only lowercase alphanumeric characters, hyphens ('-'), and periods ('.').
|
|
Each block, separated by periods, must start and end with an alphanumeric character.
|
|
Hyphens are not allowed at the start or end of a block, and consecutive periods are not permitted.
|
|
====
|
|
|
|
. Save your changes.
|
|
|
|
.Next steps
|
|
|
|
* If you changed only the value of the `machineNamePrefix` parameter, clusters that use the default `RollingUpdate` update strategy are not automatically updated.
|
|
To propagate this change, you must replace your control plane machines manually, regardless of the update strategy for the cluster.
|
|
For more information, see "Replacing a control plane machine". |