# Azure

## Introduction

You can find the AMESA Training Cluster Azure application [here](https://portal.azure.com/#view/Microsoft_Azure_Marketplace/GalleryItemDetailsBladeNopdl/id/composabl1715952518637.composabl-cluster-v1)

This will set up a fully functional AMESA Training Cluster on your Azure tenant.

## Prerequisites

1. An active Azure subscription
2. Quota for the supported VM sizes (see later during setup)
3. If using GPU training, you'll need quota for GPU-enabled nodes (such as the [NCasT4\_v3 series](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/gpu-accelerated/ncast4v3-series?tabs=sizebasic))

## Overview

Setting up your cluster consists of the following steps:

1. Registering a new cluster in AMESA
2. Running through the wizard in Azure

## Registering a new cluster in AMESA

1. Head to [AMESA](https://app.composabl.com) and navigate to the clusters page.
2. Choose "Create Cluster"
3. Select "Azure Cluster"

<figure><img src="/files/QnVbuIF7nAXAFkwBDVqJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UCdLEL0hrnwNK6UgGjce" alt=""><figcaption></figcaption></figure>

4. Take note of the Cluster ID and License key - you'll need them during the setup wizard on Azure, then click "Create on Azure"

## Creating your cluster on Azure

1. Visit the Microsoft Azure Marketplace page [here](https://portal.azure.com/#view/Microsoft_Azure_Marketplace/GalleryItemDetailsBladeNopdl/id/composabl1715952518637.composabl-cluster-v1)
2. Click "Create" to start the setup wizard

<figure><img src="/files/dg6VcOHkSWynKqZfjw0k" alt=""><figcaption></figcaption></figure>

1. On the first step, select a resource group to create the cluster in. We recommend you use a new Resource Group made specifically for this purpose. Give the resource a descriptive name.

<figure><img src="/files/LkA9GdbzXCNZ5fEPCcIr" alt=""><figcaption></figcaption></figure>

2. On the second step, fill in the following:

<figure><img src="/files/lJW2MMy8EtM9BPoWtTNG" alt=""><figcaption></figcaption></figure>

* Cluster name - this is a technical name and should be unique for all AKS clusters in your Azure subscription
* Kubernetes version - select the latest version, unless a policy prevents you from doing so. Only supported versions are listed.
* Container registry name - this is the name of the container registry you'll be pushing your simulator images to. As with the Cluster name, this name has to be unique for all Azure Container Registries in your Azure subscription.
* GPU Training - Check this if you want to use GPUs to accelerate training.
* Various VM sizes - See [VM sizing and types](#VM-sizing-and-types) for additional information on each of these
* Scaling settings - Whether to enable autoscaling, and limits for the autoscaling, if enabled. Note that we recommend you leave autoscaling enabled, as this can significantly reduce costs.

3. On the final step, fill in the Cluster ID and License key you received during your [Cluster Registration](#registering-a-new-cluster-in-amesa)

<figure><img src="/files/vhBHaNY5qlVMwt5iXenE" alt=""><figcaption></figcaption></figure>

* The advanced settings should not be used unless you require specific features to be enabled for testing or support purposes.

Finally, click "Review + Create" to review the settings and create your training cluster.

## VM sizing and types

A AMESA cluster consists of up to 6 different node types:

1. Main nodes - these are Kubernetes system nodes, used for running the Kubernetes master processes
2. AMESA nodes - these nodes run the AMESA software - e.g. the AMESA Controller and the Historian processor
3. Environment runner nodes - The AMESA SDK will manage the simulator instances from these nodes. If GPU training is disabled, the training process will run on these nodes as well.
4. Simulator nodes: These nodes are where the simulator(s) will be running

If you have enabled GPU training and/or GPU simulators, you will have the following: 5. (GPU Training enabled) Learner nodes - these GPU-enabled nodes will perform the actual training on GPU, after samples are collected from the simulators 6. (GPU Training + GPU Sims enabled) - these nodes will run GPU-enabled simulators.

For most cases, we recommend leaving the default sizing. If no quota is available in these for you, you have the option to change to a similar node size for any of these.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.amesa.com/clusters/creating-a-cluster/azure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.