You are viewing documentation for Kubernetes version: v1.23

Kubernetes v1.23 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, 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.

Retrieve debugging information

mapping from docker cli to crictl - 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

mapping from docker cli to crictl - 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

mapping from docker cli to crictl - 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.

Last modified January 12, 2022 at 9:03 AM PST: Migrate mapping dockercli to crictl to Reference (d01714e72b)