Formatierung und Filterung der Container Registry CLI-Ausgabe

Sie können die Ausgabe der IBM Cloud® Container Registry Befehlszeilenschnittstelle (CLI) für unterstützte IBM Cloud Container Registry Befehle formatieren und filtern.

Standardmäßig wird die Ausgabe der Befehlszeilenschnittstelle in einem lesbaren Format angezeigt. Diese Ansicht kann jedoch Ihre Möglichkeit, die Ausgabe zu verwenden, einschränken, besonders wenn der Befehl programmgesteuert ausgeführt wird. In der CLI-Ausgabe von ibmcloud cr image-list könnten Sie beispielsweise das Feld Size in numerischer Reihenfolge sortieren wollen, der Befehl gibt jedoch eine Stringbeschreibung zurück. Das container-registry CLI-Plug-in bietet eine Formatoption, mit der Sie eine Go-Vorlage auf die CLI-Ausgabe anwenden können.

Sie können die Ausgabe der Befehlszeilenschnittstelle ändern, indem Sie die Option 'format' auf zwei verschiedene Arten anwenden:

  • Formatieren Sie die Daten in Ihrer CLI-Ausgabe. Ändern Sie beispielsweise die Ausgabe des Felds Created von UNIX®-Zeit in Standardzeit.
  • Filtern Sie die Daten in Ihrer CLI-Ausgabe. Filtern Sie z. B. nach Details des Bildes, um eine bestimmte Untergruppe von Bildern anzuzeigen, indem Sie die Bedingung Go template if gt verwenden.

Sie können die Option 'format' mit den folgenden IBM Cloud Container Registry-Befehlen verwenden. Klicken Sie auf einen Befehl, um eine Liste der verfügbaren Felder und ihrer Datentypen anzuzeigen.

Go-Vorlagenoptionen für ibmcloud cr image-digests

In der folgenden Tabelle finden Sie die verfügbaren Go-Vorlagenoptionen und Datentypen für den ibmcloud cr image-digests befehl.

Verfügbare Felder und Datentypen im Befehl Container Registry zur Auflistung von Bild-Digests
Feld Typ Beschreibung
Created Ganzzahl (64-Bit) Diese Option zeigt an, wann das Image erstellt wurde, ausgedrückt durch die Anzahl der Sekunden in UNIX-Zeit.
Digest Zeichenfolge Diese Option zeigt den eindeutigen Bezeichner für ein Bild an.
ManifestType Zeichenfolge Diese Option zeigt den Typ des Bildmanifests an.
Repository Zeichenfolge Mit dieser Option wird das Repository des Bildes angezeigt.
SecurityStatus Object Mit dieser Option wird der Status der Sicherheitsrisiken für das Bild angezeigt. Sie können die folgenden Werte filtern und formatieren:

  • Status string
  • IssueCount int
  • ExemptionCount int

Die möglichen Statusangaben werden im Abschnitt Schwachstellenbericht über die Befehlszeilenschnittstelle prüfen beschrieben.
Size Ganzzahl (64-Bit) Diese Option zeigt die Größe des Bildes in Bytes an.
Tags Array von Zeichenfolgen Mit dieser Option werden die Tags für das Bild angezeigt.

Beispiel Go-Formatbefehl für ibmcloud cr image-digests

Um alle nicht markierten Bilder anzuzeigen, die durch ihre Digests referenziert werden, führen Sie den folgenden Befehl ibmcloud cr image-digests aus.

ibmcloud cr image-digests --format '{{if not .Tags}}{{.Repository}}@{{.Digest}}{{end}}'

Die folgende Meldung ist ein Beispiel für die Ausgabe des Befehls

example-<region>.icr.io/user1/my_first_repo@<digest1>
example-<region>.icr.io/user1/my_first_repo@<digest2>
example-<region>.icr.io/user1/my_first_repo@<digest3>

Go-Vorlagenoptionen für ibmcloud cr image-list

