/AKS-Landing-Zone-Accelerator

Official repository for the AKS Landing Zone Accelerator program

Primary LanguageHCLMIT LicenseMIT

AKS Landing Zone Accelerator

Azure Landing Zone Accelerators are an architectural approach and a reference implementation that enables effective construction and operationalization of landing zones on Azure, at scale. This approach aligns with the Azure roadmap and the Cloud Adoption Framework for Azure.

AKS Landing Zone Accelerator represents the strategic design path and target technical state for an Azure Kubernetes Service (AKS) deployment. This solution provides an architectural approach and reference implementation to prepare landing zone subscriptions for a scalable Azure Kubernetes Service (AKS) cluster. For the architectural guidance, check out AKS Landing Zone Accelerator in Microsoft Docs.

Below is a picture of what a golden state looks like and open source software like flux and traefik integrate well within the AKS ecosystem.

Golden state platform foundation with AKS landingzone highlighted in red

The AKS Landing Zone Accelerator is only concerned with what gets deployed in the landing zone subscription highlighted by the red box in the picture above. It is assumed that an appropriate platform foundation is already setup which may or may not be the official ESLZ platform foundation. This means that policies and governance should already be in place or should be setup after this implementation and are not a part of the scope this reference implementaion. The policies applied to management groups in the hierarchy above the subscription will trickle down to the AKS Landing Zone Accelerator landing zone subscription.


Choosing a Deployment Model

The reference implementation is provided by two repos that all build on top of the AKS Secure Baseline.

  1. This one
  2. The Bicep AKS Accelerator

This repo

In this repo, you get access to step by step guide covering various customer scenarios that can help accelerate the development and deployment of AKS clusters that conform with AKS Landing Zone Accelerator best practices and guidelines. This is a good starting point if you are new to AKS or IaC. Each scenario aims to represent common customer experiences with the goal of accelerating the process of developing and deploying conforming AKS clusters using Infrastructure-As-Code (IaC). They also provide a step by step learning experience for deploying AKS in an actual Enterprise environment. Most scenarios will eventually have a Terraform and Bicep version.

Use this repo is you would like step by step guidance on how to deploy secure and well architected AKS clusters using our scenario based model and/or you are new to AKS or IaC. This model promotes a separation of duties, modularized IaC so you can pick and choose components you want to build with your cluster and has implementations in ARM, Terraform and Bicep. It is the best starting point for customers new to Azure or AKS.

Bicep AKS Accelerator

A flexible templating approach using Bicep that enables multiple scenarios using a Web based tool. It provides tangible artifacts to quickly enable AKS deployments through CLI or in your CI/CD pipeline.

Driving the configuration experience is a wizard to guide your decision making, it provides presets for the main Azure Landing Zone deployment modes (Sandbox, Corp & Online). The output of this wizard experience are the parameters and CLI commands to immediately deploy using our maintained Bicep template to deploy your customized AKS environment in one step. Pipeline examples are provided that show best practices for your AKS Infrastructure as Code deployments.

Use this repo if you would like to use a guided experience to rapidly create your environment with a maintained Bicep template based on the architecture of the AKS Secure Baseline.

Steps of Implementation for AKS Landing Zone Accelerator

A deployment of AKS-hosted workloads typically requires a separation of duties and lifecycle management in different areas, such as prerequisites, the host network, the cluster infrastructure, the shared services and finally the workload itself. This reference implementation is no different. Also, be aware that our primary purpose is to illustrate the topology and decisions involved in the deployment of an AKS cluster. We feel a "step-by-step" flow will help you learn the pieces of the solution and will give you insight into the relationship between them. Ultimately, lifecycle/SDLC management of your cluster and its dependencies will depend on your situation (organizational structures, standards, processes and tools), and will be implemented as appropriate for your needs.

AKS Backup & Restore

This repo provides An accelerator (Terraform module) to deploy and use Open source tool Velero, for Backup & Restore of AKS stateful applications.

Coming Soon! Perform Backup for Persistent Volume of AKS clusters using Azure Backup

Next steps

Follow a scenario driven tutorial within this repo

Pick one of the scenarios below to get started on a reference implementation

▶️ AKS Secure Baseline

▶️ AKS Secure Baseline in a Private Cluster

▶️ Azure Policy initiative for AKS Landing Zone Accelerator (Brownfield scenario)

▶️ Backup Restore using Open source tool Velero

Leverage one of the Landing Zone Accelerator implementations from our other repos

▶️ Bicep AKS Accelerator