Os comandos vctl são divididos em categorias de função.

As tabelas a seguir listam os comandos vctl e suas funções. As opções entre colchetes são opcionais. A barra vertical indica uma escolha de palavra-chave.
Observação: Use --help para revisar todas as opções de comando disponíveis.

vctl Comandos para gerenciar o recurso Container Runtime

Comando Descrição
vctl system config [OPTIONS] Configura e inicializa o ambiente do sistema operacional host para o mecanismo de contêiner.
O comando executa as seguintes tarefas:
  • Cria uma pasta <Home_Folder_of_Your_Account>\.vctl se ela não existir.
  • Atualiza o arquivo config.yaml na pasta .vctl com as configurações personalizadas especificadas pelas opções de comando.
  • Prepara o armazenamento.
Observação: O comando vctl system config não inicia o daemon containerd.
vctl system info [OPTIONS] Exibe as informações de tempo de execução do contêiner.
vctl system start [OPTIONS] Inicia o mecanismo de contêiner.

O comando executa as seguintes tarefas:

  • Cria uma pasta <Home_Folder_of_Your_Account>\.vctl se ela não existir.
  • Atualiza o arquivo config.yaml na pasta .vctl com as configurações personalizadas especificadas pelas opções de comando.
  • Prepara o armazenamento.
  • Inicia o daemon containerd.
vctl system stop [OPTIONS] Interrompe o tempo de execução do contêiner.

vctl Comandos para gerenciar o recurso de imagem

Comando Descrição
vctl build [OPTIONS] PATH Cria uma imagem de contêiner usando um Dockerfile.
Observação: Se as instruções RUN no Dockerfile executarem comandos relacionados à rede, adicione a instrução ENV no Dockerfile para definir o proxy de rede, por exemplo: ENV https_proxy <Proxy_Server>:Proxy_Port para que as operações de rede sejam bem-sucedidas.
vctl images [OPTIONS] [IMAGE...] Lista imagens de contêiner e exibe informações básicas sobre as imagens de contêiner.
vctl push [OPTIONS] IMAGE [REMOTE_URL] Envia a imagem do contêiner para o registro.
vctl rmi [OPTIONS] ([IMAGE...]|--all) Exclui uma ou mais imagens de contêiner.
vctl tag [OPTIONS] SOURCE_IMAGE TARGET_IMAGE [TARGET_IMAGE...] Marca imagens de contêiner. Ele cria um alias de imagem com o TARGET_IMAGE.
vctl pull [OPTIONS] IMAGE Extrai uma imagem de contêiner do registro.

vctl Comandos para gerenciar o recurso de contêiner

Comando Descrição
vctl create [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Cria um novo contêiner a partir de uma imagem de contêiner.
Observação: Certifique-se do seguinte ao usar a opção --volume:
  • Especifique os caminhos para a pasta. O --volume não é compatível com o caminho para os arquivos.
  • Use o caminho absoluto. Não há suporte para caminhos relativos.
  • Somente volumes anônimos podem ser montados. Não há suporte para a montagem de volumes nomeados.
Observação: Certifique-se do seguinte ao usar a opção --publish:

  • O utilitário vctl não tem um recurso de sub-rede ou link para conectar vários contêineres a uma sub-rede.

    Para ativar a comunicação entre vários contêineres, inicie o contêiner com a opção --publish. Isso vincula a porta do contêiner à porta do host para que o serviço fornecido pelo contêiner seja acessível do lado de fora.
vctl describe [OPTIONS] CONTAINER Exibe detalhes sobre o contêiner.
vctl exec [OPTIONS] CONTAINER COMMAND [ARGUMENTS...] Executa um comando dentro de um contêiner em execução.
vctl ps [OPTIONS][CONTAINER...] Lista os contêineres e exibe informações básicas sobre o contêiner.
vctl rm [OPTIONS] ([CONTAINER...]|--all) Exclui um ou mais contêineres.
vctl run [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Executa um novo contêiner de uma imagem de contêiner.
Observação: Certifique-se do seguinte ao usar a opção --volume:
  • Especifique os caminhos para a pasta. O --volume não é compatível com o caminho para os arquivos.
  • Use o caminho absoluto. Não há suporte para caminhos relativos.
  • Somente volumes anônimos podem ser montados. Não há suporte para a montagem de volumes nomeados.
Observação: Certifique-se do seguinte ao usar a opção --publish:

  • O utilitário vctl não tem um recurso de sub-rede ou link para conectar vários contêineres a uma sub-rede.

    Para ativar a comunicação entre vários contêineres, inicie o contêiner com a opção --publish. Isso vincula a porta do contêiner à porta do host para que o serviço fornecido pelo contêiner seja acessível do lado de fora.
vctl start [OPTIONS] CONTAINER Inicia um contêiner criado ou interrompido.
vctl stop [OPTIONS] CONTAINER Interrompe o contêiner.
vctl inspect [OPTIONS] NAME Exibe informações detalhadas do contêiner.

vctl Comandos para gerenciar o recurso de VM CRX

Comando Descrição
vctl execvm [OPTIONS] (vmx|-c=CONTAINER) COMMAND [ARGUMENTS...] Executa comandos de dentro de uma máquina virtual em execução que hospeda o contêiner.

vctl Comandos para gerenciar volumes

Comando Descrição
vctl volume prune [flags] Remove todos os volumes locais não utilizados.

vctl Comandos para gerenciar a autenticação do Container Images Registry

Comando Descrição
vctl login [OPTION] [SERVER] Faz login em um registro remoto.
vctl logout [SERVER] Efetua logout de um registro remoto.
Observação:
  • Em macOS, as credenciais são salvas no Keychain. Em Windows, as credenciais são salvas no Credential Manager.
  • Depois que o login for bem-sucedido, futuras solicitações de Pull, Push e Build aproveitarão a credencial salva.
  • A solicitação de logout exclui a credencial correspondente do Keychain ou do Credential Manager.

vctl Comandos para preparar o ambiente do sistema para o KIND baseado em vctl

Comando Descrição
vctl kind Prepara o ambiente do sistema para o KIND baseado em vctl. O KIND usa contêineres vctl como nós para executar clusters Kubernetes.