Les commandes vctl sont divisées en catégories de fonction.

Les tableaux suivants répertorient les commandes vctl et leur fonction. Les paramètres entre crochets sont facultatifs. La barre verticale indique un choix de mot clé.

Remarque

Utilisez --help pour vérifier toutes les options de commande disponibles.

Commande

Description

vctl system config [OPTIONS]

Configure et initialise l'environnement de système d'exploitation hôte pour le moteur de conteneur.

La commande effectue les tâches suivantes :

Crée un dossier <Home_Folder_of_Your_Account>/.vctl s'il n'existe pas.

Met à jour le fichier config.yaml dans le dossier .vctl avec les configurations personnalisées spécifiées par les options de commande.

Prépare le stockage en fonction de la configuration dans le fichier config.yaml et monte le stockage.

Vérifie la disponibilité de l'application VMware Fusion.

Remarque

La commande vctl system config ne démarre pas le démon containerd.

vctl system info [OPTIONS]

Affiche les informations d'exécution du conteneur.

vctl system start [OPTIONS]

Démarre le moteur de conteneur.

La commande effectue les tâches suivantes :

Crée un dossier <Home_Folder_of_Your_Account>/.vctl s'il n'existe pas.

Met à jour le fichier config.yaml dans le dossier .vctl avec les configurations personnalisées spécifiées par les options de commande.

Prépare le stockage en fonction de la configuration dans le fichier config.yaml et monte le stockage.

Vérifie la disponibilité de l'application VMware Fusion.

Démarre le démon containerd.

vctl system stop [OPTIONS]

Arrête l'exécution du conteneur.

Commande

Description

vctl build [OPTIONS] PATH

Génère une image de conteneur à l'aide d'un fichier Dockerfile.

Remarque

Si les instructions d'exécution dans le fichier Dockerfile exécutent des commandes liées au réseau, ajoutez des instructions ENV dans le fichier Dockerfile pour définir le proxy réseau. Par exemple : ENV https_proxy <Proxy_Server>:Proxy_Port pour que les opérations réseau réussissent.

vctl images [OPTIONS] [IMAGE...]

Répertorie les images de conteneur et affiche des informations de base sur les images de conteneur.

vctl push [OPTIONS] IMAGE [REMOTE_URL]

Transfère l'image de conteneur vers le registre.

vctl rmi [OPTIONS] ([IMAGE...]|--all)

Supprime une ou plusieurs images de conteneur.

vctl tag [OPTIONS] SOURCE_IMAGE TARGET_IMAGE [TARGET_IMAGE...]

Marque les images de conteneur à l'aide d'une balise. Crée un alias d'image avec TARGET_IMAGE.

vctl pull [OPTIONS] IMAGE

Extrait une image de conteneur du Registre.

Commande

Description

vctl create [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...]

Crée un conteneur à partir d'une image de conteneur.

Remarque

Vérifiez les points suivants lorsque vous utilisez l'option --volume :

Spécifiez les chemins d'accès au dossier. La commande --volume ne prend pas en charge le chemin d'accès aux fichiers.

Utilisez le chemin absolu. Les chemins d'accès relatifs ne sont pas pris en charge.

Vous ne pouvez monter que les volumes anonymes. Le montage des volumes nommés n'est pas pris en charge.

Remarque

Vérifiez les points suivants lorsque vous utilisez l'option --publish :

L'utilitaire vctl ne dispose pas d'un sous-réseau ou d'une fonctionnalité de lien pour connecter plusieurs conteneurs à un sous-réseau.

Pour activer la communication entre plusieurs conteneurs, démarrez le conteneur avec l'option --publish. Cela lie le port de conteneur au port de l'hôte afin que le service assuré par le conteneur soit accessible à l'extérieur.

vctl describe [OPTIONS] CONTAINER

Affiche des détails sur le conteneur.

vctl exec [OPTIONS] CONTAINER COMMAND [ARGUMENTS...]

Exécute une commande dans un conteneur en cours d'exécution.

vctl ps [OPTIONS][CONTAINER...]

Répertorie les conteneurs et affiche des informations de base sur le conteneur.

vctl rm [OPTIONS] ([CONTAINER...]|--all)

Supprime un ou plusieurs conteneurs.

vctl run [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...]

Exécute un nouveau conteneur à partir d'une image de conteneur.

Remarque

Vérifiez les points suivants lorsque vous utilisez l'option --volume :

Spécifiez les chemins d'accès au dossier. La commande --volume ne prend pas en charge le chemin d'accès aux fichiers.

Utilisez le chemin absolu. Les chemins d'accès relatifs ne sont pas pris en charge.

Vous ne pouvez monter que les volumes anonymes. Le montage des volumes nommés n'est pas pris en charge.

Remarque

Vérifiez les points suivants lorsque vous utilisez l'option --publish :

L'utilitaire vctl ne dispose pas d'un sous-réseau ou d'une fonctionnalité de lien pour connecter plusieurs conteneurs à un sous-réseau.

Pour activer la communication entre plusieurs conteneurs, démarrez le conteneur avec l'option --publish. Cela lie le port de conteneur au port de l'hôte afin que le service assuré par le conteneur soit accessible à l'extérieur.

vctl start [OPTIONS] CONTAINER

Démarre un conteneur créé ou arrêté.

vctl stop [OPTIONS] CONTAINER

Arrête le conteneur.

vctl inspect [OPTIONS] NAME

Affiche des informations détaillées sur le conteneur.

Commande

Description

vctl execvm [OPTIONS] (vmx|-c=CONTAINER) COMMAND [ARGUMENTS...]

Exécute des commandes depuis une machine virtuelle en cours d'exécution qui héberge le conteneur.

Commande

Description

vctl volume prune [flags]

Supprime tous les volumes locaux inutilisés.

Commande

Description

vctl login [OPTION] [SERVER]

Se connecte à un Registre distant.

vctl logout [SERVER]

Se déconnecte d'un Registre distant.

Remarque

Sous macOS, les informations d'identification sont enregistrées dans le trousseau. Sous Windows, les informations d'identification sont enregistrées dans le gestionnaire d'informations d'identification.

Une fois que la connexion a réussi, les demandes d'extraction, de transfert et de génération ultérieures utiliseront les informations d'identification enregistrées.

La demande de déconnexion supprime les informations d'identification correspondantes du trousseau ou du gestionnaire d'informations d'identification.

Commande

Description

vctl kind

Prépare l'environnement système pour l’élément KIND basé sur vctl. KIND utilise des conteneurs vctl en tant que nœuds pour l'exécution des clusters Kubernetes.