[OSDOCS 12593]:New-add-machine-pool-Win-LI to ROSA HCP docs. #87634
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,100 @@ | ||
| // Module included in the following assemblies: | ||
| // | ||
| // * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc | ||
|
|
||
| :_mod-docs-content-type: PROCEDURE | ||
| [id="creating_a_machine_pools_cli_win_li_{context}"] | ||
| = Creating a machine pool with AWS Windows License Included enabled using the {rosa-cli} | ||
|
|
||
| [role="_abstract"] | ||
| If you are using {VirtProductName} on a {product-title} cluster running Windows VMs you need to be license-compliant with Microsoft Windows in AWS. The hosts (AMD64 bare metal EC2 instances) running these VMs must be enabled with AWS EC2 Windows License Included (LI). | ||
|
|
||
| [IMPORTANT] | ||
| ==== | ||
| Enabling AWS Windows LI on a machine pool applies the associated licensing fees on that specific machine pool. This includes billing for the full vCPU allocation of each AWS Windows LI enabled host in your {product-title} cluster. Windows LI enabled machine pools will also deny vCPU over-allocation on {VirtProductName} VMs. For more information, see link:https://aws.amazon.com/windows/resources/licensing//[Microsoft Licensing on AWS]. | ||
| ==== | ||
|
|
||
| .Prerequisites | ||
|
|
||
| * You installed and configured the {rosa-cli} version 1.2.58 or above. | ||
| * You logged in to your Red{nbsp}Hat account using the {rosa-cli}. | ||
| * You created a {product-title} cluster version 4.19 or above. | ||
| * You identified an AMD64 bare-metal EC2 instance type to use {VirtProductName}. For more, see link:https://aws.amazon.com/ec2/instance-types/#Bare_metal[Amazon EC2 Instance Types]. | ||
| * You are in compliance with Microsoft and AWS requirements for the Microsoft licenses and associated costs. | ||
|
|
||
|
|
||
| .Procedure | ||
|
|
||
| * To add a Windows LI enabled machine pool to a {product-title} cluster, create the machine pool with the following definitions: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ rosa create machinepool --cluster=<cluster-name> \ | ||
| --name=<machine_pool_id> \ | ||
| --replicas=<replica_count> \ | ||
| --instance-type=<instance_type> \ | ||
| --type=<image_type> | ||
| ---- | ||
| where: | ||
|
|
||
| `--name=<machine_pool_id>`:: Specifies the name of the machine pool. Replace `<machine_pool_id>` with the name of your machine pool. | ||
| `--replicas=<replica_count>`:: Specifies the number of compute nodes to provision. If you deployed {product-title} using a single availability zone, this defines the number of compute nodes to provision to the machine pool for the zone. If you deployed your cluster using multiple availability zones, this defines the number of compute nodes to provision in total across all zones and the count must be a multiple of 3. The `--replicas` argument is required when autoscaling is not configured. | ||
| `--instance-type=<instance_type>`:: Specifies the instance type. You can only select an AMD64 bare-metal instance type to enable Windows LI. For example, you can use `m5zn.metal` or `i3.metal`. You cannot change the instance type for a machine pool after the pool is created. | ||
| `--type=<type>`:: You must specify `Windows` to ensure the machine pool is created with Windows LI enabled. | ||
| + | ||
| The following command creates a Windows LI enabled machine pool called `mymachinepool` using the `m5zn.metal` instance type with 1 compute node replica: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ rosa create machinepool --cluster=mycluster --name=mymachinepool --type=Windows --instance-type=m5zn.metal --replicas=1 | ||
| ---- | ||
| + | ||
| .Example output | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA. |
||
| [source,terminal] | ||
| ---- | ||
| I: Machine pool 'mymachinepool' created successfully on cluster 'mycluster' | ||
| I: To view all machine pools, run 'rosa list machinepools -c mycluster' | ||
| ---- | ||
|
|
||
| .Verification | ||
AedinC marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| . List the available machine pools on your cluster by running the following command: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ rosa list machinepools --cluster=<cluster_name> | ||
| ---- | ||
| + | ||
| . Describe the information of a specific machine pool in your cluster: | ||
| + | ||
| [source,terminal] | ||
| ---- | ||
| $ rosa describe machinepool --cluster=<cluster_name> --machinepool=mymachinepool | ||
| ---- | ||
| + | ||
| The output has the image type set to `Windows` as shown in the following example: | ||
| + | ||
| .Example output | ||
|
Collaborator
There was a problem hiding this comment. 🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA. |
||
| [source,terminal] | ||
| ---- | ||
| ID: mymachinepool | ||
| Cluster ID: mycluster | ||
| Autoscaling: No | ||
| Desired replicas: 1 | ||
| Current replicas: 1 | ||
| Instance type: m5zn.metal | ||
| Image type: Windows | ||
|
There was a problem hiding this comment. @hunterkepley Would this thing will be shown in rosa describe machinepool command in GA. |
||
| Labels: | ||
| Tags: | ||
| Taints: | ||
| Availability zone: us-east-1a | ||
| Subnet: <subnet-id> | ||
| Disk Size: 300 GiB | ||
| Version: 4.19.18 | ||
| EC2 Metadata Http Tokens: optional | ||
| Autorepair: Yes | ||
| Tuning configs: | ||
| Kubelet configs: | ||
| Additional security group IDs: | ||
| Node drain grace period: | ||
| ---- | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.