Generating Custom AWS CF Templates

Generating Custom AWS CF Templates

You can create custom CloudFormation advanced templates for DC/OS. You can then deploy and run DC/OS from your own private S3 bucket.

The custom templates are created from the DC/OS advanced installer.


  • A node that meets custom installer bootstrap node system requirements.
  • Advanced template system requirements.
  • An Amazon S3 bucket with read-write access.

    • The S3 bucket must have a bucket policy that allows the launched AWS instances to download the files from the s3 bucket. Here is a sample policy that allows anyone to download:

            "Principal": "*",

      For more information about s3 bucket polices, see the AWS Documentation.

  1. Download the to your bootstrap node.
  2. Create a directory named genconf in the home directory of your node and navigate to it.

    $ mkdir -p genconf
  3. Create a configuration file in the genconf directory and save as config.yaml. This configuration file specifies your AWS credentials and the S3 location to store the generated artifacts. These are the required parameters:

    aws_template_storage_bucket: <s3-bucket-name>
    aws_template_storage_bucket_path: <path-to-directory>
    aws_template_storage_region_name: <your-region>
    aws_template_upload: true
    aws_template_storage_access_key_id: <your-access-key-id>
    aws_template_storage_secret_access_key: <your-secret-access_key>

    For parameters descriptions and configuration examples, see the documentation.

  4. Run the DC/OS installer script with the AWS argument specified. This command creates and uploads a custom build of the DC/OS artifacts and templates to the specified S3 bucket.

    $ sudo bash --aws-cloudformation

    The root URL for this bucket location is printed at the end of this step. You should see a message like this:

    AWS CloudFormation templates now available at: https://<amazon-web-endpoint>/<path-to-directory>
  5. Go to S3 and navigate to your S3 bucket shown above in <path-to-directory>.

    1. Select cloudformation and then select the zen template for the number of desired masters. For example, select el7-zen-1.json for a single master configuration.
    2. Right-click and select Properties, and then copy the Amazon S3 template URL.
  6. Go to CloudFormation and click Create Stack.
  7. On the Select Template page, specify the Amazon S3 template URL path to your Zen template. For example,
  8. Complete your installation by following these instructions.

Template reference

For the complete advanced configuration options, see the template reference documentation.