The build reef¶
Every command that builds an image from a Workload's source inside the cluster.
Commands¶
nereus build create hello-1
create builds a Workload at the commit its Nereid readnereus build get hello-1
get shows the digest the registry answerednereus build list
list shows every build, a line eachnereus build get app-1
A private repository is fetched with a token for that build alonenereus build delete hello-1
delete removes the Build and its Job, never the imagenereus build trigger create triton
trigger create builds a Workload on each new commit of its Mirrornereus build trigger list
trigger list shows the commit each one saw and its last Buildnereus build trigger get triton
trigger get shows the Mirror it follows and the commit it sawnereus build trigger delete triton
trigger delete stops new Builds and leaves the ones it made
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