Host operating system configuration

Available since MCC 2.26.0 (17.1.0 and 16.1.0) TechPreview

Important

The cloud operator takes all risks and responsibility for module execution on cluster machines. For any questions, contact Mirantis support.

Caution

Due to the known issue 49678 addressed in MOSK 25.1, the HostOSConfiguration object may not work as expected after migration to containerd. For details, see the issue description.

The host operating system (OS) configuration API extends configuration management of baremetal-based clusters and machines after initial deployment. The feature allows managing the operating system of a bare metal host granularly using modules without rebuilding the node from scratch. Such approach prevents workload evacuation and significantly reduces configuration time.

The host OS configuration API does not limit the cloud operator’s ability to configure machines in any way, making the operator responsible for day-2 adjustments.

This section provides guidelines for MOSK or custom modules that are used by the HostOSConfiguration and HostOSConfigurationModules custom resources designed for MOSK clusters.

• Host OS configuration management workflow
• Global recommendations for implementation of custom modules
• Format and structure of a module package
• Modules provided by MOSK
• HostOSConfiguration and HostOSConfigurationModules concepts
• Internal API for host OS configuration management
• Add a custom module to a MOSK deployment
• Test a custom or MOSK module after creation
• Retrigger a module configuration
• Troubleshooting

See also

Container Cloud API Reference:

• HostOSConfiguration custom resource

• HostOSConfigurationModules custom resource