[OSDOCS-4242]: machine sets are for compute only

[jeana-redhat]

Version(s): 4.12+

Issue: OSDOCS-4242

Link to docs preview:

Architecture > Control plane architecture > Machine roles in OpenShift Container Platform

• Cluster workers
• Cluster masters

Installing

• Installing on AWS
  • Installing a cluster on AWS with customizations > Creating the installation configuration file > Sample customized install-config.yaml file for AWS (callout 7)
  • Installing a cluster on user-provisioned infrastructure in AWS by using CloudFormation templates > Required AWS infrastructure components > Cluster machines
• Installing on GCP
  • Installing a cluster on GCP with customizations > Creating the installation configuration file > Sample customized install-config.yaml file for GCP (callout 5)
• Deploying installer-provisioned clusters on bare metal
  • Expanding the cluster > Provisioning the bare metal node
• Installing on VMC > Installing a cluster on VMC with user-provisioned infrastructure
  • Creating the Kubernetes manifest and Ignition config files
  • Installing RHCOS and starting the OpenShift Container Platform bootstrap process

Post-installation configuration

• Configuring a heterogeneous cluster
• Cluster tasks
  • Adjust worker nodes
  • Creating infrastructure machine sets for production environments
• Node tasks
  • Adding RHCOS compute machines to an OpenShift Container Platform cluster > Adding a new RHCOS worker node with a custom /var partition in AWS
• Deploying machine health checks
  • Understanding the difference between compute machine sets and the machine config pool

Support > Troubleshooting > Troubleshooting Windows container workload issues

• Investigating why Windows Machine does not become compute node
• Accessing a Windows node
  • Accessing a Windows node using SSH
  • Accessing a Windows node using RDP
• Collecting Kubernetes node logs for Windows containers
• Collecting Windows application event logs
• Collecting Docker logs for Windows containers

Storage

• Configuring persistent storage > Persistent storage using Azure Disk > Machine sets that deploy machines with ultra disks using PVCs
• Using Container Storage Interface (CSI) > Azure Disk CSI Driver Operator > Machine sets that deploy machines with ultra disks using PVCs

Operators > Administrator tasks > Adding Operators to a cluster

• Pod placement of Operator workloads

Machine management

• Overview of machine management
  • What you can do with compute machine sets
  • Autoscaler
• Creating compute machine sets
  • Creating a compute machine set on Alibaba Cloud
  • Creating a compute machine set on AWS
  • Creating a compute machine set on Azure
  • Creating a compute machine set on Azure Stack Hub
  • Creating a compute machine set on GCP
  • Creating a compute machine set on IBM Cloud
  • Creating a compute machine set on Nutanix
  • Creating a compute machine set on OpenStack
  • Creating a compute machine set on RHV
  • Creating a compute machine set on vSphere
• Manually scaling a compute machine set
• Modifying a compute machine set
• Deleting a machine
• Applying autoscaling to an OpenShift Container Platform cluster
  • About the machine autoscaler
  • Configuring the machine autoscalers
• Creating infrastructure machine sets
  • Creating infrastructure machine sets for production environments
  • Moving resources to infrastructure machine sets
    • Moving the router
    • Moving the default registry
• Managing machines with the Cluster API
• Deploying machine health checks
  • Short-circuiting machine health check remediation
  • Creating a MachineHealthCheck resource for bare metal (callout 4)

Nodes

• Overview of nodes
• Controlling pod placement using node taints
  • Adding taints and tolerations
• Controlling pod placement onto nodes
  • Placing pods on specific nodes using node selectors
• Working with nodes
  • Understanding how to update labels on nodes
  • Deleting nodes

Windows Container support for OpenShift

• Understanding Windows container workloads > Windows workload management
• Creating Windows MachineSet objects
  • Creating a Windows MachineSet object on AWS
  • Creating a Windows MachineSet object on Azure
  • Creating a Windows MachineSet object on vSphere
• Windows node upgrades
• Scheduling Windows container workloads
• Using Bring-Your-Own-Host (BYOH) Windows instances as nodes > Configuring a BYOH Windows instance

Scalability and performance

• Recommended cluster scaling practices
• Managing bare metal hosts

Serverless

• Install > Installing the OpenShift Serverless Operator > Scaling your cluster using compute machine sets

Note Some modules I was not able to locate in the preview:

• modules/installation-osp-dpdk-binding-vfio-pci.adoc
• modules/installation-osp-setting-worker-affinity.adoc
• nodes/nodes-machinepools-about.adoc
• osd_cluster_admin/osd_nodes/osd-nodes-machinepools-about.adoc
• rosa_cluster_admin/rosa_nodes/rosa-nodes-machinepools-about.adoc

QE review:

• [ ] QE has approved this change.

Additional information: Background

[ocpdocs-previewbot]

🤖 Updated build preview is available at: https://51099--docspreview.netlify.app

Build log: https://circleci.com/gh/ocpdocs-previewbot/openshift-docs/2280

[abrennan89]

lgtm for serverless docs, thanks Jeana!

[mburke5678]

@jeana-redhat What you have for Nodes and WINC looks good. Are you going to update the Creating a Windows MachineSet object... assemblies? If so, I have a new assembly that I will update accordingly.

[jeana-redhat]

Thanks @mburke5678! Yes, I have updated the three existing Win machine set topics (here's AWS). So if any new additions can follow that pattern that would be perfect :slightly_smiling_face:

[adellape]

LGTM for Operators guide. 🚀

[sheriff-rh]

Performance/Scalability LGTM! :rocket: :sauropod: :clinking_glasses:

[Amrita42]

@jeana-redhat thanks for taking this up :) For the https://51099--docspreview.netlify.app/openshift-enterprise/latest/windows_containers/index.html (WINC overview page), I can see 3 instances of machine set. I think it should be compute machine set.

[mjpytlak]

@jeana-redhat Installing LGTM. Thanks!

[kelbrown20]

LGTM for Post install heterogeneous clusters 🚀 Thank you Jeana!

[lpettyjo]

LGTM for storage.

[jeana-redhat]

@sunzhaohua2 @miyadav @huali9 This is ready for QA review. I have tagged all three of you in case you want to split up the work, but I leave it up to you to decide what approach is least onerous :slightly_smiling_face:

[sunzhaohua2]

LGTM, thanks Jeana!

[huali9]

Machine management LGTM

[jeana-redhat]

Thanks @opayne1! Those are some good typo finds lol

[jeana-redhat]

/cherrypick enterprise-4.12

[openshift-cherrypick-robot]

@jeana-redhat: new pull request created: #52020

In response to this:

/cherrypick enterprise-4.12

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.