> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Cluster file

> One cluster of an infra link.

Schema definition: `ClusterFile`.

## Example

A minimal `clusters/<name>.yaml`:

```yaml title="clusters/hetzner-fsn1.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
provider: hetzner
region: fsn1
pools:
  - name: control-plane
    role: control_plane
  - name: general
```

## Fields

### `auto_update`

Type: `string`, optional.

`off`, `patch` or `patch_minor`.

### `environment`

Type: `string`, optional.

The environment the cluster serves.

### `load_balancers`

Type: list of [`InfraLoadBalancerSpec`](/iac/reference/types#infraloadbalancerspec), optional.

A load balancer of the cluster.

### `maintenance_window`

Type: [`MaintenanceWindowSpec`](/iac/reference/types#maintenancewindowspec), optional.

The cluster's maintenance window.

### `name`

Type: `string`, optional.

Optional: must match the file name when set.

### `network`

Type: [`ClusterNetworkSpec`](/iac/reference/types#clusternetworkspec), optional.

The `network` key: the cluster's address ranges, fixed at create.

### `pools`

Type: list of [`InfraPoolSpec`](/iac/reference/types#infrapoolspec), optional.

A node pool of the cluster.

### `provider`

Type: `string`, optional.

The `provider` key.

### `region`

Type: `string`, optional.

The `region` key.

### `version`

Type: [`SchemaVersion`](/iac/reference/types#schemaversion), required.

The IaC schema version this file is written for.
