Plugins
Plugins extend the support of checkpoint/restore to various container runtimes, GPUs, etc. Plugins can either be installed from the online registry or built locally.
Online registry
To access released plugins, you need to be authenticated. See authentication.
You can list all available plugins with:
cedana plugin list
PLUGIN SIZE STATUS INSTALLED VERSION AVAILABLE VERSION PUBLISHED
criu 6 MiB outdated v3.9 v4.0 one month ago
runc 35 MiB installed v0.9.239 v0.9.239 2 hours ago
containerd 38 MiB installed v0.9.239 v0.9.239 2 hours ago
crio 27 MiB installed v0.9.239 v0.9.239 2 hours ago
k8s 32 MiB installed v0.9.239 v0.9.239 2 hours ago
gpu 32 MiB available v0.4.7 2 minutes ago
streamer 1 MiB available v0.0.6 9 days ago
7 installed, 0 available
This will show you all the plugins that are available, installed, or outdated.
You can also list specific plugins by name & version:
cedana plugin list [email protected] [email protected]
PLUGIN SIZE STATUS INSTALLED VERSION AVAILABLE VERSION PUBLISHED
gpu 48 MiB available v0.5.0 one day ago
streamer 6 MiB available v0.0.5 4 months ago
0 installed, 2 available
Locally built plugins
If plugins are built locally (in the current directory), running cedana plugin list
in the current directory will show the locally built plugins instead:
PLUGIN SIZE STATUS INSTALLED VERSION AVAILABLE VERSION PUBLISHED
criu 6 MiB outdated v3.9 v4.0 one month ago
runc 35 MiB installed v0.9.239 local 2 hours ago
containerd 38 MiB installed v0.9.239 local 2 hours ago
crio 27 MiB installed v0.9.239 local 2 hours ago
k8s 32 MiB installed v0.9.239 local 2 hours ago
gpu 32 MiB available v0.4.7 2 minutes ago
streamer 1 MiB available v0.0.6 9 days ago
7 installed, 0 available
Notice the LATEST VERSION
column shows local
for locally built plugins.
Instead of depending on current directory, you can also specify the paths to search for locally built plugins by setting the CEDANA_PLUGINS_LOCAL_SEARCH_PATH
(paths are colon-separated just like the PATH
env var). This is a convenience for developers who are working on multiple plugins at once.
Install
Once a plugin appears in the list, you can install it with:
sudo cedana plugin install <plugin>@<version> <plugin> ...
Uninstall
To uninstall a plugin, use:
sudo cedana plugin remove <plugin> <plugin> ...
Check out the CLI reference for all plugin-related subcommands.
Health check
The full health check command will also check the health of all installed plugins. See health checks.
Last updated
Was this helpful?