crictl 是 CRI 兼容的容器运行时命令行接口。 你可以使用它来检查和调试 Kubernetes 节点上的容器运行时和应用程序。 crictl 和它的源代码在 cri-tools 代码库。
crictl 默认连接到unix:///var/run/dockershim.sock。 对于其他的运行时，你可以用多种不同的方法设置端点:
- 通过设置参数
--runtime-endpoint和--image-endpoint - 通过设置环境变量
CONTAINER_RUNTIME_ENDPOINT和IMAGE_SERVICE_ENDPOINT - 通过在配置文件中设置端点
--config=/etc/crictl.yaml
要查看或编辑当前配置，请查看或编辑 /etc/crictl.yaml 的内容。
[root ~]$ cat /etc/crictl.yaml
runtime-endpoint: unix:///var/run/dockershim.sock
image-endpoint: unix:///var/run/dockershim.sock
timeout: 10
debug: true
| crictl | 描述 |
|---|---|
| imagefsinfo | 返回镜像的文件系统信息 |
| inspectp | 显示一个或多个 Pod 的状态 |
| port-forward | 转发本地端口到 Pod |
| pods | 列举 Pod |
| runp | 运行一个新的 Pod |
| rmp | 移除一个或多个 Pod |
| stopp | 停止一个或多个正运行的 Pod |
| attach | 连接到一个运行中的容器 |
| exec | 在运行中的容器里运行一个命令 |
| images | 列举镜像 |
| info | 显示系统级的信息 |
| inspect, inspecti | 返回容器、镜像或者任务的详细信息 |
| logs | 获取容器的日志 |
| ps | 列举容器 |
| stats | 实时显示容器的资源使用统计信息 |
| version | 显示运行时（Docker、ContainerD、或者其他) 的版本信息 |
| create | 创建一个新的容器 |
| stop (timeout=0) | 杀死一个或多个正在运行的容器 |
| pull | 从镜像仓库拉取镜像或者代码仓库 |
| rm | 移除一个或多个容器 |
| rmi | 移除一个或多个镜像 |
| run | 在新容器里运行一个命令 |
| start | 启动一个或多个停止的容器 |
| stop | 停止一个或多个正运行的容器 |
| update | 更新一个或多个容器的配置 |
Docker CLI 和 crictl 的映射
以下的映射表格只适用于 Docker CLI v1.40 和 crictl v1.19.0 版本。 请注意该表格并不详尽。例如，其中不包含 Docker CLI 的实验性命令。
说明： 尽管有些命令的输出缺少了一些数据列，CRICTL 的输出格式与 Docker CLI 是类似的。 如果你的脚本程序需要解析命令的输出，请确认检查该特定命令的输出。
| docker cli | crictl | 描述 | 不支持的功能 |
|---|---|---|---|
| attach | attach | 连接到一个运行中的容器 | --detach-keys, --sig-proxy |
| exec | exec | 在运行中的容器里运行一个命令 | --privileged, --user, --detach-keys |
| images | images | 列举镜像 | |
| info | info | 显示系统级的信息 | |
| inspect | inspect, inspecti | 返回容器、镜像或者任务的详细信息 | |
| logs | logs | 获取容器的日志 | --details |
| ps | ps | 列举容器 | |
| stats | stats | 实时显示容器的资源使用统计信息 | 列：NET/BLOCK I/O, PIDs |
| version | version | 显示运行时（Docker、ContainerD、或者其他) 的版本信息 | |
| create | create | 创建一个新的容器 | |
| kill | stop (timeout=0) | 杀死一个或多个正在运行的容器 | --signal |
| pull | pull | 从镜像仓库拉取镜像或者代码仓库--all-tags, --disable-content-trust | |
| rm | rm | 移除一个或多个容器 | |
| rmi | rmi | 移除一个或多个镜像 | |
| run | run | 在新容器里运行一个命令 | |
| start | start | 启动一个或多个停止的容器 | --detach-keys |
| stop | stop | 停止一个或多个正运行的容器 | |
| update | update | 更新一个或多个容器的配置 | CRI 不支持 --restart、--blkio-weight 以及一些其他的资源限制选项。 |
网友评论