You are viewing documentation for Kubernetes version: v1.25
Kubernetes v1.25 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date information, see the latest version.
Mapping from dockercli to crictl
crictl is a command-line interface for CRI-compatible container runtimes.
You can use it to inspect and debug container runtimes and applications on a
Kubernetes node. crictl and its source are hosted in the
cri-tools repository.
This page provides a reference for mapping common commands for the docker
command-line tool into the equivalent commands for crictl.
Mapping from docker CLI to crictl
The exact versions for the mapping table are for docker CLI v1.40 and crictl
v1.19.0. This list is not exhaustive. For example, it doesn't include
experimental docker CLI commands.
crictl is similar to docker CLI, despite some missing
columns for some CLI. Make sure to check output for the specific command if your
command output is being parsed programmatically.Retrieve debugging information
| docker cli | crictl | Description | Unsupported Features |
|---|---|---|---|
attach | attach | Attach to a running container | --detach-keys, --sig-proxy |
exec | exec | Run a command in a running container | --privileged, --user, --detach-keys |
images | images | List images | |
info | info | Display system-wide information | |
inspect | inspect, inspecti | Return low-level information on a container, image or task | |
logs | logs | Fetch the logs of a container | --details |
ps | ps | List containers | |
stats | stats | Display a live stream of container(s) resource usage statistics | Column: NET/BLOCK I/O, PIDs |
version | version | Show the runtime (Docker, ContainerD, or others) version information |
Perform Changes
| docker cli | crictl | Description | Unsupported Features |
|---|---|---|---|
create | create | Create a new container | |
kill | stop (timeout = 0) | Kill one or more running container | --signal |
pull | pull | Pull an image or a repository from a registry | --all-tags, --disable-content-trust |
rm | rm | Remove one or more containers | |
rmi | rmi | Remove one or more images | |
run | run | Run a command in a new container | |
start | start | Start one or more stopped containers | --detach-keys |
stop | stop | Stop one or more running containers | |
update | update | Update configuration of one or more containers | --restart, --blkio-weight and some other resource limit not supported by CRI. |
Supported only in crictl
| crictl | Description |
|---|---|
imagefsinfo | Return image filesystem info |
inspectp | Display the status of one or more pods |
port-forward | Forward local port to a pod |
pods | List pods |
runp | Run a new pod |
rmp | Remove one or more pods |
stopp | Stop one or more running pods |
Items on this page refer to third party products or projects that provide functionality required by Kubernetes. The Kubernetes project authors aren't responsible for those third-party products or projects. See the CNCF website guidelines for more details.
You should read the content guide before proposing a change that adds an extra third-party link.