Los comandos vctl se dividen en categorías de funciones.

En las siguientes tablas se enumeran los comandos vctl y sus funciones. Las opciones entre corchetes son opcionales. La barra vertical indica una opción de palabra clave.
Nota: Use --help para revisar todas las opciones de comando disponibles.

Comandos vctl para administrar el recurso de tiempo de ejecución del contenedor

Comando Descripción
vctl system config [OPTIONS] Configura e inicializa el entorno del sistema operativo del host para el motor de contenedor.
El comando realiza las siguientes tareas:
  • Crea una carpeta <carpeta_inicio_cuenta>/.vctl si todavía no existe.
  • Actualiza el archivo config.yaml en la carpeta .vctl con las configuraciones personalizadas especificadas por las opciones de comando.
  • Prepara el almacenamiento de acuerdo con la configuración en el archivo config.yaml y monta el almacenamiento.
  • Comprueba la disponibilidad de la aplicación VMware Fusion.
Nota: El comando vctl system config no inicia el daemon containerd.
vctl system info [OPTIONS] Muestra la información de tiempo de ejecución del contenedor.
vctl system start [OPTIONS] Inicia el motor de contenedor.

El comando realiza las siguientes tareas:

  • Crea una carpeta <carpeta_inicio_cuenta>/.vctl si todavía no existe.
  • Actualiza el archivo config.yaml en la carpeta .vctl con las configuraciones personalizadas especificadas por las opciones de comando.
  • Prepara el almacenamiento de acuerdo con la configuración en el archivo config.yaml y monta el almacenamiento.
  • Comprueba la disponibilidad de la aplicación VMware Fusion
  • Inicia el daemon containerd.
vctl system stop [OPTIONS] Detiene el tiempo de ejecución del contenedor.

Comandos vctl para administrar el recurso de imagen

Comando Descripción
vctl build [OPTIONS] PATH Crea una imagen de contenedor mediante un Dockerfile.
Nota: Si las instrucciones RUN del Dockerfile ejecutan comandos relacionados con la red, agregue la instrucción ENV al Dockerfile para establecer el proxy de red, por ejemplo: ENV https_proxy <servidor_proxy>:<puerto_proxy> para que las operaciones de red se realicen de forma correcta.
vctl images [OPTIONS] [IMAGE...] Muestra las imágenes de contenedor y muestra información básica sobre las imágenes de contenedor.
vctl push [OPTIONS] IMAGE [REMOTE_URL] Envía la imagen de contenedor al registro.
vctl rmi [OPTIONS] ([IMAGE...]|--all) Elimina una o varias imágenes de contenedor.
vctl tag [OPTIONS] SOURCE_IMAGE TARGET_IMAGE [TARGET_IMAGE...] Etiqueta las imágenes de contenedor. Crea un alias de imagen con TARGET_IMAGE.
vctl pull [OPTIONS] IMAGE Extrae una imagen de contenedor del registro.

Comandos vctl para administrar el recurso de contenedor

Comando Descripción
vctl create [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Crea un nuevo contenedor a partir de una imagen de contenedor.
Nota: Asegúrese de lo siguiente cuando utilice la opción --volume:
  • Especifique las rutas de acceso a la carpeta. La opción --volume no es compatible con la ruta de acceso a los archivos.
  • Use la ruta de acceso absoluta. No se admiten las rutas de acceso relativas.
  • Solo se pueden montar volúmenes anónimos; no se admite el montaje de volúmenes con nombre.
Nota: Asegúrese de lo siguiente cuando utilice la opción --publish:

  • La utilidad vctl no tiene una subred ni una función de vínculo para conectar varios contenedores a una subred.

    Para habilitar la comunicación entre varios contenedores, inicie el contenedor con la opción --publish. De este modo, se enlaza el puerto de contenedor al puerto de host para que se pueda acceder al servicio proporcionado por el contenedor desde el exterior.
vctl describe [OPTIONS] CONTAINER Muestra detalles sobre el contenedor.
vctl exec [OPTIONS] CONTAINER COMMAND [ARGUMENTS...] Ejecuta un comando dentro de un contenedor en ejecución.
vctl ps [OPTIONS][CONTAINER...] Enumera los contenedores y muestra información básica sobre el contenedor.
vctl rm [OPTIONS] ([CONTAINER...]|--all) Elimina uno o varios contenedores.
vctl run [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Ejecuta un nuevo contenedor desde una imagen de contenedor.
Nota: Asegúrese de lo siguiente cuando utilice la opción --volume:
  • Especifique las rutas de acceso a la carpeta. La opción --volume no es compatible con la ruta de acceso a los archivos.
  • Use la ruta de acceso absoluta. No se admiten las rutas de acceso relativas.
  • Solo se pueden montar volúmenes anónimos; no se admite el montaje de volúmenes con nombre.
Nota: Asegúrese de lo siguiente cuando utilice la opción --publish:

  • La utilidad vctl no tiene una subred ni una función de vínculo para conectar varios contenedores a una subred.

    Para habilitar la comunicación entre varios contenedores, inicie el contenedor con la opción --publish. De este modo, se enlaza el puerto de contenedor al puerto de host para que se pueda acceder al servicio proporcionado por el contenedor desde el exterior.
vctl start [OPTIONS] CONTAINER Inicia un contenedor creado o detenido.
vctl stop [OPTIONS] CONTAINER Detiene el contenedor.
vctl inspect [OPTIONS] NAME Muestra información detallada del contenedor.

Comandos vctl para administrar el recurso de máquina virtual de CRX

Comando Descripción
vctl execvm [OPTIONS] (vmx|-c=CONTAINER) COMMAND [ARGUMENTS...] Ejecuta comandos desde una máquina virtual en ejecución que aloja el contenedor.

Comandos vctl para administrar volúmenes

Comando Descripción
vctl volume prune [flags] Elimina todos los volúmenes locales sin utilizar.

Comandos vctl para administrar la autenticación del registro de imágenes de contenedor

Comando Descripción
vctl login [OPTION] [SERVER] Inicia la sesión en un registro remoto.
vctl logout [SERVER] Cierra la sesión de un registro remoto.
Nota:
  • En macOS, las credenciales se guardan en el Llavero. En Windows, las credenciales se guardan en el Administrador de credenciales.
  • Cuando el inicio de sesión se haya realizado correctamente, las solicitudes de extracción, inserción y compilación posteriores aprovecharán la credencial guardada.
  • La solicitud de cierre de sesión elimina la credencial correspondiente del Llavero o el Administrador de credenciales.

Comandos vctl para obtener el entorno del sistema preparado para KIND basado en vctl

Comando Descripción
vctl kind Prepara el entorno del sistema para KIND basado en vctl. KIND utiliza contenedores vctl como nodos para la ejecución de clústeres de Kubernetes.