Die vctl-Befehle werden in Funktionskategorien unterteilt.

In den folgenden Tabellen sind vctl-Befehle und deren Funktion aufgeführt. Die Optionen in eckigen Klammern sind optional. Der vertikale Balken gibt eine Schlüsselwortoption an.
Hinweis: Verwenden Sie --help, um alle verfügbaren Befehlsoptionen zu überprüfen.

vctl-Befehle zum Verwalten der Container-Laufzeitressource

Befehl Beschreibung
vctl system config [OPTIONS] Konfiguriert und initiiert die Host-Betriebssystemumgebung für die Container Engine.
Der Befehl führt die folgenden Aufgaben aus:
  • Erstellt einen Ordner <Benutzerordner_Ihres_Accounts>/.vctl, falls er nicht vorhanden ist.
  • Aktualisiert die Datei config.yaml im Ordner .vctl mit den benutzerdefinierten Konfigurationen, die von den Befehlsoptionen angegeben werden.
  • Bereitet den Speicher entsprechend der Konfiguration in der Datei config.yaml vor und mountet den Speicher.
  • Prüft die Verfügbarkeit der Anwendung VMware Fusion.
Hinweis: Der Befehl vctl system config startet den containerd-Daemon nicht.
vctl system info [OPTIONS] Zeigt die Laufzeitinformationen des Containers an.
vctl system start [OPTIONS] Startet die Container Engine.

Der Befehl führt die folgenden Aufgaben aus:

  • Erstellt einen Ordner <Benutzerordner_Ihres_Accounts>/.vctl, falls er nicht vorhanden ist.
  • Aktualisiert die Datei config.yaml im Ordner .vctl mit den benutzerdefinierten Konfigurationen, die von den Befehlsoptionen angegeben werden.
  • Bereitet den Speicher entsprechend der Konfiguration in der Datei config.yaml vor und mountet den Speicher.
  • Prüft die Verfügbarkeit der Anwendung VMware Fusion.
  • Startet den containerd-Daemon.
vctl system stop [OPTIONS] Stoppt den Container-Laufzeit.

vctl-Befehle zum Verwalten der Image-Ressource

Befehl Beschreibung
vctl build [OPTIONS] PATH Erstellt ein Container-Image mithilfe einer Dockerfile-Datei.
Hinweis: Wenn die RUN-Anweisungen in der Dockerfile-Datei netzwerkbezogene Befehle ausführen, fügen Sie in der Dockerfile-Datei eine ENV-Anweisung zum Festlegen des Netzwerkproxys hinzu, z. B.: ENV https_proxy <Proxy_Server>:Proxy_Port, damit die Netzwerkvorgänge erfolgreich abgeschlossen werden können.
vctl images [OPTIONS] [IMAGE...] Listet Container-Images auf und zeigt grundlegende Informationen zu den Container-Images an.
vctl push [OPTIONS] IMAGE [REMOTE_URL] Leitet das Container-Image mithilfe von Push an die Registrierung weiter.
vctl rmi [OPTIONS] ([IMAGE...]|--all) Löscht ein oder mehr Container-Images.
vctl tag [OPTIONS] SOURCE_IMAGE TARGET_IMAGE [TARGET_IMAGE...] Kennzeichnet Container-Images. Es wird ein Image-Alias mit dem TARGET_IMAGE erstellt.
vctl pull [OPTIONS] IMAGE Ruft ein Container-Image aus der Registrierung ab.

vctl-Befehle zum Verwalten der Container-Ressource

