Skip to Content

Cluster file

One cluster of an infra link.

Schema definition: ClusterFile.

Example

A minimal clusters/<name>.yaml:

clusters/hetzner-fsn1.yaml
# 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, optional.

A load balancer of the cluster.

maintenance_window

Type: MaintenanceWindowSpec, optional.

The cluster's maintenance window.

name

Type: string, optional.

Optional: must match the file name when set.

network

Type: ClusterNetworkSpec, optional.

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

pools

Type: list of 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, required.

The IaC schema version this file is written for.

On this page