Formattazione e filtraggio dell'output della CLI di Container Registry

È possibile formattare e filtrare l'output dell'interfaccia della riga di comando (CLI) di IBM Cloud® Container Registry per i comandi IBM Cloud Container Registry supportati.

Per impostazione predefinita, l'output della CLI viene visualizzato in un formato leggibile. Tuttavia, questa vista potrebbe limitare la tua capacità di utilizzare l'output, in particolare se il comando viene eseguito a livello di programmazione. Ad esempio, nell'output di ibmcloud cr image-list CLI si potrebbe voler ordinare il campo Size in ordine numerico, ma il comando restituisce una descrizione in stringa. Il plug-in container-registry CLI fornisce l'opzione di formato che si può usare per applicare un modello Go all'output CLI.

Puoi modificare l'output della CLI applicando l'opzione formato in due modi diversi:

  • Formattare i dati nell'output della CLI. Ad esempio, modificare l'output del campo Created dall'ora UNIX® all'ora standard.
  • Filtrare i dati nell'output della CLI. Ad esempio, filtrare in base ai dettagli dell'immagine per visualizzare un sottoinsieme specifico di immagini utilizzando la condizione Go template if gt.

Puoi utilizzare l'opzione formato con i seguenti comandi IBM Cloud Container Registry. Fai clic su un comando per visualizzare un elenco di campi disponibili e i relativi tipi di dati.

Opzioni del modello Go per ibmcloud cr image-digests

Esaminare la tabella seguente per trovare le opzioni del modello Go e i tipi di dati disponibili per il comando ibmcloud cr image-digests per il comando.

Campi e tipi di dati disponibili nel comando Container Registry per elencare i digest delle immagini
Campo Immettere Descrizione
Created Numero intero (64 bit) Questa opzione visualizza la data di creazione dell'immagine, espressa dal numero di secondi in tempo UNIX.
Digest Stringa Questa opzione visualizza l'identificatore univoco di un'immagine.
ManifestType Stringa Questa opzione visualizza il tipo di manifesto dell'immagine.
Repository Stringa Questa opzione visualizza il repository dell'immagine.
SecurityStatus Oggetto Questa opzione visualizza lo stato di vulnerabilità dell'immagine. È possibile filtrare e formattare i seguenti valori:

  • Status string
  • IssueCount int
  • ExemptionCount int

Gli stati possibili sono descritti in Revisione di un report di vulnerabilità utilizzando la CLI.
Size Numero intero (64 bit) Questa opzione visualizza la dimensione dell'immagine in byte.
Tags Array di stringhe Questa opzione visualizza i tag dell'immagine.

Esempio di comando di formato Go per ibmcloud cr image-digests

Per visualizzare tutte le immagini non contrassegnate con i rispettivi digest, eseguire il seguente comando ibmcloud cr image-digests.

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

Il seguente messaggio è un esempio dell'output del comando

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>

Opzioni del modello Go per ibmcloud cr image-list

Esaminare la tabella seguente per trovare le opzioni del modello Go e i tipi di dati disponibili per il comando ibmcloud cr image-list per il comando.

Campi e tipi di dati disponibili nel comando Container Registry per elencare le immagini
Campo Immettere Descrizione
Created Numero intero (64 bit) Questa opzione visualizza la data di creazione dell'immagine, espressa dal numero di secondi in tempo UNIX.
Digest Stringa Questa opzione visualizza l'identificatore univoco di un'immagine.
ManifestType Stringa Questa opzione visualizza il tipo di manifesto dell'immagine.
Namespace Stringa Questa opzione visualizza lo spazio dei nomi in cui è memorizzata l'immagine.
Repository Stringa Questa opzione visualizza il repository dell'immagine.
SecurityStatus Oggetto Questa opzione visualizza lo stato di vulnerabilità dell'immagine. È possibile filtrare e formattare i seguenti valori:

  • Status string
  • IssueCount int
  • ExemptionCount int

