Skip to content

Latest commit

 

History

History
70 lines (41 loc) · 2.98 KB

01_allocate_host.md

File metadata and controls

70 lines (41 loc) · 2.98 KB

Allocate an EC2 Mac Dedicated Host

Before you begin:

  • Ensure that you have checked the Service Quotas Console for Running Dedicated mac1/mac2/mac2-m2/mac2-m2pro Hosts, and that the Applied Quota Value for your desired instance type is not zero (0).

    The Service Quotas Console with 'mac1' typed into the search bar.

  • Ensure that the IAM User or Role you are using has EC2:AllocateHosts permission.

Using the AWS Management Console:

  • Go to the EC2 Dashboard and select Dedicated Hosts from the sidebar.

    The EC2 Dashboard with the Dedicated Hosts sidebar highlighted.

  • Select the Allocate Dedicated Host button from the top right.

    The EC2 Dedicated Host console with the Allocate button highlighted.

  • Choose a name tag and availability zones for your host. Select the appropriate instance type for your desired architecture (x86-based EC2 Mac instances are mac1.metal, M1-based EC2 Mac instances are mac2.metal, M2-based instances are mac2-m2.metal and M2 Pro-based instances are mac2-m2pro.metal).

    • Support multiple instance types is not supported with EC2 Mac and must be un-checked. Under the Instance Type dropdown that appears after un-checking, choose the only option that appears to match the host type.
    • Host maintenance is currently not supported with EC2 Mac and must be un-checked.
    • Host recovery is currently not supported with EC2 Mac.
      • We suggest leaving Instance auto-placement on to simplify configuration of the instance, detailed in the next step.

  • See the image below for an example:

    The EC2 Dedicated Host allocation dialog screen.

  • Once allocated, the host will appear in the list as Available.

    The EC2 Dedicated Host console with the 'Available' status column highlighted.

Using the AWS CLI

aws ec2 allocate-hosts --availability-zone="us-east-2b" \
--auto-placement="on" --host-recovery="off" \
--host-maintenance "off" --quantity=1 \
--instance-type="mac1.metal" \
--region="us-east-2"

It will return a JSON:

{
    "HostIds": [
        "h-0553a22d4e0123456"
    ]
}

Continue on to the next step, launching an EC2 Mac instance.