AWS AWSEC2 documentation change
Summary
Restructured documentation for launching instances with Capacity Blocks, including updated console/CLI/PowerShell instructions, added requirements section about AZ/AMI constraints, and reorganized related resources
Security assessment
Changes focus on operational requirements (AZ alignment, AMI compatibility) and procedure updates rather than addressing security vulnerabilities or describing security features. No evidence of security fixes or new security capabilities.
Diff
diff --git a/AWSEC2/latest/UserGuide/capacity-blocks-launch.md b/AWSEC2/latest/UserGuide/capacity-blocks-launch.md index 830634b5a..5da317e54 100644 --- a//AWSEC2/latest/UserGuide/capacity-blocks-launch.md +++ b//AWSEC2/latest/UserGuide/capacity-blocks-launch.md @@ -5 +5 @@ -# Launch instances into Capacity Blocks +# Launch instances using Capacity Blocks @@ -11 +11 @@ If you terminate an instance running in the Capacity Block before the reservatio -For information about how to set up an EKS managed node group with a Capacity Block, see [Create a managed node group with Capacity Blocks for ML](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html) in the __Amazon EKS User Guide__. +###### Requirements @@ -13 +13,3 @@ For information about how to set up an EKS managed node group with a Capacity Bl -For information about how to set up AWS ParallelCluster using a Capacity Block, see [ML on AWS ParallelCluster](https://catalog.workshops.aws/ml-on-aws-parallelcluster/en-US). + * Your instance can't launch in a subnet in a different Availability Zone from the Availability Zone where your Capacity Block is located. + + * Your instance can't launch using an AMI with a different platform than the platform for your Capacity Block. @@ -15 +16,0 @@ For information about how to set up AWS ParallelCluster using a Capacity Block, -For information about how to launch instances into a Capacity Block using EC2 Fleet, see [Tutorial: Configure your EC2 Fleet to launch instances into Capacity Blocks](./ec2-fleet-launch-instances-capacity-blocks-walkthrough.html). @@ -17 +17,0 @@ For information about how to launch instances into a Capacity Block using EC2 Fl -For information about how to create a Launch Template targeting a Capacity Block, see [Store instance launch parameters in Amazon EC2 launch templates](./ec2-launch-templates.html). @@ -19 +18,0 @@ For information about how to create a Launch Template targeting a Capacity Block -The following steps explain how to launch instances into a Capacity Block in the `active` state using the AWS Management Console or the AWS CLI. @@ -24 +23 @@ Console -###### To launch instances into a Capacity Block using the console +###### To launch instances using a Capacity Block @@ -32 +31 @@ Console - 4. (Optional) Under **Name and tags** , you can name your instance and tag the instance. For information about tags, see [Tag your Amazon EC2 resources](./Using_Tags.html) + 4. Follow the procedure to [launch an instance](./ec2-launch-instance-wizard.html). @@ -34 +33 @@ Console - 5. Under **Application and OS Images (Amazon Machine Image)** , select an Amazon Machine Image (AMI). + 5. Expand **Advanced details** , and then configure the instance as follows. @@ -36 +35 @@ Console - 6. Under **Instance type** , select the instance type that matches your Capacity Block reservation. + 1. For **Purchasing option** , choose **Capacity Blocks**. @@ -38 +37 @@ Console - 7. Under **Key pair (login)** , choose an existing key pair or choose **Create new key pair** to create a new one. For more information, see [Amazon EC2 key pairs and Amazon EC2 instances](./ec2-key-pairs.html). + 2. For **Capacity Reservation** , choose **Specify Capacity Reservation**. @@ -40 +39 @@ Console - 8. Under **Network settings** , use the default settings, or choose **Edit** to configure the network settings as necessary. + 3. For **Capacity Reservation targeted ID** , choose the ID of your Capacity Block reservation. @@ -42 +41 @@ Console -###### Important + 6. Choose **Launch instance**. @@ -44 +42,0 @@ Console -Your instance can't launch in a subnet in a different Availability Zone from the Availability Zone where your Capacity Block is located. @@ -46 +43,0 @@ Your instance can't launch in a subnet in a different Availability Zone from the -Your instance can't launch using an AMI with a different platform from the platform on your Capacity Block. @@ -48 +44,0 @@ Your instance can't launch using an AMI with a different platform from the platf - 9. Under **Advanced details** , configure the instance as follows. @@ -50 +46 @@ Your instance can't launch using an AMI with a different platform from the platf - 1. For **Purchasing option** , select **Capacity Blocks**. +AWS CLI @@ -52 +47,0 @@ Your instance can't launch using an AMI with a different platform from the platf - 2. For **Capacity Reservation** , select **Target by ID**. @@ -54 +49 @@ Your instance can't launch using an AMI with a different platform from the platf - 3. Select the Capacity Reservation ID of your Capacity Block reservation. +###### To launch instances using a Capacity Block @@ -56 +51 @@ Your instance can't launch using an AMI with a different platform from the platf - 10. On the **Summary** panel, for **Number of instances** , enter the number of instances to launch. +Use the [run-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html) command with the `MarketType` option. @@ -58 +52,0 @@ Your instance can't launch using an AMI with a different platform from the platf - 11. Choose **Launch instance**. @@ -59,0 +54 @@ Your instance can't launch using an AMI with a different platform from the platf + --instance-market-options MarketType='capacity-block' @@ -60,0 +56 @@ Your instance can't launch using an AMI with a different platform from the platf +You must also specify the `capacity-reservation-specification` option. @@ -63 +59 @@ Your instance can't launch using an AMI with a different platform from the platf -AWS CLI + --capacity-reservation-specification CapacityReservationTarget={CapacityReservationId=cr-0abc123def456789a} @@ -64,0 +61 @@ AWS CLI +PowerShell @@ -66 +62,0 @@ AWS CLI -###### To launch instances into a Capacity Block using the AWS CLI @@ -68 +64 @@ AWS CLI - * Use the `run-instances` command and specify a `MarketType` of `capacity-block` in the `instance-market-options` structure. You must also specify the `capacity-reservation-specification` parameter. +###### To launch instances using a Capacity Block @@ -70 +66 @@ AWS CLI -The following example launches a single `p5.48xlarge` instance into an active Capacity Block that has matching attributes and available capacity. +Use the [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) cmdlet with the `-InstanceMarketOption` parameter. @@ -72,5 +67,0 @@ The following example launches a single `p5.48xlarge` instance into an active Ca - aws ec2 run-instances --image-id ami-0abcdef1234567890 --count 1 \ - --instance-type p5.48xlarge --key-name MyKeyPair \ - --subnet-id subnet-1234567890abcdef1 \ - --instance-market-options MarketType='capacity-block' - --capacity-reservation-specification CapacityReservationTarget={CapacityReservationId=cr-a1234567} @@ -78 +69,18 @@ The following example launches a single `p5.48xlarge` instance into an active Ca -###### Important + -InstanceMarketOption $marketOptions + +Define the market options as follows. + + + $marketOptions = New-Object Amazon.EC2.Model.InstanceMarketOptionsRequest + $marketOptions.MarketType = "capacity-block" + +You must also specify the `-CapacityReservationTarget_CapacityReservationId` option. + + + -CapacityReservationTarget_CapacityReservationId cr-0abc123def456789a + +###### Related resources + + * To create a launch template targeting a Capacity Block, see [Store instance launch parameters in Amazon EC2 launch templates](./ec2-launch-templates.html). + + * To launch instances into a Capacity Block using EC2 Fleet, see [Tutorial: Configure your EC2 Fleet to launch instances into Capacity Blocks](./ec2-fleet-launch-instances-capacity-blocks-walkthrough.html). @@ -80 +88 @@ The following example launches a single `p5.48xlarge` instance into an active Ca -Your instance can't launch in a subnet in a different Availability Zone from the Availability Zone where your Capacity Block is located. + * To set up an EKS managed node group with a Capacity Block, see [Create a managed node group with Capacity Blocks for ML](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html) in the __Amazon EKS User Guide__. @@ -82 +90 @@ Your instance can't launch in a subnet in a different Availability Zone from the -Your instance can't launch using an AMI with a different platform from the platform on your Capacity Block. + * To set up AWS ParallelCluster using a Capacity Block, see [ML on AWS ParallelCluster](https://catalog.workshops.aws/ml-on-aws-parallelcluster/en-US).