Gli stati possibili sono descritti in Revisione di un report di vulnerabilità utilizzando la CLI.
Size Numero intero (64 bit) Questa opzione visualizza la dimensione dell'immagine in byte.
Tag Stringa Questa opzione visualizza il tag dell'immagine.

Esempio di comando di formato Go per ibmcloud cr image-list

Per visualizzare il repository, il tag e lo stato di sicurezza di tutte le immagini taggate che superano 1 MB, eseguire il seguente comando ibmcloud cr image-list.

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

Il seguente messaggio è un esempio dell'output dal comando:

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

Se il comando di visualizzazione delle immagini va in timeout, vedi Perché va in timeout quando elenco le immagini? per assistenza.

Opzioni del modello Go per ibmcloud cr image-inspect

Esaminare la tabella seguente per trovare le opzioni del modello Go e i tipi di dati disponibili per il comando ibmcloud cr image-inspect per il comando.

Campi e tipi di dati disponibili nel comando Container Registry per ispezionare le immagini
Campo Immettere Descrizione
Architecture Stringa Questa opzione mostra l'architettura del processore che è stata usata per creare l'immagine e che è necessaria per eseguirla.
Author Stringa Questa opzione visualizza l'autore dell'immagine.
Comment Stringa Questa opzione visualizza la descrizione dell'immagine.
Config Oggetto Questa opzione visualizza i metadati di configurazione dell'immagine. Per ulteriori informazioni, vedi Dettagli del campo Config.
Container Stringa Questa opzione visualizza l'ID del contenitore che ha creato l'immagine.
ContainerConfig Oggetto Questa opzione visualizza la configurazione predefinita per i contenitori avviati da questa immagine. Per ulteriori informazioni, vedi Dettagli del campo Config.
Created Stringa Questa opzione visualizza il timestamp UNIX della creazione dell'immagine.
DockerVersion Stringa Questa opzione visualizza la versione di Docker utilizzata per creare l'immagine.
ID Stringa Questa opzione visualizza l'identificatore univoco di un'immagine.
Os Stringa Questa opzione mostra la famiglia di sistemi operativi che è stata usata per creare questa immagine e che è necessaria per eseguire l'immagine.
OsVersion Stringa Questa opzione visualizza la versione del sistema operativo utilizzata per creare l'immagine.
Parent Stringa Questa opzione visualizza l'ID dell'immagine madre che è stata usata per creare questa immagine.
RootFS Oggetto Questa opzione visualizza i metadati che descrivono il file system principale dell'immagine. Per ulteriori informazioni, vedi Dettagli del campo RootFS.
Size Numero intero (64 bit) Questa opzione visualizza la dimensione dell'immagine in byte.
VirtualSize Numero intero (64 bit) Questa opzione visualizza la somma delle dimensioni di ciascun livello dell'immagine in byte.

Config Dettagli campo

