Azure Container Service Engine (acs-engine) - Swarm Mode

Last updated: 4/14/2017

The Azure Container Service Engine (acs-engine) generates ARM (Azure Resource Manager) templates for Docker enabled clusters on Microsoft Azure with your choice of DC/OS, Kubernetes, Swarm Mode, or Swarm orchestrators. The input to the tool is a cluster definition. The cluster definition is very similar to (in many cases the same as) the ARM template syntax used to deploy a Microsoft Azure Container Service cluster.

This Azure Resource Manager template was created by a member of the community and not by Microsoft. Each Resource Manager template is licensed to you under a license agreement by its owner, not Microsoft. Microsoft is not responsible for Resource Manager templates provided and licensed by community members and does not screen for security, compatibility, or performance. Community Resource Manager templates are not supported under any Microsoft support program or service, and are made available AS IS without warranty of any kind.

Parameters

Parameter Name Description
agentCount The number of agents for the cluster. This value can be from 1 to 100
agentEndpointDNSNamePrefix Sets the Domain name label for the agent pool IP Address. The concatenation of the domain name label and the regional DNS zone make up the fully qualified domain name associated with the public IP address.
agentSubnet Sets the subnet of agent pool 'agent'.
agentVMSize The size of the Virtual Machine.
firstConsecutiveStaticIP Sets the static IP of the first master
linuxAdminUsername User name for the Linux Virtual Machines (SSH or Password).
location Sets the location for all resources in the cluster
masterEndpointDNSNamePrefix Sets the Domain name label for the master IP Address. The concatenation of the domain name label and the regional DNS zone make up the fully qualified domain name associated with the public IP address.
masterSubnet Sets the subnet of the master node(s).
masterVMSize The size of the Virtual Machine.
nameSuffix A string hash of the master DNS name to uniquely identify the cluster.
sshRSAPublicKey SSH public key used for auth to all Linux machines. Not Required. If not set, you must provide a password key.
targetEnvironment The azure deploy environment. Currently support: AzureCloud, AzureChinaCloud

Use the template

PowerShell

New-AzureRmResourceGroupDeployment -Name <deployment-name> -ResourceGroupName <resource-group-name> -TemplateUri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/101-acsengine-swarmmode/azuredeploy.json
Install and configure Azure PowerShell

Command line

azure config mode arm
azure group deployment create <my-resource-group> <my-deployment-name> --template-uri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/101-acsengine-swarmmode/azuredeploy.json
Install and Configure the Azure Cross-Platform Command-Line Interface