The environment reef

Every command of the environment reef: an environment per agent, made by a Nereid, gone at its expiry

O reef environment

Todos os comandos do reef environment: um ambiente por agente, feito por uma Nereid, apagado quando expira

Opening · kind

One kind, only the request: who it is for, where, and for how long

  • spec: owner (an Organization or a Project), region, expires (30m, 4h, 3d) and mandate, never a technology
  • status: written by its Nereid: phase, expiresAt, kubernetes.context and the Secret of its kubeconfig
Abertura · kind

Um kind, só o pedido: para quem, onde, e por quanto tempo

  • spec: owner (uma Organization ou um Project), region, expires (30m, 4h, 3d) e mandate, nunca uma tecnologia
  • status: escrito pela sua Nereid: phase, expiresAt, kubernetes.context e o Secret do seu kubeconfig
Setup

What comes before the first environment?

Preparação

O que vem antes do primeiro ambiente?

Setup · reef applybuilt

The environment reef, the vcluster Nereid and its default Mandate

Preparação · reef applypronto

O reef environment, a Nereid vcluster e o seu Mandate padrão

~/example
# The vcluster Nereid requires the release reef: it asks it for the vcluster chart$ nereus reef apply environment✓ core/reefs/environment 0.1.0 created (environment.getnereus.dev/v1alpha1: environments) Next steps:   nereus environment --help  nereus nereid apply <nereid> --reef environment # Its default Mandate comes with it: Environments go through it unless they name another$ nereus nereid apply vcluster✓ core/nereids/vcluster created, Ready, pinned to sha256:b5570d781f5a: see 'nereus environment --help'  core/mandates/vcluster created (reef: environment, nereid: vcluster, default) Next steps:   nereus environment create <name> --owner project/<name> --expires 4h
Environment

How does an agent get an environment of its own, and give it back?

Environment

Como um agente ganha um ambiente só seu, e o devolve?

Environment · createbuilt

An environment of its own, for an hour

Environment · createpronto

Um ambiente só seu, por uma hora

~/example
# Who it is for, and for how long$ nereus environment create a \    --owner project/nereus \    --expires 1h✓ environment/environments/a created (mandate: vcluster, nereid: vcluster) Next steps:   nereus environment get a --watch  nereus environment kubeconfig a
Environment · --param sizebuilt

A bigger environment, for Nereus itself

Environment · --param sizepronto

Um ambiente maior, para o próprio Nereus

~/example
# A Mandate whose Environments are of size platform$ nereus mandate create heavy \    --reef environment \    --nereid vcluster \    --param size=platform✓ core/mandates/heavy created (reef: environment, nereid: vcluster) Next steps:   nereus mandate list # An environment through it$ nereus environment create spike \    --owner project/nereus \    --mandate heavy \    --expires 4h✓ environment/environments/spike created (mandate: heavy, nereid: vcluster) Next steps:   nereus environment get spike --watch  nereus environment kubeconfig spike # Its size, beside its state$ nereus environment listENVIRONMENT  OWNER           NEREID    STATUS  SIZE      EXPIRESspike        Project/nereus  vcluster  Ready   platform  3h58m
Environment · listbuilt

Two agents, two environments, and the time each one has left

Environment · listpronto

Dois agentes, dois ambientes, e o tempo que resta a cada um

~/example
# Its Nereid, its state, and when it goes$ nereus environment listENVIRONMENT  OWNER           NEREID    STATUS  SIZE   EXPIRESa            Project/nereus  vcluster  Ready   small  58mb            Project/nereus  vcluster  Ready   small  58m
Environment · kubeconfigbuilt

Its kubeconfig, read with your own credentials

Environment · kubeconfigpronto

O seu kubeconfig, lido com as suas próprias credenciais

~/example
# From the Secret its Nereid named in the status$ nereus environment kubeconfig a > a.kubeconfig # The vcluster's API server, through a port-forward for now$ kubectl port-forward service/env-a 8443:443 & \    --namespace env-vcluster-a $ kubectl get namespaces \    --kubeconfig a.kubeconfigNAME              STATUS   AGEdefault           Active   42skube-node-lease   Active   42skube-public       Active   42skube-system       Active   42s
Environment · deletebuilt

Deleting it removes the vcluster, then its namespace

Environment · deletepronto

Apagá-lo remove o vcluster, depois o seu namespace

~/example
# Waits until its Nereid removed what it made$ nereus environment delete a2026-10-30T19:40:35Z  … release    Deleting release/releases/env-a: Flux uninstalls the vcluster chart.2026-10-30T19:40:36Z  · namespace  Deleting the namespace env-vcluster-a.2026-10-30T19:40:56Z  ✓ release    release/releases/env-a deleted.2026-10-30T19:40:56Z  … namespace  Deleting the namespace env-vcluster-a.✓ environment/environments/a deleted Next steps:   nereus environment list
Environment · --expiresbuilt

At its expiry, its Nereid removes it by itself

Environment · --expirespronto

Quando expira, a sua Nereid o remove sozinha

~/example
# An environment for one minute$ nereus environment create c \    --owner project/nereus \    --expires 1m✓ environment/environments/c created (mandate: vcluster, nereid: vcluster) Next steps:   nereus environment get c --watch  nereus environment kubeconfig c # A minute later$ nereus environment listENVIRONMENT  OWNER           NEREID    STATUS   SIZE   EXPIRESb            Project/nereus  vcluster  Ready    small  55mc            Project/nereus  vcluster  Expired  small  -
Environment · naxosbuilt #575

The kept cluster is the environment naxos, made through its own Mandate

Environment · naxospronto #575

O cluster mantido é o ambiente naxos, feito pelo seu próprio Mandate

~/example
# The CLI's first setup registers the kept k3d cluster; vcluster stays the default$ nereus environment create naxos \    --owner project/nereus \    --mandate local✓ environment/environments/naxos created (mandate: local, nereid: k3d) Next steps:   nereus environment get naxos --watch $ nereus environment listENVIRONMENT  OWNER           NEREID    STATUS  SIZE   EXPIRESnaxos        Project/nereus  k3d       Ready   -      -pr-123       Project/nereus  vcluster  Ready   small  2d