Campi e tipi di dati disponibili in Config
Campo Immettere Descrizione
ArgsEscaped Booleano Windows Questa opzione visualizza true se il comando viene evaso (specifico di Windows® ).
AttachStderr Booleano Questa opzione visualizza true se il flusso di errore standard è collegato al contenitore e false in caso contrario.
AttachStdin Booleano Questa opzione mostra true se il flusso di input standard è collegato al contenitore e false in caso contrario.
AttachStdout Booleano Questa opzione mostra true se il flusso di output standard è collegato al contenitore e false in caso contrario.
Cmd Array di stringhe Questa opzione descrive i comandi e gli argomenti che vengono passati a un contenitore per essere eseguiti quando il contenitore viene avviato.
Domainname Stringa Questa opzione visualizza il nome di dominio completamente qualificato del contenitore.
Entrypoint Array di stringhe Questa opzione descrive il comando che viene eseguito all'avvio del contenitore.
Env Array di stringhe Questa opzione visualizza l'elenco delle variabili d'ambiente sotto forma di coppie chiave-valore.
ExposedPorts Associazione chiave-valore Questa opzione visualizza l'elenco delle porte esposte nel formato [123:,456:].
Healthcheck Oggetto Questa opzione descrive come verificare il corretto funzionamento del contenitore. Per ulteriori informazioni, vedi Dettagli del campo Healthcheck.
Hostname Stringa Questa opzione visualizza il nome host del contenitore.
Image Stringa Questa opzione visualizza il nome dell'immagine passata dall'operatore.
Labels Associazione chiave-valore Questa opzione visualizza l'elenco delle etichette aggiunte all'immagine come coppie chiave-valore.
MacAddress Stringa Questa opzione visualizza l'indirizzo MAC assegnato al contenitore.
NetworkDisabled Booleano Questa opzione visualizza true se la rete è disabilitata per il contenitore e false se la rete è abilitata per il contenitore.
OnBuild Array di stringhe Questa opzione visualizza i metadati di ONBUILD definiti nel file Docker dell'immagine.
OpenStdin Booleano Questa opzione visualizza true se il flusso di input standard è aperto e false se il flusso di input standard è chiuso.
Shell Array di stringhe Questa opzione visualizza la forma a conchiglia di RUN, CMD, ENTRYPOINT.
StdinOnce Booleano Questa opzione visualizza true se il flusso di input standard viene chiuso dopo la disconnessione del client collegato e false se il flusso di input standard rimane aperto.
StopSignal Stringa Questa opzione descrive il segnale di stop UNIX® da inviare quando si vuole fermare il contenitore.
StopTimeout Numero intero Questa opzione visualizza il timeout in secondi per arrestare un contenitore.
Tty Booleano Questa opzione visualizza true se un pseudo-tty è assegnato al contenitore e false in caso contrario.
User Stringa Questa opzione visualizza l'utente che esegue i comandi all'interno del contenitore in cui viene utilizzata l'immagine.
Volumes Associazione chiave-valore Questa opzione visualizza l'elenco dei montaggi di volume montati su un contenitore.
WorkingDir Stringa Questa opzione visualizza la directory di lavoro che si trova all'interno del contenitore in cui vengono eseguiti i comandi specificati.

Healthcheck Dettagli campo

Campi e tipi di dati disponibili nell'Health check
Campo Immettere Descrizione
Interval Numero intero (64 bit) Questa opzione visualizza il tempo di attesa tra due controlli sanitari in nanosecondi.
Retries Numero intero Questa opzione visualizza il numero di guasti consecutivi che devono verificarsi per ritenere che un contenitore non funzioni correttamente.
Test Array di stringhe

Questa opzione mostra come eseguire il test di controllo dello stato di salute. Sono disponibili le seguenti opzioni.

  • {} eredita il controllo di integrità.
  • {"NONE"} il controllo di integrità è disabilitato.
  • {"CMD", args...} argomenti exec direttamente.
  • {"CMD-SHELL", command} eseguire il comando con la shell predefinita del sistema.
Timeout Numero intero (64 bit) Questa opzione visualizza il tempo di attesa, in nanosecondi, prima che il controllo sanitario fallisca.

RootFS Dettagli campo

Campi e tipi di dati disponibili in RootFS
Opzione Immettere Descrizione
BaseLayer Stringa Questa opzione visualizza il descrittore del livello base dell'immagine.
Layers Array di stringhe Questa opzione visualizza i descrittori di ciascun livello dell'immagine.
Type Stringa Questa opzione visualizza il tipo di file system.

Esempio di comandi di formato Go per ibmcloud cr image-inspect

I seguenti esempi di codice illustrano come utilizzare le opzioni di formattazione e di filtro.

Esempio 1 per ibmcloud cr image-inspect

Per visualizzare dove è ospitata la documentazione IBM per un'immagine pubblica IBM specificata, eseguire il seguente comando ibmcloud cr image-inspect.

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

Il seguente messaggio è un esempio dell'output dal comando:

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

Esempio 2 per ibmcloud cr image-inspect

Per visualizzare le porte esposte per un'immagine specifica, eseguire il seguente comando ibmcloud cr image-inspect.

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

Il seguente messaggio è un esempio dell'output dal comando:

map[9080/tcp: 9443/tcp:]