Skip to main content

clouder criu

CRIU checkpoint operations, visibility, and storage configuration helpers.

Runtime checkpoint lifecycle commands (checkpoint, restore, ls, inspect, delete) call the runtimes API.

Set these environment variables (or pass --run-url / --api-key):

export DATALAYER_RUN_URL=https://prod1.datalayer.run
export DATALAYER_API_KEY=<your-api-key>

Tab completion notes:

  • --cluster suggestions come from ~/.clouder/kubeadm/*/kubeadm.json
  • --key suggestions come from local private keys in ~/.ssh/

Commands

clouder criu checkpoint

Create a checkpoint for a runtime pod.

clouder criu checkpoint my-runtime --checkpoint-mode criu
OptionShortDescription
--checkpoint-modecriu or light
--agent-spec-idOptional agent spec id
--nameOptional checkpoint display name
--descriptionOptional checkpoint description
--run-urlDatalayer run URL
--api-keyDatalayer API key

clouder criu restore

Restore a runtime from a checkpoint.

# Restore latest paused checkpoint for runtime
clouder criu restore my-runtime

# Restore a specific checkpoint
clouder criu restore my-runtime --checkpoint-id 01J...
OptionShortDescription
--checkpoint-idSpecific checkpoint ID (optional)
--run-urlDatalayer run URL
--api-keyDatalayer API key

clouder criu ls

List checkpoints.

# All checkpoints for current user
clouder criu ls

# Filter by runtime
clouder criu ls --runtime my-runtime
OptionShortDescription
--runtimeFilter by runtime pod name
--run-urlDatalayer run URL
--api-keyDatalayer API key

clouder criu inspect

Inspect one checkpoint record.

clouder criu inspect my-runtime 01J...

clouder criu delete

Delete one checkpoint record.

clouder criu delete my-runtime 01J...

clouder criu status

Show CRIU readiness on all nodes of a deployment:

  • CRIU version
  • criu check status
  • containerd version
  • kubelet ContainerCheckpoint feature gate state
clouder criu status --cluster my-cluster
OptionShortDescription
--clusterKubeadm deployment name (defaults to current kube context)
--cloudTarget cloud provider (azure or aws)
--admin-user-uSSH username used to inspect nodes
--key-iSSH key name from ~/.ssh/

clouder criu checkpoints

List checkpoint archives currently present under /var/lib/kubelet/checkpoints on each node.

clouder criu checkpoints --cluster my-cluster
OptionShortDescription
--clusterKubeadm deployment name (defaults to current kube context)
--cloudTarget cloud provider (azure or aws)
--admin-user-uSSH username used to inspect nodes
--key-iSSH key name from ~/.ssh/

clouder criu storage

Show the default checkpoint storage configured in deployment metadata.

clouder criu storage --cluster my-cluster
OptionShortDescription
--clusterKubeadm deployment name (defaults to current kube context)
--cloudTarget cloud provider (azure or aws)

clouder criu storage-set

Persist a default checkpoint storage URI in deployment metadata.

clouder criu storage-set --cluster my-cluster --storage s3://my-bucket/checkpoints/
OptionShortDescription
--clusterKubeadm deployment name (defaults to current kube context)
--storageStorage URI (for example s3://bucket/checkpoints/)