Skip to content

The build reef

Every command that builds an image from a Workload's source inside the cluster.

Commands

Examples

build-create

Two Jobs in the namespace builds: fetch, then build and push.

nereus build create hello-1 \
  --workload hello
output
build/builds/hello-1 created (mandate: buildkit, nereid: buildkit)

Next steps:

  nereus build get hello-1

build-get

Its phase, image and digest.

nereus build get hello-1
output
Name:      hello-1
Workload:  hello
Commit:    a1b2c3d4e5f60718293a4b5c6d7e8f9012345678
Owner:     -
Mandate:   -
Nereid:    buildkit
Phase:     Succeeded
Image:     localhost:31874/hello:hello-1
Digest:    sha256:3517762d3517762d3517762d3517762d3517762d3517762d3517762d3517762d
Job:       hello-1

build-list

The Workload, the commit, the phase and the digest.

nereus build list
output
BUILD    WORKLOAD  COMMIT   STATUS     DIGEST
hello-1  hello     a1b2c3d  Succeeded  sha256:3517762d3517
hello-2  hello     -        Pending    -

build-private

An allow line for builds on the App's Mandate, then the Build.

nereus build get app-1
output
Name:      app-1
Workload:  app
Phase:     Running
Message:   source fetched at a1b2c3d from https://github.com/example/app with a token for example/app (contents=read)

build-delete

The image it pushed stays in its Repository.

nereus build delete hello-1
output
build/builds/hello-1 deleted

Next steps:

  nereus build list

trigger-create

The Mirror nereus copies the source of the Workload triton.

nereus build trigger create triton \
  --workload triton
output
build/triggers/triton created (mandate: buildkit, nereid: buildkit)

Next steps:

  nereus build trigger get triton

trigger-list

After a push, once the Mirror pulled it.

nereus build trigger list
output
TRIGGER  WORKLOAD  MIRROR  COMMIT   LAST BUILD      STATUS
triton   triton    nereus  a1b2c3d  triton-a1b2c3d  Ready

trigger-get

Its Mirror, branch, commit and last Build.

nereus build trigger get triton
output
Name:        triton
Workload:    triton
Owner:       Project/triton
Mandate:     -
Nereid:      buildkit
Mirror:      nereus
Branch:      main
Commit:      a1b2c3d4e5f60718293a4b5c6d7e8f9012345678
Last Build:  triton-a1b2c3d
Status:      Ready

trigger-delete

No new Build of triton; triton-a1b2c3d stays.

nereus build trigger delete triton
output
build/triggers/triton deleted; the Builds it created stay

Next steps:

  nereus build trigger list