AKS Engine - Units of Kubernetes on Azure!

Project status

This project is deprecated for Azure public cloud customers. Please consider using Azure Kubernetes Service (AKS) for managed Kubernetes or Cluster API Provider Azure for self-managed Kubernetes. There are no new features planned; this project will only be updated for CVEs & similar, with Kubernetes 1.24 as the final version to receive updates.

For use on the Azure Stack Hub product this project is fully supported and will continue to be supported by the Hub team throughout the lifespan of Azure Stack Hub. Development is already moved to a new Azure Stack Hub specific repository (Azure/aks-engine-azurestack). This new repository is where new releases for Azure Stack Hub clouds, starting at v0.75.3, will be published and where issues concerning Azure Stack Hub should be created.

Overview

AKS Engine is an ARM template-driven way to provision a self-managed Kubernetes cluster on Azure. By leveraging ARM (Azure Resource Manager), AKS Engine helps you create, destroy and maintain clusters provisioned with basic IaaS resources in Azure. AKS Engine has limited support for ongoing operational capabilities such as scaling, in-place upgrade, and extensions. The Cluster API Provider for Azure a.k.a. CAPZ provides more complete operational capabilities. AKS Engine remains the tool for managing Kubernetes clusters on Azure Stack Hub as CAPZ does not yet work there.

Getting started

• Read the CLI Overview for a list of features provided by the aks-engine command line tool.

• The Quickstart Guide describes how to download the latest release of aks-engine for your environment, and demonstrates how to use aks-engine to create a Kubernetes cluster on Azure that you will manage and customize.

• The complete body of documentation can be found here.

Please see the FAQ for answers about AKS Engine and its progenitor ACS-Engine.

Join the community

We encourage AKS Engine users to evaluate moving to AKS or to CAPZ, per the project status.

For existing users of AKS Engine, the community guide and developer guide are available, as is the #aks-engine-dev Slack channel.

Support

Please see our support policy.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information, see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Data Collection

The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.

For more information, please see the telemetry documentation.