Create a new swarm in Docker Cloud

Estimated reading time: 2 minutes

You can now create new Docker Swarms from within Docker Cloud as well as register existing swarms.

When you create a swarm, Docker Cloud connects to the provider on your behalf, and uses the provider’s APIs and a provider-specific template to launch Docker instances. The instances are then joined to a swarm and the swarm is configured using your input. When you access the swarm from Docker Cloud, the system forwards your commands directly to the Docker instances running in the swarm.

Note: The Create Swarm functionality is only available for AWS at this time. Additional provider support is coming soon.

Create a swarm

Note: To create a swarm, you need to give Docker Cloud permission to deploy swarm nodes on your behalf in your cloud services provider account. See the AWS with swarm instructions to learn more.

  1. If necessary, log in to Docker Cloud and switch to Swarm Mode.
  2. Click Swarms in the top navigation.
  3. Click Create.
  4. Enter a name for the new swarm.
  5. Select a connected cloud services provider.

    Additional options appear depending on which provider you select.

  6. Enter any additional provider-specific information, such as region.

    Note: The SSH keys that appear in this wizard are filtered by the region you select. Ensure that you have appropriate SSH keys available on the region you select.

  7. Choose how many swarm managers and swarm worker nodes to deploy.
  8. Select the instance sizes for the managers, and for the workers.
  9. Select the SSH key to use to connect to the nodes.

    The list contains any SSH keys that you have access to on your linked cloud services provider. Select the one for which you have the private key locally.

  10. Click Create.

Docker Cloud connects to your AWS account, deploys Docker for AWS instances, forms a Swarm, and joins the instances to it.

Note: At this time, you cannot dissolve swarms or delete swarm nodes from within Docker Cloud - you can only unregister the swarm from the Docker Cloud UI. To delete the swarm and its members, log in to your AWS account and delete them manually.

Where to go next

Learn how to connect to a swarm through Docker Cloud.

Learn how to register existing swarms.

You can get an overview of topics on swarms in Docker Cloud.

To find out more about Docker swarm in general, see the Docker engine Swarm Mode overview.

swarm mode, swarms, create swarm, Cloud