Befehl Beschreibung
vctl create [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Erstellt einen neuen Container aus einem Container-Image.
Hinweis: Achten Sie auf Folgendes, wenn Sie die Option --volume verwenden:
  • Geben Sie Pfade zum Ordner an. Das --volume unterstützt keinen Pfad zu Dateien.
  • Verwenden Sie einen absoluten Pfad. Relative Pfade werden nicht unterstützt.
  • Es können nur anonyme Volumes gemountet werden, das Mounten von benannten Volumes wird nicht unterstützt.
Hinweis: Achten Sie auf Folgendes, wenn Sie die Option --publish verwenden:

  • Das vctl-Dienstprogramm verfügt über kein Subnetz und keine Verknüpfungsfunktion, um mehrere Container mit einem Subnetz zu verbinden.

    Um die Kommunikation zwischen mehreren Containern zu aktivieren, starten Sie den Container mit der Option --publish. Damit wird der Container-Port an den Host-Port gebunden, sodass der vom Container bereitgestellte Dienst von außen zugänglich ist.
vctl describe [OPTIONS] CONTAINER Zeigt Details zum Container an.
vctl exec [OPTIONS] CONTAINER COMMAND [ARGUMENTS...] Führt einen Befehl in einem laufenden Container aus.
vctl ps [OPTIONS][CONTAINER...] Listet die Container auf und zeigt grundlegende Informationen zu dem Container an.
vctl rm [OPTIONS] ([CONTAINER...]|--all) Löscht einen oder mehr Container.
vctl run [OPTIONS] IMAGE [COMMAND] [ARGUMENTS...] Führt einen neuen Container von einem Container-Image aus.
Hinweis: Achten Sie auf Folgendes, wenn Sie die Option --volume verwenden:
  • Geben Sie Pfade zum Ordner an. Das --volume unterstützt keinen Pfad zu Dateien.
  • Verwenden Sie einen absoluten Pfad. Relative Pfade werden nicht unterstützt.
  • Es können nur anonyme Volumes gemountet werden, das Mounten von benannten Volumes wird nicht unterstützt.
Hinweis: Achten Sie auf Folgendes, wenn Sie die Option --publish verwenden:

  • Das vctl-Dienstprogramm verfügt über kein Subnetz und keine Verknüpfungsfunktion, um mehrere Container mit einem Subnetz zu verbinden.

    Um die Kommunikation zwischen mehreren Containern zu aktivieren, starten Sie den Container mit der Option --publish. Damit wird der Container-Port an den Host-Port gebunden, sodass der vom Container bereitgestellte Dienst von außen zugänglich ist.
vctl start [OPTIONS] CONTAINER Startet einen erstellten oder gestoppten Container.
vctl stop [OPTIONS] CONTAINER Stoppt den Container.
vctl inspect [OPTIONS] NAME Zeigt detaillierte Containerinformationen an.

vctl-Befehle zum Verwalten der CRX VM-Ressource

Befehl Beschreibung
vctl execvm [OPTIONS] (vmx|-c=CONTAINER) COMMAND [ARGUMENTS...] Führt Befehle von innerhalb einer ausgeführten virtuellen Maschine aus, auf der der Container gehostet wird.

vctl-Befehle zum Verwalten von Volumes

Befehl Beschreibung
vctl volume prune [flags] Entfernt alle nicht verwendeten lokalen Volumes.

vctl-Befehle zum Verwalten der Authentifizierung der Conainer-Imgages-Registrierung

Befehl Beschreibung
vctl login [OPTION] [SERVER] Meldet sich bei einer Remoteregistrierung an.
vctl logout [SERVER] Meldet sich bei einer Remoteregistrierung ab.
Hinweis:
  • Unter macOS werden die Anmeldedaten im Schlüsselbund gespeichert. Unter Windows werden die Anmeldedaten im Anmeldedaten-Manager gespeichert.
  • Nach erfolgreichem Abschluss der Anmeldung werden bei zukünftigen Pull-, Push- und Build-Anforderungen die gespeicherten Anmeldedaten verwendet.
  • Die Abmeldeanforderung löscht die entsprechenden Anmeldedaten aus dem Schlüsselbund oder dem Anmeldedaten-Manager.

vctl-Befehle zum Vorbereiten der Systemumgebung für vctl-basiertes KIND

Befehl Beschreibung
vctl kind Bereitet die Systemumgebung für die auf vctl-basiertes KIND vor. KIND verwendet vctl-Container als Knoten für die Ausführung von Kubernetes-Clustern.