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>:P roxy_Port (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 集群。