Skip to content

OSDOCS-17043_2#applying CQAs for AWS and Azure#110164

Open
brendan-daly-red-hat wants to merge 1 commit intoopenshift:mainfrom
brendan-daly-red-hat:OSDOCS-17043_3_final
Open

OSDOCS-17043_2#applying CQAs for AWS and Azure#110164
brendan-daly-red-hat wants to merge 1 commit intoopenshift:mainfrom
brendan-daly-red-hat:OSDOCS-17043_3_final

Conversation

@brendan-daly-red-hat
Copy link
Copy Markdown
Contributor

@brendan-daly-red-hat brendan-daly-red-hat commented Apr 15, 2026

Versions:
4.20+

Issue:
https://issues.redhat.com/browse/OSDOCS-17043

Link to docs preview:
Creating a compute machine set on AWS
Creating a compute machine set on Azure
Using the Azure Marketplace offering (Machine management)
Using the Azure Marketplace offering (Installing a cluster on Azure with customizations)
Assigning machines to placement groups for Elastic Fabric Adapter instances by using machine sets
Accelerated Networking for Microsoft Azure VMs
Enabling Azure boot diagnostics
Configuring Azure confidential virtual machines by using machine sets
Enabling Accelerated Networking on an existing Microsoft Azure cluster
Machine sets that deploy machines on Ephemeral OS disks
Configuring trusted launch for Azure virtual machines by using machine sets
Machine sets that deploy machines with ultra disks as data disks (Azure)
Machine sets that deploy machines with ultra disks using PVCs
Configuring Capacity Reservation by using machine sets (Azure)
Configuring Capacity Reservations by using machine sets (AWS)
Creating machines on Ephemeral OS disks by using compute machine sets (Azure)
Creating machines with ultra disks by using machine sets
Creating Spot Instances by using compute machine sets (Azure)
Creating Spot VMs by using compute machine sets (GCP)
Creating preemptible VM instances by using compute machine sets
Enabling customer-managed encryption keys for a machine set
Labeling GPU machine sets for the cluster autoscaler (GCP)
Labeling GPU machine sets for the cluster autoscaler (AWS)
Machine sets that deploy machines as Spot Instances (AWS)
Machine sets that deploy machines as Spot VMs (Azure)
Troubleshooting resources for machine sets that enable ultra disks
Sample YAML for a compute machine set custom resource on Azure (Creating a compute machine set on Azure)
Sample YAML for a compute machine set custom resource on Azure (Creating infrastructure machine sets)
Adding a GPU node to an existing OpenShift cluster

QE review:

  • QE has approved this change.

Additional information:

@openshift-ci openshift-ci bot added needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Apr 15, 2026
@openshift-ci openshift-ci bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 15, 2026
@ocpdocs-previewbot
Copy link
Copy Markdown

🤖 Wed Apr 15 15:55:14 - Prow CI generated the docs preview:
https://110164--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

//jrouth: Also some variations for when it appears in the machine management content (`mapi`).

:_mod-docs-content-type: PROCEDURE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

endif::[]

:_mod-docs-content-type: REFERENCE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

Accelerated Networking uses single root I/O virtualization (SR-IOV) to provide Microsoft Azure VMs with a more direct path to the switch. This enhances network performance. This feature can be enabled
[role="_abstract"]
Accelerated Networking uses single root I/O virtualization (SR-IOV) to provide {azure-first} VMs with a more direct path to the switch. This enhances network performance. This feature can be enabled
ifdef::compute[during or ]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

+
ifdef::compute[Although the minimum requirement for an Azure worker node is two vCPUs, ]
Accelerated Networking requires an Azure VM size that includes at least four vCPUs. To satisfy this requirement, you can change the value of `vmSize` in your machine set. For information about Azure VM sizes, see link:https://docs.microsoft.com/en-us/azure/virtual-machines/sizes[Microsoft Azure documentation].
ifdef::compute[Although the minimum requirement for an {azure-short} worker node is two vCPUs, ]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

