Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 15 additions & 12 deletions modules/machineset-aws-existing-placement-group.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,21 +49,24 @@ spec:
spec:
providerSpec:
value:
instanceType: <supported_instance_type> # <1>
networkInterfaceType: EFA # <2>
instanceType: <supported_instance_type>
networkInterfaceType: EFA
placement:
availabilityZone: <zone> # <3>
region: <region> # <4>
placementGroupName: <placement_group> # <5>
placementGroupPartition: <placement_group_partition_number> # <6>
availabilityZone: <zone>
region: <region>
placementGroupName: <placement_group>
placementGroupPartition: <placement_group_partition_number>
# ...
----
<1> Specify an instance type that link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types[supports EFAs].
<2> Specify the `EFA` network interface type.
<3> Specify the zone, for example, `us-east-1a`.
<4> Specify the region, for example, `us-east-1`.
<5> Specify the name of the existing AWS placement group to deploy machines in.
<6> Optional: Specify the partition number of the existing AWS placement group to deploy machines in.
where:
--
`spec.providerSpec.value.instanceType`:: Specifies an instance type that link:https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html#efa-instance-types[supports EFAs].
`spec.providerSpec.value.networkInterfaceType`:: Specifies the `EFA` network interface type.
`spec.providerSpec.value.placement.availabilityZone`:: Specifies the zone, for example, `us-east-1a`.
`spec.providerSpec.value.placement.region`:: Specifies the region, for example, `us-east-1`.
`spec.providerSpec.value.placement.placementGroupName`:: Specifies the name of the existing AWS placement group to deploy machines in.
`spec.providerSpec.value.placement.placementGroupPartition`:: Specifies the partition number of the existing AWS placement group to deploy machines in.
--

.Verification

Expand Down
27 changes: 14 additions & 13 deletions modules/machineset-capacity-reservation.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -26,23 +26,23 @@ ifdef::azure[on-demand Capacity Reservation with Capacity Reservation groups on
ifdef::aws[Capacity Reservations on {aws-full} clusters, including On-Demand Capacity Reservations and Capacity Blocks for ML.]

You can configure a machine set to deploy machines on any available resources that match the parameters of a capacity request that you define.
These parameters specify the
These parameters specify the
ifdef::azure[VM size,]
ifdef::aws[instance type,]
region, and number of instances that you want to reserve.
If your
If your
ifdef::azure[{azure-short} subscription quota]
ifdef::aws[Capacity Reservation]
can accommodate the capacity request, the deployment succeeds.

For more information, including limitations and suggested use cases for this
For more information, including limitations and suggested use cases for this
ifdef::azure[{azure-short} offering, see link:https://learn.microsoft.com/en-us/azure/virtual-machines/capacity-reservation-overview[On-demand Capacity Reservation] in the {azure-full} documentation.]
ifdef::aws[{aws-short} offering, see link:https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/capacity-reservation-overview.html[On-Demand Capacity Reservations and Capacity Blocks for ML] in the {aws-short} documentation.]

ifdef::azure[]
[NOTE]
====
You cannot change an existing Capacity Reservation configuration for a machine set.
You cannot change an existing Capacity Reservation configuration for a machine set.
To use a different Capacity Reservation group, you must replace the machine set and the machines that the previous machine set deployed.
====
endif::azure[]
Expand Down Expand Up @@ -86,11 +86,11 @@ tag::compute[]
providerSpec:
value:
ifdef::azure[]
capacityReservationGroupID: <capacity_reservation_group> # <1>
capacityReservationGroupID: <capacity_reservation_group>
endif::azure[]
ifdef::aws[]
capacityReservationId: <capacity_reservation> # <1>
marketType: <market_type> # <2>
capacityReservationId: <capacity_reservation>
marketType: <market_type>
endif::aws[]
end::compute[]
tag::controlplane[]
Expand All @@ -99,21 +99,22 @@ tag::controlplane[]
providerSpec:
value:
ifdef::azure[]
capacityReservationGroupID: <capacity_reservation_group> # <1>
capacityReservationGroupID: <capacity_reservation_group>
endif::azure[]
ifdef::aws[]
capacityReservationId: <capacity_reservation> # <1>
marketType: <market_type> # <2>
capacityReservationId: <capacity_reservation>
marketType: <market_type>
endif::aws[]
end::controlplane[]
# ...
----
<1> Specify the ID of the
where:
`spec.providerSpec.value.capacityReservationGroupID`:: Specifies the ID of the
ifdef::azure[Capacity Reservation group]
ifdef::aws[Capacity Block for ML or On-Demand Capacity Reservation]
that you want the machine set to deploy machines on.
ifdef::aws[]
<2> Specify the market type to use.
`spec.providerSpec.value.marketType`:: Specifies the market type to use.
The following values are valid:
`CapacityBlock`:: Use this market type with Capacity Blocks for ML.
`OnDemand`:: Use this market type with On-Demand Capacity Reservations.
Expand Down Expand Up @@ -146,7 +147,7 @@ tag::compute[]
where `<machine_set_name>` is the name of the compute machine set.
end::compute[]
+
In the output, verify that the characteristics of the listed machines match the parameters of your
In the output, verify that the characteristics of the listed machines match the parameters of your
ifdef::azure[Capacity Reservation.]
ifdef::aws[Capacity Reservation.]

Expand Down