vctl 命令的语法

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

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

命令
说明
vctl system config [OPTIONS]
为容器引擎配置并初始化主机操作系统环境。
此命令将执行以下任务:
  • 创建
    <Home_Folder_of_Your_Account>/.vctl
    文件夹(如果该文件夹不存在)。
  • 使用命令选项指定的自定义配置更新
    .vctl
    文件夹中的
    config.yaml
    文件。
  • 根据
    config.yaml
    文件中的配置来准备存储并挂载该存储。
  • 检查 VMware Fusion 应用程序的可用性。
vctl system config
命令不会启动 containerd 守护进程。
vctl system info [OPTIONS]
显示容器运行时信息。
vctl system start [OPTIONS]
启动容器引擎。
此命令将执行以下任务:
  • 创建
    <Home_Folder_of_Your_Account>/.vctl
    文件夹(如果该文件夹不存在)。
  • 使用命令选项指定的自定义配置更新
    .vctl
    文件夹中的
    config.yaml
    文件。
  • 根据
    config.yaml
    文件中的配置来准备存储并挂载该存储。
  • 检查 VMware Fusion 应用程序的可用性
  • 启动 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 集群。