website/content/en/docs/setup/turnkey/azure.md

---
reviewers:
- colemickens
- brendandburns
title: Running Kubernetes on Azure
---

## Azure Kubernetes Service (AKS)

The [Azure Kubernetes Service](https://azure.microsoft.com/en-us/services/kubernetes-service/) offers simple
deployments for Kubernetes clusters.

For an example of deploying a Kubernetes cluster onto Azure via the Azure Kubernetes Service:

**[Microsoft Azure Kubernetes Service](https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes)**

## Custom Deployments: AKS-Engine

The core of the Azure Kubernetes Service is **open source** and available on GitHub for the community
to use and contribute to: **[AKS-Engine](https://github.com/Azure/aks-engine)**. The legacy [ACS-Engine](https://github.com/Azure/acs-engine) codebase has been deprecated in favor of AKS-engine.

AKS-Engine is a good choice if you need to make customizations to the deployment beyond what the Azure Kubernetes
Service officially supports. These customizations include deploying into existing virtual networks, utilizing multiple
agent pools, and more. Some community contributions to AKS-Engine may even become features of the Azure Kubernetes Service.

The input to AKS-Engine is an apimodel JSON file describing the Kubernetes cluster. It is similar to the Azure Resource Manager (ARM) template syntax used to deploy a cluster directly with the Azure Kubernetes Service. The resulting output is an ARM template that can be checked into source control and used to deploy Kubernetes clusters to Azure.

You can get started by following the **[AKS-Engine Kubernetes Tutorial](https://github.com/Azure/aks-engine/blob/master/docs/tutorials/README.md)**.

## CoreOS Tectonic for Azure

The CoreOS Tectonic Installer for Azure is **open source** and available on GitHub for the community to use and contribute to: **[Tectonic Installer](https://github.com/coreos/tectonic-installer)**.

Tectonic Installer is a good choice when you need to make cluster customizations as it is built on [Hashicorp's Terraform](https://www.terraform.io/docs/providers/azurerm/) Azure Resource Manager (ARM) provider. This enables users to customize or integrate using familiar Terraform tooling.

You can get started using the [Tectonic Installer for Azure Guide](https://coreos.com/tectonic/docs/latest/install/azure/azure-terraform.html).
azure: document new bring-up 2016-03-14 19:43:35 +00:00			`---`
In getting-started-guides, in front matter, change approvers to reviewers. (#7447) 2018-02-20 22:18:39 +00:00			`reviewers:`
Adding OWNERS for docs. 2016-07-29 17:36:25 +00:00			`- colemickens`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00			`- brendandburns`
add explicit titles to docs 2016-12-15 20:16:54 +00:00			`title: Running Kubernetes on Azure`
azure: document new bring-up 2016-03-14 19:43:35 +00:00			`---`

Update naming for Azure Kubernetes Service (#10799) 2018-11-01 22:39:53 +00:00			`## Azure Kubernetes Service (AKS)`
azure: update links, owners, metadata 2016-09-27 00:15:38 +00:00
Fixed typo (#10950) Removed extra parenthesis ')' from linked item. 2018-11-12 01:22:50 +00:00			`The [Azure Kubernetes Service](https://azure.microsoft.com/en-us/services/kubernetes-service/) offers simple`
Update naming for Azure Kubernetes Service (#10799) 2018-11-01 22:39:53 +00:00			`deployments for Kubernetes clusters.`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
Update naming for Azure Kubernetes Service (#10799) 2018-11-01 22:39:53 +00:00			`For an example of deploying a Kubernetes cluster onto Azure via the Azure Kubernetes Service:`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
Update naming for Azure Kubernetes Service (#10799) 2018-11-01 22:39:53 +00:00			`[Microsoft Azure Kubernetes Service](https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes)`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`## Custom Deployments: AKS-Engine`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
Update naming for Azure Kubernetes Service (#10799) 2018-11-01 22:39:53 +00:00			`The core of the Azure Kubernetes Service is open source and available on GitHub for the community`
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`to use and contribute to: [AKS-Engine](https://github.com/Azure/aks-engine). The legacy [ACS-Engine](https://github.com/Azure/acs-engine) codebase has been deprecated in favor of AKS-engine.`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`AKS-Engine is a good choice if you need to make customizations to the deployment beyond what the Azure Kubernetes`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00			`Service officially supports. These customizations include deploying into existing virtual networks, utilizing multiple`
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`agent pools, and more. Some community contributions to AKS-Engine may even become features of the Azure Kubernetes Service.`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`The input to AKS-Engine is an apimodel JSON file describing the Kubernetes cluster. It is similar to the Azure Resource Manager (ARM) template syntax used to deploy a cluster directly with the Azure Kubernetes Service. The resulting output is an ARM template that can be checked into source control and used to deploy Kubernetes clusters to Azure.`
azure: update for k8s on acs launch 2016-11-15 00:00:18 +00:00
docs: update acs-engine -> aks-engine (#12804) * docs: update acs-engine -> aks-engine acs-engine has been deprecated by Microsoft in favor of aks-engine * chore: PR feedback * fix missing AKS 2019-02-28 05:04:10 +00:00			`You can get started by following the [AKS-Engine Kubernetes Tutorial](https://github.com/Azure/aks-engine/blob/master/docs/tutorials/README.md).`
docs: add CoreOS Tectonic to Azure getting started (#3307) 2017-04-12 20:58:31 +00:00
			`## CoreOS Tectonic for Azure`

			`The CoreOS Tectonic Installer for Azure is open source and available on GitHub for the community to use and contribute to: [Tectonic Installer](https://github.com/coreos/tectonic-installer).`

			`Tectonic Installer is a good choice when you need to make cluster customizations as it is built on [Hashicorp's Terraform](https://www.terraform.io/docs/providers/azurerm/) Azure Resource Manager (ARM) provider. This enables users to customize or integrate using familiar Terraform tooling.`

			`You can get started using the [Tectonic Installer for Azure Guide](https://coreos.com/tectonic/docs/latest/install/azure/azure-terraform.html).`