In der folgenden Tabelle finden Sie die verfügbaren Go-Vorlagenoptionen und Datentypen für den ibmcloud cr image-list befehl.

Verfügbare Felder und Datentypen im Befehl Container Registry zum Auflisten von Bildern
Feld Typ Beschreibung
Created Ganzzahl (64-Bit) Diese Option zeigt an, wann das Image erstellt wurde, ausgedrückt durch die Anzahl der Sekunden in UNIX-Zeit.
Digest Zeichenfolge Diese Option zeigt den eindeutigen Bezeichner für ein Bild an.
ManifestType Zeichenfolge Diese Option zeigt den Typ des Bildmanifests an.
Namespace Zeichenfolge Diese Option zeigt den Namespace an, in dem das Bild gespeichert ist.
Repository Zeichenfolge Mit dieser Option wird das Repository des Bildes angezeigt.
SecurityStatus Object Mit dieser Option wird der Status der Sicherheitsrisiken für das Bild angezeigt. Sie können die folgenden Werte filtern und formatieren:

  • Status string
  • IssueCount int
  • ExemptionCount int

Die möglichen Statusangaben werden im Abschnitt Schwachstellenbericht über die Befehlszeilenschnittstelle prüfen beschrieben.
Size Ganzzahl (64-Bit) Diese Option zeigt die Größe des Bildes in Bytes an.
Tag Zeichenfolge Mit dieser Option wird der Tag des Bildes angezeigt.

Beispiel Go-Formatbefehl für ibmcloud cr image-list

Um den Repository-, Tag- und Sicherheitsstatus aller getaggten Bilder, die größer als 1 MB sind, anzuzeigen, führen Sie den folgenden Befehl aus: ibmcloud cr image-list.

ibmcloud cr image-list --format "{{ if gt .Size 1000000 }}{{ .Repository }}:{{ .Tag }} {{ .SecurityStatus.Status }}{{end}}"

Die folgende Nachricht ist ein Beispiel für die Ausgabe des Befehls:

example-<region>.icr.io/user1/my_first_repo:latest No Issues
example-<region>.icr.io/user1/my_second_repo:1 2 Issues
example-<region>.icr.io/user1/my_second_repo:test1 1 Issue
example-<region>.icr.io/user1/my_second_repo_2:test2 7 Issues

Wenn die Zeitüberschreitung für den Befehl zum Auflisten von Bildern auftritt, finden Sie Hilfe unter Warum tritt eine Zeitüberschreitung auf, wenn ich Bilder aufliste?.

Go-Vorlagenoptionen für ibmcloud cr image-inspect

In der folgenden Tabelle finden Sie die verfügbaren Go-Vorlagenoptionen und Datentypen für den ibmcloud cr image-inspect befehl.

Verfügbare Felder und Datentypen im Befehl Container Registry zum Prüfen von Bildern
Feld Typ Beschreibung
Architecture Zeichenfolge Diese Option zeigt die Prozessorarchitektur an, die für die Erstellung des Images verwendet wurde und die für die Ausführung des Images erforderlich ist.
Author Zeichenfolge Mit dieser Option wird der Autor des Bildes angezeigt.
Comment Zeichenfolge Mit dieser Option wird die Beschreibung des Bildes angezeigt.
Config Object Mit dieser Option werden die Konfigurations-Metadaten für das Bild angezeigt. Weitere Informationen finden Sie im Abschnitt zu den Felddetails zu Config.
Container Zeichenfolge Diese Option zeigt die ID des Containers an, der das Bild erstellt hat.
ContainerConfig Object Diese Option zeigt die Standardkonfiguration für Container an, die von diesem Image gestartet werden. Weitere Informationen finden Sie im Abschnitt zu den Felddetails zu Config.
Created Zeichenfolge Diese Option zeigt den UNIX-Zeitstempel an, mit dem das Image erstellt wurde.
DockerVersion Zeichenfolge Diese Option zeigt die Version von Docker an, die zur Erstellung dieses Images verwendet wurde.
ID Zeichenfolge Diese Option zeigt den eindeutigen Bezeichner für ein Bild an.
Os Zeichenfolge Diese Option zeigt die Betriebssystemfamilie an, die für die Erstellung dieses Abbilds verwendet wurde und die für die Ausführung des Abbilds erforderlich ist.
OsVersion Zeichenfolge Diese Option zeigt die Version des Betriebssystems an, die zur Erstellung dieses Abbilds verwendet wurde.
Parent Zeichenfolge Diese Option zeigt die ID des übergeordneten Bildes an, das zur Erstellung dieses Bildes verwendet wurde.
RootFS Object Diese Option zeigt die Metadaten an, die das Root-Dateisystem für das Image beschreiben. Weitere Informationen finden Sie im Abschnitt zu den Felddetails zu RootFS.
Size Ganzzahl (64-Bit) Diese Option zeigt die Größe des Bildes in Bytes an.
VirtualSize Ganzzahl (64-Bit) Diese Option zeigt die Summe der Größen der einzelnen Ebenen im Bild in Bytes an.

