# What is it?

The Azure AKS Template is a pre-built system template designed for managing Azure Kubernetes Service (AKS) lifecycle management, covering both day-0 and day-2 operations. This template is part of the [Template Catalog](https://docs.rafay.co/template_catalog/introduction/) under the Kubernetes Lifecycle Management section and enables organizations to create self-service workflows for end users without requiring extensive configuration knowledge.

This template provides comprehensive AKS management capabilities and is fully supported with regular updates and new features added over time. With these templates, administrators can follow two simple steps to provide a self-service experience for their end users:

1. **Configure and customize** the system template (provide credentials, specify defaults, and determine what values end users can/cannot override) in a project owned by the Platform team
2. **Publish** by sharing the template with end user projects

## Prerequisites

Before consuming the Azure AKS Template, ensure you have the following prerequisites in place:

### 1. Healthy GitOps Agent

- Deploy a healthy GitOps agent that drives the workflow
- The agent can be deployed as:
  - Docker container
  - Kubernetes deployment
- The agent's network must have reachability to the network where AKS clusters will be created
- Refer to the [GitOps Agent setup documentation](https://docs.rafay.co/gitops/gitops_agent/) for detailed configuration

### 2. Valid Rafay API Key

- Obtain a valid Rafay API key for authentication
- The API key should have appropriate permissions for AKS template operations
- Refer to the [API Key management documentation](https://docs.rafay.co/security/rbac/users/#manage-keys) for setup instructions

### 3. Azure Service Principal Credentials

- Configure valid Azure Service Principal credentials with permissions for:
  - Authentication
  - AKS lifecycle management operations
- Alternative: You can use User Managed Identity for resources in the cluster configuration
- Refer to the [AKS credentials documentation](https://docs.rafay.co/clusters/aks/credentials/) for detailed setup instructions

## Configuration

The AKS System Template includes the following configuration sections:

### 1. Agent Configuration

- **GitOps Agent** or **Agent Pools** can be configured at the template level or added at runtime during environment deployment
- Drives workflow execution.

### 2. Backend Store Type Configuration

- **State Store** configuration for managing infrastructure state
- Supports System (Rafay-managed), S3, or TFC (Terraform Cloud) backend stores
- Set to empty by default - use System store for quick deployment

### 3. Rafay-Specific Configuration

- **Blueprint** specification for the cluster configuration
- **Project name** where the AKS cluster will be created
- Defines the Rafay platform configuration

### 4. Azure AKS Configuration

- **Azure-specific settings** for AKS cluster creation and management
- Includes region, node pools, networking, and other AKS-specific parameters

### 5. Credentials

- **Rafay API Key** for platform authentication
- **Azure Credentials** (Service Principal or User Managed Identity)
- Can be configured at the template level or applied at runtime during environment deployment

## Workflow Overview

The Azure AKS Template follows a centralized configuration model where platform administrators first configure and customize the template in a central project, then share it with end-user projects for consumption.

### Step-by-Step Guide

WARNING

This guide provides general guidance and example configurations only. It may not meet your specific environment requirements or cover all possible configurations. Tailor this configuration to your needs.

### Step 1: Locate and Initialize the Azure AKS Template

1. Navigate to the **Template Catalog** from the home page
2. Under **Kubernetes Lifecycle Management**, locate the **Azure AKS** card
3. Click the **Get Started** button
4. Provide the following details:
5. **Template name** for your organization
6. **Version** identifier
7. **Central project** where you'll configure the template before sharing

### Step 2: Configure the Template

Once the Azure AKS template is shared to your central project, configure the essential components:

#### 2.1 Add GitOps Agent

- Configure the GitOps agent at the template level
- This agent will drive the workflow execution for the deployment.

#### 2.2 Configure Backend Store Type

1. **System** (Recommended for quick deployment)
   - State is managed and stored in Rafay's state store
   - No need to bring your own state store
   - Ideal for getting started quickly without external infrastructure
2. **S3**
   - Use Amazon S3 as the state store
   - Provide access credentials (Access ID and Secret) to interact with the S3 endpoint
3. **TFC (Terraform Cloud)**
   - Use Terraform Cloud (TFC) as the state store
   - Provide TFC-related configuration including organization, workspace, and authentication details

#### 2.3 Setup Configuration Context

- Configure the `aks-rafay-env-vars` context with:
  - **Azure credentials** (Service Principal or User Managed Identity)
  - **Rafay API key** for authentication
- **Lock the credentials** to prevent end users from modifying them

### Step 3: Customize Input Variables

Platform administrators can customize which variables to expose to end users:

#### 3.1 Set Default Values

- **Blueprint name and version** for cluster configuration
- **Region** for AKS cluster deployment
- **Kubernetes version** for the cluster
- **Cluster tags** for resource organization

#### 3.2 Restrict User Inputs

- **Location restrictions** (e.g., only allow specific Azure regions)
- **Blueprint restrictions** (e.g., only allow approved blueprints)

### Step 5: Share with End User Projects

Once configuration is complete, save it as an active version and share the template with end-user projects:
1. Navigate to the template sharing settings
2. Select target end-user projects
3. Publish the template for consumption

### Step 6: Enable Approval Hooks (Optional)

When you share the template with a central project, **approval hooks are disabled by default**. If you want to review the plan before applying infrastructure changes, you can enable approval hooks.

## Configuration Flexibility

This workflow provides flexibility for different organizational needs:

- **Fully Managed**: Platform admin configures all settings, end users simply deploy
- **Hybrid Approach**: Some settings pre-configured, others left for end users
- **User-Driven**: Minimal pre-configuration, maximum end-user control

The recommended approach is the fully managed configuration, which reduces the burden on end users while maintaining security and compliance standards.

## End User Flow

Once the platform administrator shares the Azure AKS template to end-user projects, end users can easily deploy AKS clusters with minimal configuration effort.

### Step 1: Access the Shared Template

1. Navigate to your project where the Azure AKS template has been shared
2. Locate the **Azure AKS Template** in your available templates
3. Click **Launch** to begin the deployment process

### Step 2: Configure Template Inputs

Based on the configuration exposed by the platform administrator, provide the necessary inputs:

#### 2.1 Required Configuration

- **Cluster name** for your AKS deployment
- **Resource group** (if not pre-configured)
- **Region** (if multiple regions are allowed)
- **Node pool configuration** (if customizable)

### Step 5: Access Cluster Resources

Once the deployment status shows **Success**, you will receive the following output configuration:

#### 5.1 Cluster Access Information

- **Kubeconfig** file for cluster access

#### 5.2 Resource Information

- **Resource group** where cluster was created
- **Node pool details** and status

Post-Deployment Information

Once the deployment is finished and shows success, the cluster will be visible under the **Infrastructure** tab for monitoring and dashboard purposes. All day-2 operations are supported using template edit functionality - you can change values and redeploy as needed.

### Step 6: Verify Cluster Access

After successful deployment, download the [ZTKA](https://docs.rafay.co/accessproxy/architecture/) KUBECONFIG from **Infrastructure > Clusters** to interact with the cluster. You can now deploy workloads on this successfully provisioned cluster.

## Benefits for End Users

- **Simplified Deployment**: Pre-configured templates reduce complexity
- **Consistent Configuration**: Standardized settings across all deployments
- **Security**: Credentials managed by platform administrators
- **Compliance**: Built-in governance and policy enforcement
- **Self-Service**: Deploy clusters without waiting for platform team assistance