vctl 命令分为几个功能类别。

下表列出了 vctl 命令及其功能。用方括号括起来的选项是可选的。竖线表示关键字选项。
注： 使用 --help 可查看所有可用的命令选项。

用于管理容器运行时资源的 vctl 命令

命令 说明
vctl system config [OPTIONS] 为容器引擎配置并初始化主机操作系统环境。
此命令将执行以下任务：
  • 创建 <Home_Folder_of_Your_Account>\.vctl 文件夹（如果该文件夹不存在）。
  • 使用命令选项指定的自定义配置更新 .vctl 文件夹中的 config.yaml 文件。
  • 准备存储空间。
注： vctl system config 命令不会启动 containerd 守护进程。
vctl system info [OPTIONS] 显示容器运行时信息。
vctl system start [OPTIONS] 启动容器引擎。

此命令将执行以下任务：

  • 创建 <Home_Folder_of_Your_Account>\.vctl 文件夹（如果该文件夹不存在）。
  • 使用命令选项指定的自定义配置更新 .vctl 文件夹中的 config.yaml 文件。
  • 准备存储空间。
  • 启动 containerd 守护进程。
vctl system stop [OPTIONS] 停止容器运行时。

用于管理映像资源的 vctl 命令

命令 说明
vctl build [OPTIONS] PATH 使用 Dockerfile 构建容器映像。
注： 如果 Dockerfile 中的 RUN 指令运行与网络相关的命令，请将 ENV 指令添加到 Dockerfile 中以设置网络代理，例如：添加 ENV https_proxy <Proxy_Server>:Proxy_Port 以使网络操作成功。
vctl images [OPTIONS] [IMAGE...] 列出容器映像，并显示有关容器映像的基本信息。
vctl push [OPTIONS] IMAGE [REMOTE_URL] 将容器映像推送到映像仓库。
vctl rmi [OPTIONS] ([IMAGE...]|--all) 删除一个或多个容器映像。
vctl tag [OPTIONS] SOURCE_IMAGE TARGET_IMAGE [TARGET_IMAGE...] 标记容器映像。它会使用 TARGET_IMAGE 创建一个映像别名。
vctl pull [OPTIONS] IMAGE 从映像仓库中提取容器映像。

用于管理容器资源的 vctl 命令

命令 说明
vctl create [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] 从容器映像创建新容器。
注： 使用 --volume 选项时，请确保遵循以下事项：
  • 指定文件夹的路径。--volume 不支持文件路径。
  • 使用绝对路径。不支持相对路径。
  • 仅可挂载匿名卷，不支持挂载已命名的卷。
注： 使用 --publish 选项时，请确保遵循以下事项：

  • vctl 实用程序没有子网或将多个容器连接到子网的链接功能。

    要实现多个容器之间的通信，请使用 --publish 选项启动容器。这会将容器端口绑定到主机端口，以便可以从外部访问容器提供的服务。
vctl describe [OPTIONS] CONTAINER 显示有关容器的详细信息。
vctl exec [OPTIONS] CONTAINER COMMAND [ARGUMENTS...] 在正在运行的容器内运行命令。
vctl ps [OPTIONS][CONTAINER...] 列出容器，并显示有关容器的基本信息。
vctl rm [OPTIONS] ([CONTAINER...]|--all) 删除一个或多个容器。
vctl run [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] 从容器映像运行新容器。
注： 使用 --volume 选项时，请确保遵循以下事项：
  • 指定文件夹的路径。--volume 不支持文件路径。
  • 使用绝对路径。不支持相对路径。
  • 仅可挂载匿名卷，不支持挂载已命名的卷。
注： 使用 --publish 选项时，请确保遵循以下事项：

  • vctl 实用程序没有子网或将多个容器连接到子网的链接功能。

    要实现多个容器之间的通信，请使用 --publish 选项启动容器。这会将容器端口绑定到主机端口，以便可以从外部访问容器提供的服务。
vctl start [OPTIONS] CONTAINER 启动已创建或已停止的容器。
vctl stop [OPTIONS] CONTAINER 停止容器。
vctl inspect [OPTIONS] NAME 显示详细的容器信息。

用于管理 CRX 虚拟机资源的 vctl 命令

命令 说明
vctl execvm [OPTIONS] (vmx|-c=CONTAINER) COMMAND [ARGUMENTS...] 在托管容器的运行中虚拟机内运行命令。

用于管理卷的 vctl 命令

命令 说明
vctl volume prune [flags] 移除所有未使用的本地卷。

用于管理容器映像仓库身份验证的 vctl 命令

命令 说明
vctl login [OPTION] [SERVER] 登录到远程映像仓库。
vctl logout [SERVER] 从远程映像仓库注销。
注：
  • 在 macOS 上，凭据保存在钥匙串中。在 Windows 上，凭据保存在凭据管理器中。
  • 登录成功后，未来的提取、推送和构建请求将利用已保存的凭据。
  • 注销请求会从钥匙串或凭据管理器中删除对应的凭据。

用于使系统环境做好准备以供基于 vctl 的 KIND 使用的 vctl 命令

命令 说明
vctl kind 为基于 vctl 的 KIND 准备系统环境。KIND 使用 vctl 容器作为节点来运行 Kubernetes 集群。