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.

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.

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.

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.

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.

Comando

Descripción

vctl volume prune [flags]

Elimina todos los volúmenes locales sin utilizar.

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.

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.