Skip to Content

Project file

A project (Kubernetes namespace) with its applications.

Schema definition: ProjectFile.

Example

A minimal projects/<project>/project.yaml, with the file it refers to first:

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
projects/web/project.yaml
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
name: web
cluster: hetzner-fsn1

Fields

apps

Type: list of AppSpec, optional, default [].

Applications in this project.

buckets

Type: list of BucketSpec, optional.

Managed buckets this project's link manages. Leaving the key out leaves every bucket as it is; a present list is authoritative for the buckets the link owns (an entry removed from it stops being managed).

cluster

Type: string, optional.

The cluster the project runs on (a clusters/<name>.yaml stem or a cluster the tenant already has). Required on create when clusters are known; fixed while the project has apps.

display_name

Type: string, optional.

Human-readable display name.

egress

Type: EgressSpec, optional.

Outbound mode and allowlist. Leaving the key out leaves the stored settings alone; a present mapping replaces them (no mode means public).

isolated

Type: boolean, optional.

Whether the project's apps are isolated from each other. Leaving the key out leaves the project as it is; a value switches it. Exported only when true.

name

Type: string, required.

Project name (becomes the k8s namespace).

network_policies

Type: list of NetworkPolicySpec, optional.

Network policies: connections from this project to other projects of the cluster. Leaving the key out leaves the stored connections alone; [] removes them all.

quotas

Type: QuotaSettings, optional.

The project's quota limits. Leaving the key out leaves the stored limits alone; {} removes them all.

storages

Type: list of StorageSpec, optional.

External storage connections this project's link manages (same rules as buckets).

version

Type: SchemaVersion, required.

The IaC schema version this file is written for.

On this page