These steps shows you how you can quickly and easily deploy Portworx on AWS CloudFormation

Portworx has provided a CloudFormation stack, based on CoreOS 1235.4.0 (“Stable”) that will bring up a complete 3-node px-dev stack in less than 10 minutes.

This template includes the following to enable Portworx deployments:

  • An additional non-root device called “/dev/xvdb” for the global shared storage pool of configurable size
  • Opened ports for ‘etcd’, ‘ssh’, and ‘portworx’ management services (2379, 2380, 4001, 9001, 9002, 9003, 9004)

Important:
Your AWS account settings must allow you to create SecurityGroup resources, otherwise you will not be able to use this.

Configure and Launch the Portworx stack

Launch Stack

  • Click the “Launch Stack” button above. The Portworx Template is automatically loaded into CloudFormation. Click Next

  • Pick a specific Name for the Stack. (default = PX-STACK)

  • Specify any restrictions on ssh access via “AllowSSHFrom” (default 0.0.0.0/0)

  • Specify the Discovery URL. Copy the entire output string that is returned from https://discovery.etcd.io/new?size=3

  • Select the instance type from the list (default type is ‘m3.medium’)

  • Select the volume size of the non-root volume, configurable from 8GB to 4TB (default size is 128 GB)

  • Select the name of your available key-pairs (assumed to be existing) You may see a message indicating AWS is “Unable to list IAM roles”, which can be safely ignored.

  • Create the stack and wait for completion. After the stack status is “CREATE COMPLETE”, it may still be 5 minutes before Portworx is available. You can use this script to query the instances IP address, via ssh -i pub.key core@IPaddr, where pub.key is the key selected from the Template drop-down and IPaddr is one of the addresses returned from the above script.

Next Steps

Go use containers that require data persistence, high-availability, snapshots and other container-granular services.

The Portworx CloudFormation Template is freely available and can be easily customized.

Edit this page