Skip to Content

Your first project

A cluster, a project and one app, as three YAML files.

Three files describe a cluster with one general-purpose pool, a project on it and a web app in that project.

The cluster

The file name is the cluster's name. A cluster needs a control-plane pool and at least one pool for apps.

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

The project

A project groups apps and names the cluster they run on.

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

The app

The app runs on the general pool and listens on port 8080.

projects/web/apps/site.yaml
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
pool: general
port: 8080

See the app file reference for every field.

Try it

Change the app file and see what the schema says, as an editor with the modeline would. Pick another file kind to try the cluster or project file.

projects/web/apps/api.yaml

Checking the file against the schema needs JavaScript.

On this page