Skip to main content

Statefile

Statefile are a way to describe the state you want for a specific namespace.

It use yaml form we can sumerize the deployment of our cargo as follow :

ApiVersion: v0.18

Namespace: global

# See all options:
# https://docs.next-hat.com/references/nanocl/objects/cargo
Cargoes:
- Name: my-cargo
Containers:
- Name: web
Image: ghcr.io/next-hat/nanocl-get-started:latest

# See all options:
# https://docs.next-hat.com/references/nanocl/objects/resource
Resources:
- Name: deploy-example.com
Kind: ncproxy.io/rule/v0.15
Data:
Rules:
- Domain: deploy-example.com
Network: All
Locations:
- Path: /
Target:
Key: global.my-cargo.c
Port: 9000

Save this file under my-cargo.yml and apply it using:

nanocl state apply -s ./my-cargo.yml

And test with a simple curl:

curl --header "Host: deploy-example.com" 127.0.0.1

And voila.