Felddetails zu Config

Verfügbare Felder und Datentypen in Config
Feld Typ Beschreibung
ArgsEscaped Boolescher Wert Windows Diese Option zeigt "true" an, wenn der Befehl mit Escapezeichen versehen ist (Windows®-spezifisch).
AttachStderr Boolescher Wert Diese Option zeigt true an, wenn der Standardfehlerstrom an den Container angeschlossen ist, und false, wenn nicht.
AttachStdin Boolescher Wert Diese Option zeigt true an, wenn der Standardeingabestrom an den Container angeschlossen ist, und false, wenn nicht.
AttachStdout Boolescher Wert Diese Option zeigt true an, wenn der Standardausgabestrom an den Container angeschlossen ist, und false, wenn nicht.
Cmd Array von Zeichenfolgen Diese Option beschreibt die Befehle und Argumente, die beim Start eines Containers zur Ausführung übergeben werden.
Domainname Zeichenfolge Diese Option zeigt den vollständig qualifizierten Domänennamen des Containers an.
Entrypoint Array von Zeichenfolgen Diese Option beschreibt den Befehl, der beim Start des Containers ausgeführt wird.
Env Array von Zeichenfolgen Diese Option zeigt die Liste der Umgebungsvariablen in Form von Schlüssel-Werte-Paaren an.
ExposedPorts Schlüssel-Wert-Zuordnung Diese Option zeigt die Liste der offenen Ports im Format [123:,456:] an.
Healthcheck Object Diese Option beschreibt, wie Sie überprüfen können, ob der Container korrekt funktioniert. Weitere Informationen finden Sie im Abschnitt zu den Felddetails zu Healthcheck.
Hostname Zeichenfolge Mit dieser Option wird der Hostname des Containers angezeigt.
Image Zeichenfolge Diese Option zeigt den Namen des Bildes an, das vom Operator übergeben wurde.
Labels Schlüssel-Wert-Zuordnung Diese Option zeigt die Liste der Beschriftungen an, die dem Bild als Schlüssel-Wert-Paare hinzugefügt wurden.
MacAddress Zeichenfolge Diese Option zeigt die MAC-Adresse an, die dem Container zugewiesen ist.
NetworkDisabled Boolescher Wert Diese Option zeigt true an, wenn das Netzwerk für den Container deaktiviert ist, und false, wenn das Netzwerk für den Container aktiviert ist.
OnBuild Array von Zeichenfolgen Diese Option zeigt die ONBUILD Metadaten an, die in der Dockerdatei des Images definiert wurden.
OpenStdin Boolescher Wert Diese Option zeigt true an, wenn der Standardeingabestrom offen ist, und false, wenn der Standardeingabestrom geschlossen ist.
Shell Array von Zeichenfolgen Diese Option zeigt die Shell-Form von RUN, CMD, ENTRYPOINT an.
StdinOnce Boolescher Wert Diese Option zeigt true an, wenn der Standardeingabestrom geschlossen wird, nachdem der angeschlossene Client die Verbindung beendet hat, und false, wenn der Standardeingabestrom offen bleibt.
StopSignal Zeichenfolge Diese Option beschreibt das UNIX®-Stoppsignal, das gesendet werden soll, wenn der Container angehalten werden soll.
StopTimeout Integer Diese Option zeigt die Zeitspanne in Sekunden an, in der ein Container angehalten wird.
Tty Boolescher Wert Diese Option zeigt true an, wenn dem Container eine pseudo-tty zugewiesen ist, und false, wenn nicht.
User Zeichenfolge Mit dieser Option wird der Benutzer angezeigt, der Befehle innerhalb des Containers ausführt, in dem das Abbild verwendet wird.
Volumes Schlüssel-Wert-Zuordnung Diese Option zeigt die Liste der Datenträgereinhängungen an, die in einen Container eingebunden sind.
WorkingDir Zeichenfolge Diese Option zeigt das Arbeitsverzeichnis an, das sich innerhalb des Containers befindet, in dem die angegebenen Befehle ausgeführt werden.

