> For the complete documentation index, see [llms.txt](https://docs.duplocloud.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplocloud.com/docs/marketplace-agents/aws-extension/policy-model/cluster-baseline.md).

# Cluster Baseline

Provision a managed Kubernetes cluster (EKS, AKS or OKE) on top of a Network Baseline.

A Cluster Baseline provisions a managed Kubernetes cluster. It is the compute layer that sits on top of a Network Baseline, and it is the parent of all Environments. Each Environment runs inside a Cluster.

The cluster uses the cloud of its Network Baseline, and is placed in that network's subnets:

| Cloud                  | Cluster                                                  |
| ---------------------- | -------------------------------------------------------- |
| **AWS**                | Amazon EKS                                               |
| **Azure**              | Azure Kubernetes Service (AKS)                           |
| **Oracle Cloud (OCI)** | Oracle Kubernetes Engine (OKE), with a default node pool |

## Spec on AWS

{% hint style="info" %}
The fields below are for **AWS**. Azure and Oracle Cloud (OCI) use the same resource with their own fields. Their details are coming soon.
{% endhint %}

| Field                     | Description                                                                                                                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Network Source**        | The Network Baseline to build on top of. The VPC, region, and subnets are inherited automatically. You can also provide a VPC and subnets directly if not using a managed Network Baseline |
| **Cluster Type**          | **Standard** — a standard EKS cluster where you manage node groups. **Auto** — EKS Auto Mode, where AWS manages the compute layer automatically                                            |
| **EKS Version**           | The Kubernetes version to deploy (e.g. `1.31`)                                                                                                                                             |
| **API Server Visibility** | Whether the Kubernetes API endpoint is **Public**, **Private**, or **Public and Private**                                                                                                  |
| **Control Plane Logging** | Which EKS control plane log types to enable: API, Audit, Authenticator, Controller Manager, Scheduler                                                                                      |
| **Cluster IP CIDR**       | The IP range used internally by Kubernetes for service IP assignment (e.g. `172.20.0.0/16`)                                                                                                |

## Result on AWS

Once provisioned, the Cluster Baseline result includes:

| Field                     | Description                                    |
| ------------------------- | ---------------------------------------------- |
| **Cluster ARN**           | The unique ARN of the EKS cluster              |
| **API Endpoint**          | The URL of the Kubernetes API server           |
| **OIDC Issuer URL**       | Used for IAM Roles for Service Accounts (IRSA) |
| **Certificate Authority** | The cluster's certificate authority data       |

{% hint style="success" %}
After provisioning, a Kubernetes Provider and Scope are automatically created for the cluster. The AI agent can immediately begin managing Kubernetes resources inside it without any additional setup.
{% endhint %}

## Dependencies

A Cluster Baseline requires a **Network Baseline** (or, on AWS, an equivalent VPC and subnet configuration). A Cluster cannot be deprovisioned while Environments depend on it.

## What's next

With a Cluster Baseline provisioned, create an [Environment](https://docs.duplocloud.com/docs/marketplace-agents/aws-extension/policy-model/environment.md) as a deployment boundary inside it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplocloud.com/docs/marketplace-agents/aws-extension/policy-model/cluster-baseline.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
