Create a pool

Important

  • You must have permission to create a pool; see Pool access control.

  • You must add the following permissions to the access policy associated with the IAM role or keys used to create your AWS account:

    {
      "Action": [
        "ec2:AssociateIamInstanceProfile",
        "ec2:DescribeIamInstanceProfileAssociations",
        "ec2:DisassociateIamInstanceProfile",
        "ec2:ReplaceIamInstanceProfileAssociation",
        "ec2:DeleteTags"
      ]
    }
    

    For the complete list of permissions and instructions on how to update your existing IAM role or keys, see Configure your AWS account.

    If you do not add these permissions, you will not be able to start the cluster attached to the pool.

This article describes how to create a pool using the UI.

To create a pool:

  1. Click the clusters icon Clusters Icon in the sidebar.

  2. Click the Pools tab.

    Pools tab
  3. Click the Create Pool button at the top of the page.

    Create pool
  4. Specify the pool configuration.

  5. Click the Create button.

    Create button

You will notice idle instances in the pending state. When they are no longer pending, clusters attached to the pool will start faster.

Pool details

To create a pool using the REST API, see the Instance Pools API documentation.