Felddetails zu Healthcheck

Verfügbare Felder und Datentypen in der Gesundheitsprüfung
Feld Typ Beschreibung
Interval Ganzzahl (64-Bit) Diese Option zeigt die Wartezeit zwischen zwei Gesundheitsprüfungen in Nanosekunden an.
Retries Integer Diese Option zeigt die Anzahl der aufeinanderfolgenden Fehler an, die auftreten müssen, damit ein Container nicht mehr korrekt funktioniert.
Test Array von Zeichenfolgen

Diese Option zeigt an, wie der Gesundheitstest durchgeführt werden soll. Die folgenden Optionen sind verfügbar.

  • {} Statusprüfung übernehmen.
  • {"NONE"} Die Statusprüfung ist inaktiviert.
  • {"CMD", args...} Argumente direkt ausführen.
  • {"CMD-SHELL", command} Befehl mit der Standardshell des Systems ausführen.
Timeout Ganzzahl (64-Bit) Diese Option zeigt die Zeit in Nanosekunden an, die gewartet werden muss, bevor die Zustandsprüfung fehlschlägt.

Felddetails zu RootFS

Verfügbare Felder und Datentypen in RootFS
Option Typ Beschreibung
BaseLayer Zeichenfolge Mit dieser Option wird der Deskriptor für die Basisebene im Bild angezeigt.
Layers Array von Zeichenfolgen Mit dieser Option werden die Deskriptoren der einzelnen Bildebenen angezeigt.
Type Zeichenfolge Diese Option zeigt den Typ des Dateisystems an.

Beispiel Go-Formatbefehle für ibmcloud cr image-inspect

Die folgenden Codebeispiele zeigen, wie Sie die Formatierungs- und Filteroptionen verwenden können.

Beispiel 1 für ibmcloud cr image-inspect

Um anzuzeigen, wo IBM Dokumentation für ein bestimmtes IBM öffentliches Bild gehostet wird, führen Sie den folgenden Befehl ibmcloud cr image-inspect aus.

ibmcloud cr image-inspect ibm_public_image --format "{{ .ContainerConfig.Labels }}"

Die folgende Nachricht ist ein Beispiel für die Ausgabe des Befehls:

map[doc.url:/docs/images/docker_image_ibm_public_image/ibm_public_image_starter.html]

Beispiel 2 für ibmcloud cr image-inspect

Um die exponierten Ports für ein bestimmtes Image anzuzeigen, führen Sie den folgenden Befehl ibmcloud cr image-inspect aus.

ibmcloud cr image-inspect ibm_public_image --format "{{ .Config.ExposedPorts }}"

Die folgende Nachricht ist ein Beispiel für die Ausgabe des Befehls:

map[9080/tcp: 9443/tcp:]