Configuration Reference - AWS

Configuring your DC/OS installation on AWS using the Universal Installer

The Mesosphere Universal Installer supports a wide range of inputs/variables to add to your main.tf and enable you to customize your DC/OS cluster to your needs. These inputs/variables include everything from specifying the operating system (CentOS, CoreOS, RHEL) to setting the garbage collection time of your DC/OS cluster.

The Terraform-based Universal Installer is designed to be flexible with configuration. Below is an example of a custom main.tf that provisions a customized DC/OS 1.13.3 cluster on AWS.

Supported DC/OS Versions

Currently, the Universal Installer defaults to 1.11.4 when using v0.1.0 modules and 1.13.3 for v0.2.0 modules. The following versions of DC/OS are currently supported. It is always recommended to specify a version.

dcos_version: "1.13.3"

DC/OS Release

1.13

1.12

1.11

1.10

Latest

"1.13.3"

"1.12.4"

“1.11.11”

“1.10.11”

-

"1.13.2"

"1.12.3"

“1.11.10”

“1.10.10”

-

"1.13.1"

"1.12.2"

“1.11.9”

“1.10.9”

-

"1.13.0"

"1.12.1"

“1.11.8”

“1.10.8”

-

-

"1.12.0"

“1.11.7”

“1.10.7”

-

-

-

“1.11.6”

“1.10.6”

-

-

-

“1.11.5”

“1.10.5”

-

-

-

“1.11.4”

“1.10.4”

-

-

-

“1.11.3”

“1.10.3”

-

-

-

“1.11.2”

“1.10.2”

-

-

-

“1.11.1”

“1.10.1”

-

-

-

1.11.0

“1.10.0”

Supported Instance (Node) OS Versions

The default instance OS is currently centos_7.5, and will be applied unless specified in the configuration. The following instance operating systems are supported by DC/OS. To change the default OS, the following paramaters can be changed:

dcos_instance_os = "centos_7.5"

Instance OS Version

Value

CentOS 7.6

“centos_7.6”

CentOS 7.5

“centos_7.5”

CentOS 7.4

“centos_7.4”

RHEL

“rhel_7.6”

RHEL

“rhel_7.5”

RHEL

“rhel_7.4”

Here is a list of all the variables that are currently supported on the Universal Installer and available for you to customize your cluster.

Inputs

Name

Description

Type

Default

Required

admin_ips

List of CIDR admin IPs

list

n/a

yes

ssh_public_key_file

Path to SSH public key. This is mandatory but can be set to an empty string if you want to use ssh_public_key with the key as string.

string

n/a

yes

accepted_internal_networks

Subnet ranges for all internal networks

list

[]

no

additional_private_agent_ips

Additional private agent IPs.

list

[]

no

additional_public_agent_ips

Additional public agent IPs.

list

[]

no

additional_windows_private_agent_ips

Additional windows private agent IPs

list

[]

no

additional_windows_private_agent_os_user

Additional windows private agent os user to be used for WinRM

string

"Administrator"

no

additional_windows_private_agent_passwords

Additional windows private agent passwords to be used for WinRM

list

[]

no

ansible_additional_config

Add additional config options to ansible. This is getting merged with generated defaults. Do not specify dcos:

string

""

no

ansible_bundled_container

Docker container with bundled dcos-ansible and ansible executables

string

"mesosphere/dcos-ansible-bundle:latest"

no

availability_zones

List of availability_zones to be used as the same format that are required by the platform/cloud providers. i.e ['RegionZone']

list

[]

no

aws_ami

AMI that will be used for the instances instead of the Mesosphere chosen default images. Custom AMIs must fulfill the Mesosphere DC/OS system-requirements: See /mesosphere/dcos/1.12/installing/production/system-requirements/

string

""

no

aws_key_name

Specify the aws ssh key to use. We assume its already loaded in your SSH agent. Set ssh_public_key_file to empty string

The address of the load balancer in front of the masters (recommended)

string

""

no

dcos_exhibitor_azure_account_key

the azure account key for exhibitor storage (optional but required with dcos_exhibitor_address)

string

""

no

dcos_exhibitor_azure_account_name

the azure account name for exhibitor storage (optional but required with dcos_exhibitor_address)

string

""

no

dcos_exhibitor_azure_prefix

the azure account name for exhibitor storage (optional but required with dcos_exhibitor_address)

string

""

no

dcos_exhibitor_explicit_keys

set whether you are using AWS API keys to grant Exhibitor access to S3. (optional)

string

""

no

dcos_exhibitor_storage_backend

options are static, aws_s3, azure, or zookeeper (recommended)

string

"static"

no

dcos_exhibitor_zk_hosts

a comma-separated list of one or more ZooKeeper node IP and port addresses to use for configuring the internal Exhibitor instances. (not recommended but required with exhibitor_storage_backend set to ZooKeeper. Use aws_s3 or azure instead. Assumes external ZooKeeper is already online.)

string

""

no

dcos_exhibitor_zk_path

the filepath that Exhibitor uses to store data (not recommended but required with exhibitor_storage_backend set to zookeeper. Use aws_s3 or azureinstead. Assumes external ZooKeeper is already online.)