endif::[]

:_mod-docs-content-type: PROCEDURE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

`providerSpec.diagnostics.boot.customerManaged.storageAccountURI`:: Replaces `<storage-account>` with the name of your storage account.
--

[NOTE]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

endif::[]

:_mod-docs-content-type: PROCEDURE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

endif::[]

:_mod-docs-content-type: PROCEDURE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

endif::[]

:_mod-docs-content-type: PROCEDURE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

endif::[]

:_mod-docs-content-type: CONCEPT
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

ifdef::azure[= Configuring Capacity Reservation by using machine sets]
ifdef::aws[= Configuring Capacity Reservations by using machine sets]

ifdef::azure[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

= Configuring Capacity Reservation by using machine sets
endif::azure[]

ifdef::aws[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

{product-title} version {product-version} and later supports
ifdef::azure[on-demand Capacity Reservation with Capacity Reservation groups on {azure-full} clusters.]
ifdef::aws[Capacity Reservations on {aws-full} clusters, including On-Demand Capacity Reservations and Capacity Blocks for ML.]
ifdef::azure[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

ifdef::azure[]
on-demand Capacity Reservation with Capacity Reservation groups on {azure-full} clusters. Add `capacityReservationGroupID` to the `MachineSet` YAML.
endif::azure[]
ifdef::aws[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

<2> Specify `userData.txt` as the name of the new custom secret.

. In a text editor, open the `userData.txt` file and locate the final `}` character in the file.
where:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.TaskStep: Content other than a single list cannot be mapped to DITA steps.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.DocumentTitle: The document title (a level 0 heading) is missing.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.DocumentTitle: The document title (a level 0 heading) is missing.

ifdef::azure[= Machine sets that deploy machines as Spot VMs]
ifdef::gcp[= Machine sets that deploy machines as Spot VMs]
ifdef::gcp-legacy-preempt[= Machine sets that deploy machines preemptible VM instances]
ifdef::gcp-legacy-preempt[= Machine sets that deploy machines as preemptible VM instances]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

endif::[]

:_mod-docs-content-type: REFERENCE
include::_attributes/common-attributes.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoNestingInModules: You can only nest snippets or GitHub raw user content in modules.

You can define a machine set YAML to provision nodes by specifying parameters such as `vmSize` and `image`. You can use this to automate and scale infrastructure consistently, to ensure compute nodes meet specific workload requirements within the cluster.

The sample YAML defines a compute machine set that runs in the `1` {azure-first} zone in a region and creates nodes that are labeled with
ifndef::infra[`node-role.kubernetes.io/<role>: ""`.]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

The sample YAML defines a compute machine set that runs in the `1` {azure-first} zone in a region and creates nodes that are labeled with
ifndef::infra[`node-role.kubernetes.io/<role>: ""`.]
ifdef::infra[`node-role.kubernetes.io/infra: ""`.]
ifdef::infra[`node-role.kubernetes.io/infra: ""`. It specifies a taint to prevent user workloads from being scheduled on infra nodes. After adding the `NoSchedule` taint on the infrastructure node, existing DNS pods running on that node are marked as `misscheduled`. You must either delete or link:https://access.redhat.com/solutions/6592171[add toleration on `misscheduled` DNS pods].]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDoc.ValidConditions: File contains unbalanced if statements. Review the file to ensure it contains matching opening and closing if statements.

@openshift-ci
Copy link
Copy Markdown

openshift-ci bot commented Apr 15, 2026

@brendan-daly-red-hat: all tests passed!

Full PR test history. Your PR dashboard.

Details

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-sigs/prow repository. I understand the commands that are listed here.

@brendan-daly-red-hat brendan-daly-red-hat changed the title Osdocs 17043 3 final OSDOCS-17043_2#applying CQAs for AWS and Azure Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants