|
| 1 | +// Module included in the following assemblies: |
| 2 | +// |
| 3 | +// * rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc |
| 4 | + |
| 5 | +:_mod-docs-content-type: PROCEDURE |
| 6 | +[id="creating_a_machine_pools_cli_win_li_{context}"] |
| 7 | += Creating a machine pool with AWS Windows License Included enabled using the {rosa-cli} |
| 8 | + |
| 9 | +[role="_abstract"] |
| 10 | +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). |
| 11 | + |
| 12 | +[IMPORTANT] |
| 13 | +==== |
| 14 | +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]. |
| 15 | +==== |
| 16 | + |
| 17 | +.Prerequisites |
| 18 | + |
| 19 | +* You installed and configured the {rosa-cli} version 1.2.58 or above. |
| 20 | +* You logged in to your Red{nbsp}Hat account using the {rosa-cli}. |
| 21 | +* You created a {product-title} cluster version 4.19 or above. |
| 22 | +* 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]. |
| 23 | +* You are in compliance with Microsoft and AWS requirements for the Microsoft licenses and associated costs. |
| 24 | +
|
| 25 | +
|
| 26 | +.Procedure |
| 27 | + |
| 28 | +* To add a Windows LI enabled machine pool to a {product-title} cluster, create the machine pool with the following definitions: |
| 29 | ++ |
| 30 | +[source,terminal] |
| 31 | +---- |
| 32 | +$ rosa create machinepool --cluster=<cluster-name> \ |
| 33 | + --name=<machine_pool_id> \ |
| 34 | + --replicas=<replica_count> \ |
| 35 | + --instance-type=<instance_type> \ |
| 36 | + --type=<image_type> |
| 37 | +---- |
| 38 | +where: |
| 39 | +
|
| 40 | +`--name=<machine_pool_id>`:: Specifies the name of the machine pool. Replace `<machine_pool_id>` with the name of your machine pool. |
| 41 | +`--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. |
| 42 | +`--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. |
| 43 | +`--type=<type>`:: You must specify `Windows` to ensure the machine pool is created with Windows LI enabled. |
| 44 | ++ |
| 45 | +The following command creates a Windows LI enabled machine pool called `mymachinepool` using the `m5zn.metal` instance type with 1 compute node replica: |
| 46 | ++ |
| 47 | +[source,terminal] |
| 48 | +---- |
| 49 | +$ rosa create machinepool --cluster=mycluster --name=mymachinepool --type=Windows --instance-type=m5zn.metal --replicas=1 |
| 50 | +---- |
| 51 | ++ |
| 52 | +.Example output |
| 53 | +[source,terminal] |
| 54 | +---- |
| 55 | +I: Machine pool 'mymachinepool' created successfully on cluster 'mycluster' |
| 56 | +I: To view all machine pools, run 'rosa list machinepools -c mycluster' |
| 57 | +---- |
| 58 | + |
| 59 | +.Verification |
| 60 | + |
| 61 | +. List the available machine pools on your cluster by running the following command: |
| 62 | ++ |
| 63 | +[source,terminal] |
| 64 | +---- |
| 65 | +$ rosa list machinepools --cluster=<cluster_name> |
| 66 | +---- |
| 67 | ++ |
| 68 | +. Describe the information of a specific machine pool in your cluster: |
| 69 | ++ |
| 70 | +[source,terminal] |
| 71 | +---- |
| 72 | +$ rosa describe machinepool --cluster=<cluster_name> --machinepool=mymachinepool |
| 73 | +---- |
| 74 | ++ |
| 75 | +The output has the image type set to `Windows` as shown in the following example: |
| 76 | ++ |
| 77 | +.Example output |
| 78 | +[source,terminal] |
| 79 | +---- |
| 80 | +ID: mymachinepool |
| 81 | +Cluster ID: mycluster |
| 82 | +Autoscaling: No |
| 83 | +Desired replicas: 1 |
| 84 | +Current replicas: 1 |
| 85 | +Instance type: m5zn.metal |
| 86 | +Image type: Windows |
| 87 | +Labels: |
| 88 | +Tags: |
| 89 | +Taints: |
| 90 | +Availability zone: us-east-1a |
| 91 | +Subnet: <subnet-id> |
| 92 | +Disk Size: 300 GiB |
| 93 | +Version: 4.19.18 |
| 94 | +EC2 Metadata Http Tokens: optional |
| 95 | +Autorepair: Yes |
| 96 | +Tuning configs: |
| 97 | +Kubelet configs: |
| 98 | +Additional security group IDs: |
| 99 | +Node drain grace period: |
| 100 | +---- |
0 commit comments