🖼️ Image Commands

Manage VM images for GitLab runners.

image list

List all VM images.

$ cicerone image list

NAME              STATUS    BASE              SIZE
─────────────────────────────────────────────────
ubuntu-22.04      ready     ubuntu-22.04      2.1 GB
ubuntu-24.04      building  ubuntu-24.04     -
docker-runner    ready     ubuntu-22.04      3.5 GB

image new

Create a new VM image.

$ cicerone image new my-image \
  --base ubuntu-22.04 \
  --playbook setup.yml

Creating image 'my-image'...
  Base: ubuntu-22.04
  Playbook: setup.yml
  Status: building

image commands

CommandDescription
image listList all VM images
image newCreate a new VM image
image buildBuild an image from definition
image deployDeploy image to a node
image testTest image with runner
image destroyRemove an image