• 基础操作命令
  • 1、kubectl 命令
    • 1.1 自动补全
  • 2、containerd 常用命令
  • 3、crictl

基础操作命令

1、kubectl 命令

1.1 自动补全

在k8s 1.3版本之前，设置kubectl命令自动补全是通过以下的方式：
source ./contrib/completions/bash/kubectl
但是在k8s 1.3版本，源码contrib目录中已经没有了completions目录，无法再使用以上方式添加自动补全功能。

1.3版本后，kubectl添加了一个completions的命令， 该命令可用于自动补全

source <(kubectl completion bash)

具体步骤如下：

yum install -y bash-completion
source /usr/share/bash-completion/bash_completion
source <(kubectl completion bash)
echo "source <(kubectl completion bash)" >> ~/.bashrc

2、containerd 常用命令

在了解容器相关命令前，先看一张图，了解一下 docker/ctr/crictl 三者的关系：

• 主要有以下区别

  • docker 底层使用的是 containerd, 但 docker 操作的是 containerd 下 moby 命名空间下的资源，只能操作容器，而不能操作 containerd 的镜像
  • ctr 是 containerd 自带工具，对接是 containerd 的 api，操作的是 containerd下 的 default 空间，并且镜像保存目录与docker 不通，ctr 也不能操作docker的镜像
  • crictl 是 k8s 提供的，操作的是 containerd下的 k8s.io 空间，其命名用法几乎与 docker 一致，甚至可以使用 alias docker=crictl 在系统中建立快捷命令

• 万事不明， 先看帮助 -h

# ctr -h

# 以下是输出
NAME:
   ctr - 
        __
  _____/ /______
 / ___/ __/ ___/
/ /__/ /_/ /
\___/\__/_/

containerd CLI


USAGE:
   ctr [global options] command [command options] [arguments...]

VERSION:
   v1.6.14

DESCRIPTION:
   
ctr is an unsupported debug and administrative client for interacting
with the containerd daemon. Because it is unsupported, the commands,
options, and operations are not guaranteed to be backward compatible or
stable from release to release of the containerd project.

COMMANDS:
   plugins, plugin            provides information about containerd plugins
   version                    print the client and server versions
   containers, c, container   manage containers
   content                    manage content
   events, event              display containerd events
   images, image, i           manage images  # images,image,i 都可以用，是相同的意思，i是简写
   leases                     manage leases
   namespaces, namespace, ns  manage namespaces
   pprof                      provide golang pprof outputs for containerd
   run                        run a container
   snapshots, snapshot        manage snapshots
   tasks, t, task             manage tasks
   install                    install a new package
   oci                        OCI tools
   shim                       interact with a shim directly
   help, h                    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --debug                      enable debug output in logs
   --address value, -a value    address for containerd's GRPC server (default: "/run/containerd/containerd.sock") [$CONTAINERD_ADDRESS]
   --timeout value              total timeout for ctr commands (default: 0s)
   --connect-timeout value      timeout for connecting to containerd (default: 0s)
   --namespace value, -n value  namespace to use with commands (default: "default") [$CONTAINERD_NAMESPACE]
   --help, -h                   show help
   --version, -v                print the version

images，image, i 都可以用，三者是相同的含义，例如拉取镜像时，可以使用 ctr images pull <image>，也可以用ctr image pull <image>，日常经常使用ctr i pull <image>

延伸1：docker run 运行的容器与 containerd 是什么关系？
当同一台主机同时安装了 docker 和 containerd 时，docker run 运行的容器处于docker自动创建的 moby 空间下，此时如果用 ctr -n moby task ls 查看 containerd 下的 task， 是能够看到 docker run 启动的容器的

延伸2：容器c与任务t的关系
容器可以是静态的，也可以是动态的；静态容器是指创建了容器，但容器中没有任务在运行，只是一个空壳子，是无状态的，静态容器可以用 ctr c ls查看；ctr t ls 只能看到有状态的容器，如STOPPED,RUNNING,PAUSE，看不到静态容器

3、crictl

crictl 可以直接查看 k8s 中的容器，由 k8s 提供，它使用的命名空间是 k8s.io，单conntainerd环境下，该命令无输出
crictl 的命令大部分与 docker 类似

其余命令可以查看帮助

crictl -h 

# 以下为输出
NAME:
   crictl - client for CRI

USAGE:
   crictl [global options] command [command options] [arguments...]

VERSION:
   1.24.1

COMMANDS:
   attach              Attach to a running container
   create              Create a new container
   exec                Run a command in a running container
   version             Display runtime version information
   images, image, img  List images
   inspect             Display the status of one or more containers
   inspecti            Return the status of one or more images
   imagefsinfo         Return image filesystem info
   inspectp            Display the status of one or more pods
   logs                Fetch the logs of a container
   port-forward        Forward local port to a pod
   ps                  List containers
   pull                Pull an image from a registry
   run                 Run a new container inside a sandbox
   runp                Run a new pod
   rm                  Remove one or more containers
   rmi                 Remove one or more images
   rmp                 Remove one or more pods
   pods                List pods
   start               Start one or more created containers
   info                Display information of the container runtime
   stop                Stop one or more running containers
   stopp               Stop one or more running pods
   update              Update one or more running containers
   config              Get and set crictl client configuration options
   stats               List container(s) resource usage statistics
   statsp              List pod resource usage statistics
   completion          Output shell completion code
   help, h             Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --config value, -c value            Location of the client config file. If not specified and the default does not exist, the program's directory is searched as well (default: "/etc/crictl.yaml") [$CRI_CONFIG_FILE]
   --debug, -D                         Enable debug mode (default: false)
   --image-endpoint value, -i value    Endpoint of CRI image manager service (default: uses 'runtime-endpoint' setting) [$IMAGE_SERVICE_ENDPOINT]
   --runtime-endpoint value, -r value  Endpoint of CRI container runtime service (default: uses in order the first successful one of [unix:///var/run/dockershim.sock unix:///run/containerd/containerd.sock unix:///run/crio/crio.sock unix:///var/run/cri-dockerd.sock]). Default is now deprecated and the endpoint should be set instead. [$CONTAINER_RUNTIME_ENDPOINT]
   --timeout value, -t value           Timeout of connecting to the server in seconds (e.g. 2s, 20s.). 0 or less is set to default (default: 2s)
   --help, -h                          show help (default: false)
   --version, -v                       print the version (default: false)

（未完待续）