Checkpoint Reference
Complete reference for checkpoint commands. Alias: check
create checkpoint
reel create checkpoint <pod> [container] -n <namespace> [flags]
| Flag | Description | Default |
|---|---|---|
| -n, --namespace | Namespace | default |
| --method | Checkpoint method: k8s-api, containerd, crio | auto |
list checkpoint
reel list checkpoint [checkpoint-id] [flags]
| Flag | Description |
|---|---|
| -n, --namespace | Filter by namespace |
| -A, --all-namespaces | List across all namespaces |
| -o, --output | Output format: table, json, yaml |
export checkpoint
reel export checkpoint <pod> [container] -n <namespace> [flags]
| Flag | Description | Default |
|---|---|---|
| -n, --namespace | Namespace | default |
| --dest | Destination path | auto |
| --method | Checkpoint method: k8s-api, containerd, crio | auto |
| --compress | Compression: none, fast, default, better, best | default |
S3 upload flags available. See S3 Exports.
delete checkpoint
reel delete checkpoint [checkpoint-id] [flags]
| Flag | Description |
|---|---|
| -n, --namespace | Filter by namespace (bulk delete) |
| --all | Delete all checkpoints |
| --filter | Delete matching pattern (glob) |
| --older-than | Delete older than duration (e.g., 7d, 24h) |
| -y, --yes | Skip confirmation prompt |
Methods
| Method | Execution | Use Case |
|---|---|---|
| k8s-api | Kubelet HTTP API | Production (default) |
| containerd | ctr tasks checkpoint | containerd debugging |
| crio | crictl checkpoint | CRI-O clusters |
Scheduling
Automate checkpoints with pod annotations:
annotations:
# reel.io/s3-bucket, reel.io/s3-region, reel.io/s3-secret...
reel.io/schedule: "0 2 * * * | export checkpoint"
See Scheduler Reference for syntax and S3 Exports for bucket configuration.
CRIU Known Limitations
| Issue | Workaround |
|---|---|
| MPTCP sockets | May fail; use layer instead |
| External TCP connections | May not restore correctly |
| GPU workloads | Not supported |
| Large memory (>8GB) | May timeout |