Gestione di Container Registry tramite la CLI del registro dei container

Utilizza i comandi " ibmcloud cr " nel plug-in CLI " container-registry " per gestire il tuo IBM Cloud Container Registry e le relative risorse.

Prerequisiti

Prima di poter utilizzare la CLI di Container Registry, è necessario soddisfare i seguenti prerequisiti.

  1. Installa il plugin della CLI ibmcloud, vedi Introduzione alla CLI IBM Cloud.

  2. Installa il plug-in CLI di container-registry.

    ibmcloud plugin install container-registry
    

    Per ulteriori informazioni, consultare la sezione " Installazione del plug-in CLI di container-registry ".

  3. Accedi a IBM Cloud con il comando ibmcloud login per generare un token di accessoUn valore utilizzato dal consumatore per accedere alle risorse protette per conto dell'utente, invece di utilizzare le credenziali del fornitore di servizi dell'utente. e autenticare la sessione in modo da poter eseguire i comandi nella CLI.

Note

Per saperne di più su come utilizzare la CLI di Container Registry, i comandi di ibmcloud cr, vedere Per iniziare con IBM Cloud Container Registry.

Verrà visualizzata una notifica nella riga di comando quando saranno disponibili aggiornamenti per i plug-in CLI “ ibmcloud ” e “ container-registry ”. Assicurati di mantenere aggiornate le tue interfacce CLI, in modo da poter utilizzare tutti i comandi e le opzioni disponibili. Se desideri visualizzare la versione corrente del tuo plug-in CLI di container-registry, esegui il comando ibmcloud plugin list.

Per ulteriori informazioni sulla piattaforma IAM e sui ruoli di accesso ai servizi richiesti per alcuni comandi di Container Registry, consultare la guida " Gestione dell'accesso IAM per Container Registry ".

Non inserire informazioni personali nelle immagini del contenitore, nei nomi degli spazi dei nomi, nei campi di descrizione o nei dati di configurazione dell'immagine (ad esempio, nomi o etichette dell'immagine).

Se i comandi ibmcloud cr Container Registry restituiscono un errore indicando che non sono comandi registrati, consulta Perché i comandi Container Registry(ibmcloud cr)restituiscono un errore indicando che non sono registrati? per assistenza. Se i comandi non funzionano e viene visualizzato un messaggio che indica che non hai effettuato l'accesso, consulta Perché non riesco ad accedere a Container Registry? per assistenza.

ibmcloud cr api

Questo comando restituisce i dettagli relativi all'endpoint dell'API del Registro di sistema su cui vengono eseguiti i comandi.

ibmcloud cr api

Esempi

Trova i dettagli per l'endpoint API del registro.

ibmcloud cr api

Output

Il comando nell'esempio restituisce il seguente output:

Registry API endpoint   https://us.icr.io/api
OK

ibmcloud cr exemption-add

Creare un'esenzione per un problema di sicurezza. Puoi creare un'esenzione per un problema di sicurezza che si applica ad ambiti differenti. L'ambito può essere l'account, namespace, repository, digest o tag.

È possibile identificare le immagini nell'ambito utilizzando sia il tag che il digest. È possibile fare riferimento all'immagine per digest <dns>/<namespace>/<repo>@<digest>, che influenza il digest e tutte le relative tag nello stesso repository o per tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag. Per elencare tutte le immagini, incluse le immagini senza tag, eseguire il comando ibmcloud cr image-digests.

ibmcloud cr exemption-add --scope SCOPE --issue-type ISSUE_TYPE --issue-id ISSUE_ID [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--scope SCOPE

Per impostare il tuo account come ambito, utilizza "*" come valore.

Per impostare uno spazio dei nomi, un repository, un digest o un tag come ambito, inserire il valore in uno dei seguenti formati:

  • namespace
  • namespace/repository
  • namespace/repository:tag
  • namespace/repository@digest
--issue-type ISSUE_TYPE

Il tipo di problema di sicurezza che desideri esentare. Per trovare i tipi di problema validi, esegui ibmcloud cr exemption-types.

--issue-id ISSUE_ID

L'ID del problema di sicurezza che desideri esentare. Per trovare l'ID di un problema, esegui il comando ibmcloud cr va <image>, dove <image> è il nome della tua immagine, e utilizza il valore corrispondente dalla colonna "ID vulnerabilità ".

--output json, -o json

(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Creare un'esenzione CVE per la CVE con ID CVE-2018-17929 per tutte le immagini nel repository us.icr.io/birds/bluebird inserendo us.icr.io/birds/bluebird per l'ambito, cve per il tipo di problema e CVE-2018-17929 per l'ID del problema.

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Creare un'esenzione CVE a livello di account per la CVE con ID CVE-2018-17929 inserendo "*" per l'ambito, cve per il tipo di problema e CVE-2018-17929 per l'ID del problema.

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

Esempio 1

Creare un'esenzione CVE per la CVE con ID CVE-2018-17929 per tutte le immagini nel repository us.icr.io/birds/bluebird inserendo us.icr.io/birds/bluebird per l'ambito, cve per il tipo di problema e CVE-2018-17929 per l'ID del problema.

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Risultato per esempio 1

Il comando nell'esempio 1 restituisce il seguente output:

Creating exemption for 'CVE-2018-17929' in 'us.icr.io/birds/bluebird'...
OK

Esempio 2

Creare un'esenzione CVE a livello di account per la CVE con ID CVE-2018-17929 inserendo "*" per l'ambito, cve per il tipo di problema e CVE-2018-17929 per l'ID del problema.

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

Risultato per esempio 2

Il comando nell'esempio 2 restituisce il seguente output:

Creating exemption for 'CVE-2018-17929' in '*'...
OK

ibmcloud cr exemption-list (ibmcloud cr exemptions)

Alias: exemptions

Elencare le esenzioni per i problemi di sicurezza.

Puoi identificare le immagini nell'ambito utilizzando la tag o il digest. È possibile fare riferimento all'immagine per digest <dns>/<namespace>/<repo>@<digest>, che influenza il digest e tutte le relative tag nello stesso repository o per tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag. Per elencare tutte le immagini, incluse le immagini senza tag, eseguire il comando ibmcloud cr image-digests.

ibmcloud cr exemption-list [--scope SCOPE] [--output json | -o json]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--scope SCOPE

(Facoltativo) Elenca solo le esenzioni che si applicano a questo ambito.

Per impostare uno spazio dei nomi, un repository, un digest o un tag come ambito, inserire il valore in uno dei seguenti formati:

  • namespace
  • namespace/repository
  • namespace/repository:tag
  • namespace/repository@digest
--output json, -o json

(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Elencare tutte le esenzioni per problemi di sicurezza che si applicano alle immagini nel repository birds/bluebird inserendo birds/bluebird come ambito.

L'output include esenzioni valide a livello di account, esenzioni limitate allo spazio dei nomi birds ed esenzioni limitate al repository birds/bluebird. Il risultato non include alcuna eccezione relativa a tag specifici all'interno del repository birds/bluebird.

ibmcloud cr exemption-list --scope birds/bluebird

Elencate tutte le vostre esenzioni per problemi di sicurezza che si applicano alle immagini nel digest di birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 inserendo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 come ambito.

L'output include esenzioni valide a livello di account, esenzioni limitate allo spazio dei nomi birds ed esenzioni limitate al repository birds/bluebird e al digest birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010. L'output non include alcuna esenzione che si trova nell'ambito di tag specifici all'interno del repository birds/bluebird.

ibmcloud cr exemption-list --scope birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010

Esempio 1

Elencare tutte le esenzioni per problemi di sicurezza che si applicano alle immagini nel repository birds/bluebird inserendo birds/bluebird come ambito.

ibmcloud cr exemption-list --scope birds/bluebird

Risultato per esempio 1

L'output include esenzioni valide a livello di account, esenzioni limitate allo spazio dei nomi birds ed esenzioni limitate al repository birds/bluebird. Il risultato non include alcuna eccezione relativa a tag specifici all'interno del repository birds/bluebird.

Il comando nell'esempio 1 restituisce il seguente output:

Listing exemptions for scope 'birds/bluebird'...
Scope              Issue type   Issue ID
*                  cve          CVE-2018-17929
birds              cve          CVE-2018-17929
birds/bluebird     cve          CVE-2018-17929
OK

Esempio 2

Elencate tutte le vostre esenzioni per problemi di sicurezza che si applicano alle immagini nel digest di birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 inserendo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 come ambito.

ibmcloud cr exemption-list --scope birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010

Risultato per esempio 2

L'output include esenzioni valide a livello di account, esenzioni limitate allo spazio dei nomi birds ed esenzioni limitate al repository birds/bluebird e al digest birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010. L'output non include alcuna esenzione che si trova nell'ambito di tag specifici all'interno del repository birds/bluebird.

Il comando nell'esempio 2 restituisce il seguente output:

Listing exemptions for scope 'birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010'...
Scope                                       Issue type   Issue ID
*                                           cve          CVE-2018-17929
birds                                       cve          CVE-2018-17929
birds/bluebird                              cve          CVE-2018-17929
birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010          cve          CVE-2018-17929
OK

ibmcloud cr exemption-rm

Elimina un'esenzione per un problema di sicurezza. Per visualizzare le tue esenzioni esistenti, esegui ibmcloud cr exemption-list.

Puoi identificare le immagini nell'ambito utilizzando la tag o il digest. È possibile fare riferimento all'immagine per digest <dns>/<namespace>/<repo>@<digest>, che influenza il digest e tutte le relative tag nello stesso repository o per tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag. Per elencare tutte le immagini, incluse le immagini senza tag, eseguire il comando ibmcloud cr image-digests.

ibmcloud cr exemption-rm --scope SCOPE --issue-type ISSUE_TYPE --issue-id ISSUE_ID [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--scope SCOPE

Per impostare il tuo account come ambito, utilizza "*" come valore.

Per impostare uno spazio dei nomi, un repository, un digest o un tag come ambito, inserire il valore in uno dei seguenti formati:

  • namespace
  • namespace/repository
  • namespace/repository:tag
  • namespace/repository@digest
--issue-type ISSUE_TYPE

Il tipo di emissione per cui si richiede l'esenzione relativa all'emissione di titoli che si desidera eliminare. Per individuare i tipi di problema relativi alle tue esenzioni, esegui il comando ibmcloud cr exemption-list.

--issue-id ISSUE_ID

L'ID dell'esenzione per il problema di sicurezza che vuoi rimuovere. Per trovare gli ID sicurezza per le tue esenzioni, esegui ibmcloud cr exemption-list.

--output json, -o json

(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Eliminare un'esenzione CVE per la CVE con ID CVE-2018-17929 per tutte le immagini nel repository us.icr.io/birds/bluebird inserendo us.icr.io/birds/bluebird come ambito, cve come tipo di problema e CVE-2018-17929 come ID del problema.

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Eliminare un'esenzione CVE a livello di account per la CVE con ID CVE-2018-17929 inserendo "*" come ambito, cve come tipo di problema e CVE-2018-17929 come ID del problema.

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

Esempio 1

Eliminare un'esenzione CVE per la CVE con ID CVE-2018-17929 per tutte le immagini nel repository us.icr.io/birds/bluebird inserendo us.icr.io/birds/bluebird come ambito, cve come tipo di problema e CVE-2018-17929 come ID del problema.

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

Risultato per esempio 1

Il comando nell'esempio 1 restituisce il seguente output:

Deleting exemption for 'CVE-2018-17929' in 'us.icr.io/birds/bluebird'...
OK

Esempio 2

Eliminare un'esenzione CVE a livello di account per la CVE con ID CVE-2018-17929 inserendo "*" come ambito, cve come tipo di problema e CVE-2018-17929 come ID del problema.

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

Risultato per esempio 2

Il comando nell'esempio 2 restituisce il seguente output:

Deleting exemption for 'CVE-2018-17929' in '*'...
OK

ibmcloud cr exemption-types

Elenca i tipi di problemi di sicurezza che puoi esentare.

ibmcloud cr exemption-types [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Elenca i tipi di problemi di sicurezza.

ibmcloud cr exemption-types

Output

Il comando nell'esempio restituisce il seguente output:

Listing exemption types...
Issue type      Description
cve             CVE
sn              Security Notice
configuration   Configuration Issue
OK

ibmcloud cr iam-policies-enable

Abilita le politiche di accesso IAM per IBM Cloud Container Registry, consentendo un'autorizzazione dettagliata quando si utilizza l'autenticazione IAM. Per ulteriori informazioni, vedi Gestione dell'accesso IAM per Container Registry e Definizione delle politiche di accesso IAM.

Tutti gli account richiedono criteri di accesso IAM.

ibmcloud cr iam-policies-enable

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Esempi

Utilizzare i criteri IAM per consentire un'autorizzazione a grana fine.

ibmcloud cr iam-policies-enable

Output

Il comando nell'esempio restituisce il seguente output:

Enabling IAM policies for account 'X's Account' in registry 'us.icr.io'...
OK

ibmcloud cr iam-policies-status

Questo comando mostra lo stato della politica di accesso IAM dell'account IBM Cloud Container Registry specificato. Per ulteriori informazioni, vedi Gestione dell'accesso IAM per Container Registry e Definizione delle politiche di accesso IAM.

Tutti gli account richiedono politiche di accesso IAM ( IBM Cloud® Identity and Access Management ).

ibmcloud cr iam-policies-status

Esempi

Mostra lo stato del criterio di accesso IAM per l'account.

ibmcloud cr iam-policies-status

Output

Il comando nell'esempio restituisce il seguente output:

IAM policy enforcement is enabled for account 'X's Account' in registry 'us.icr.io'.
OK

ibmcloud cr image-digests (ibmcloud cr digests)

Alias: digests

Elenca tutte le immagini, incluse quelle non contrassegnate con tag, nel tuo account IBM Cloud. Questo comando restituisce il digest nel formato esteso. Quando si utilizza il digest per identificare un'immagine, utilizzare sempre il formato lungo.

Se vuoi elencare solo le immagini contrassegnate con tag, esegui il comando ibmcloud cr image-list.

È possibile fare riferimento a un'immagine utilizzando una combinazione della colonna Repository (repository) e della colonna Digest (digest) separate da un simbolo chiodato (@) per creare il nome immagine nel formato repository@digest. È inoltre possibile fare riferimento al nome immagine utilizzando una combinazione del contenuto della colonna Repository (repository) e una delle tag nella colonna Tag (tag) separate da due punti (:) per creare il nome immagine nel formato repository:tag.

ibmcloud cr image-digests [--format FORMAT | --quiet | -q | --output json | -o json] [--restrict RESTRICTION] [--include-ibm] [--no-va] [--va]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--format FORMAT
(Facoltativo) Formatta gli elementi di output utilizzando un template Go. Per ulteriori informazioni, vedi Formattazione e filtro dell'output della CLI Container Registry.
--quiet, -q
(Facoltativo) Ogni immagine viene elencata nel formato: repository@digest
--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.
--restrict RESTRICTION
(Facoltativo) Limita l'output per visualizzare solo le immagini nel repository o nello spazio dei nomi specificato.
--include-ibm
(Facoltativo) Include le immagini pubbliche fornite da IBM nell'output. Vengono elencate solo le immagini private per impostazione predefinita. Puoi visualizzare le immagini fornite da IBM solo nel registro globale.
--no-va
(Facoltativo) Esclude i risultati dello stato di sicurezza del Vulnerability Advisor dall'output. Se non hai bisogno dei risultati dello stato di sicurezza come parte del tuo output ibmcloud cr image-digests, puoi utilizzare questa opzione per aumentare le prestazioni.
--va
(Facoltativo) Include i risultati dello stato di sicurezza dell' Vulnerability Advisor e nell'output. È possibile utilizzare --va l'opzione insieme --restrict all'opzione per ricevere solo le informazioni necessarie.

Esempio

Visualizza tutte le immagini nello spazio dei nomi birds, comprese quelle non contrassegnate, nel formato repository@digest utilizzando --quiet per elencare le immagini nel formato repository@digest e inserendo birds come restrizione.

ibmcloud cr image-digests --restrict birds --quiet

Output

Il comando nell'esempio restituisce il seguente output:

us.icr.io/birds/bluebird@sha256:11ab001ab10011cd1000101cd0101010001ab111100cd00ab1119f3de21ba0cd
us.icr.io/birds/blackbird@sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0

ibmcloud cr image-inspect

Visualizza i dettagli su una specifica immagine. Puoi fare riferimento all'immagine che vuoi ispezionare tramite digest repository@digest o tramite tag repository:tag.

ibmcloud cr image-inspect [--format FORMAT] IMAGE [IMAGE...]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine per cui vuoi ottenere un report. Puoi analizzare più immagini elencando ogni immagine nel comando con uno spazio tra ciascun nome.

È possibile identificare le immagini utilizzando il digest <dns>/<namespace>/<repo>@<digest> oppure il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.

Per trovare i nomi delle tue immagini, esegui uno dei seguenti comandi:

  • Per identificare la tua immagine tramite digest, esegui il comando ibmcloud cr image-digests. Combinare il contenuto della colonna Repository (repository) e della colonna Digest (digest) separati da un simbolo di chioccia (@) per creare il nome dell'immagine nel formato repository@digest.
  • Per identificare la tua immagine tramite tag, esegui il comando ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag. Se nel nome immagine non è specificata una tag, viene eliminata per impostazione predefinita l'immagine contrassegnata con latest.

Opzioni comando

--format FORMAT
(Facoltativo) Formatta gli elementi di output utilizzando un template Go. Per ulteriori informazioni, vedi Formattazione e filtro dell'output della CLI Container Registry.

Esempi

Visualizzare i dettagli sulle porte esposte per l'immagine us.icr.io/birds/bluebird:1 utilizzando la direttiva di formattazione "{{ .Config.ExposedPorts }}" e inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr image-inspect  --format "{{ .Config.ExposedPorts }}" us.icr.io/birds/bluebird:1

Output

Il comando nell'esempio restituisce il seguente output:

Inspecting 'us.icr.io/birds/bluebird:1'...
map[8080/tcp:{}]
OK

ibmcloud cr image-list (ibmcloud cr images)

Alias: images

Visualizza tutte le immagini contrassegnate con tag nel tuo account IBM Cloud. Se vuoi elencare tutte le tue immagini, incluse quelle non contrassegnate con tag, esegui il comando ibmcloud cr image-digests. Per impostazione predefinita, il comando ibmcloud cr image-list restituisce il digest per le immagini in un formato troncato. Il comando ibmcloud cr image-digests restituisce il formato esteso del digest.

Quando si utilizza il digest per identificare un'immagine, utilizzare sempre il formato lungo.

Il nome dell'immagine è dato dalla combinazione dei contenuti delle colonne " Repository " e "Tag " nel formato: repository:tag

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

ibmcloud cr image-list [--format FORMAT] [--quiet | -q ] [--restrict RESTRICTION] [--include-ibm] [--no-trunc] [--show-type] [--no-va] [--va] [--output json | -o json]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--format FORMAT
(Facoltativo) Formatta gli elementi di output utilizzando un template Go. Per ulteriori informazioni, vedi Formattazione e filtro dell'output della CLI Container Registry.
--quiet, -q
(Facoltativo) Ogni immagine viene elencata nel formato: repository:tag
--restrict RESTRICTION
(Facoltativo) Limita l'output per visualizzare solo le immagini nel repository o nello spazio dei nomi specificato.
--include-ibm
(Facoltativo) Include le immagini pubbliche fornite da IBM nell'output. Vengono elencate solo le immagini private per impostazione predefinita. Puoi visualizzare le immagini fornite da IBM solo nel registro globale.
--no-trunc
(Facoltativo) Restituisce il digest dell'immagine nel suo formato lungo.
--show-type
(Facoltativo) Visualizza il tipo di manifest dell'immagine.
--no-va
(Facoltativo) Esclude i risultati dello stato di sicurezza del Vulnerability Advisor dall'output. Se non hai bisogno dei risultati dello stato di sicurezza come parte del tuo output ibmcloud cr image-list, puoi utilizzare questa opzione per aumentare le prestazioni.
--va
(Facoltativo) Include i risultati dello stato di sicurezza dell' Vulnerability Advisor e nell'output. È possibile utilizzare --va l'opzione insieme --restrict all'opzione per ricevere solo le informazioni necessarie.
--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempio

Visualizzare le immagini nello spazio dei nomi birds nel formato repository:tag, senza troncare i digest delle immagini utilizzando --quiet per visualizzare l'immagine nel formato repository:tag, --no-trunc per visualizzare il digest dell'immagine nel formato lungo e inserendo birds come restrizione.

ibmcloud cr image-list --restrict birds --quiet --no-trunc

Output

Il comando nell'esempio restituisce il seguente output:

us.icr.io/birds/bluebird:1

ibmcloud cr image-prune-untagged

Elimina tutte le immagini non contrassegnate con tag nel tuo account IBM Cloud Container Registry.

È possibile visualizzare tutte le immagini etichettate e non etichettate eseguendo il comando ibmcloud cr image-digests il comando. Se si desidera visualizzare solo le immagini non contrassegnate, è possibile eseguire il comando ibmcloud cr image-digests con la formattazione in linguaggio Go, vedere Esempio di comando Go format per ibmcloud cr image-digests. È quindi possibile verificare se si desidera rimuovere queste immagini non contrassegnate prima di eseguire il comando ibmcloud cr image-prune-untagged.

ibmcloud cr image-prune-untagged [--force | -f] [--output | -o [json]] [--restrict RESTRICTION]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--force, -f
(Facoltativo) Forza l'esecuzione del comando senza alcun prompt utente.
--output json, -o json
(Facoltativo) Emette un JSON che contiene i risultati della ripulitura delle tue immagini non contrassegnate con tag. Questa opzione deve essere utilizzata con --force.
--restrict
(Facoltativo) Limita l'eliminazione solo alle immagini non contrassegnate con tag nel repository o nello spazio dei nomi specificato.

Esempi

Eliminare tutte le immagini non contrassegnate che si trovano nello spazio dei nomi birds senza alcuna richiesta da parte dell'utente e produrre i risultati in formato JSON utilizzando l'opzione --force per forzare l'esecuzione del comando senza richieste da parte dell'utente e inserendo --json come output e birds come restrizione.

ibmcloud cr image-prune-untagged [--force | -f [--json]] --restrict birds

Output

Il comando nell'esempio restituisce il seguente output:

Deleting untagged images in namespace 'birds'...
[
  {
    "Digest": "us.icr.io/birds/blackbird@sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0",
    "Status": "OK"
  }
]
OK

ibmcloud cr image-restore

Ripristina un'immagine eliminata dal cestino. Puoi scegliere di eseguire il ripristino per tag o per digest. Se si esegue il ripristino tramite digest, vengono ripristinati il digest e tutti i relativi tag presenti nello stesso repository. Per scoprire cosa c'è nel cestino, esegui il comando ibmcloud cr trash-list.

Se ricevi un errore quando stai ripristinando un'immagine che indica che l'immagine contrassegnata esiste, vedi Perché ricevo un errore quando sto ripristinando un'immagine? per assistenza.

Se stai ripristinando un'immagine per digest, ma alcune tag non vengono ripristinate, vedi Perché non vengono ripristinate tutte le tag quando eseguo il ripristino per digest? per assistenza.

ibmcloud cr image-restore IMAGE

Per ulteriori informazioni su come utilizzare il comando ibmcloud cr image-restore, vedi Ripristino delle immagini.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine che vuoi ripristinare dal cestino.

Per trovare i nomi delle immagini nel cestino, eseguire il comando ibmcloud cr trash-list.

Puoi identificare le immagini utilizzando la tag o il digest. È possibile fare riferimento all'immagine da ripristinare tramite il digest <dns>/<namespace>/<repo>@<digest>, che ripristina il digest e tutti i relativi tag nello stesso repository, oppure tramite il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.

Le immagini vengono archiviate nel cestino per 30 giorni.

Esempi

Ripristinare l'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr image-restore us.icr.io/birds/bluebird:1

Output

Il comando nell'esempio restituisce il seguente output:

Restoring image 'us.icr.io/birds/bluebird:1'...
Successfully restored image 'us.icr.io/birds/bluebird:1'.
OK

ibmcloud cr image-rm

Elimina una o più immagini specificate da Container Registry. Puoi fare riferimento all'immagine che vuoi eliminare tramite digest repository@digest o tramite tag repository:tag.

Dove sono presenti più tag per lo stesso digest immagine all'interno di un repository, il comando ibmcloud cr image-rm rimuove l'immagine sottostante e tutte le relative tag. Se la stessa immagine è presente in un altro repository o namespace, quella copia dell'immagine non viene rimossa. Se vuoi rimuovere un tag da un'immagine assicurandoti che l'immagine sottostante e gli altri tag rimangano al loro posto, usa il ibmcloud cr image-untag comando.

Se vuoi ripristinare un'immagine eliminata, puoi elencare il contenuto del cestino eseguendo il comando ibmcloud cr trash-list e ripristinare un'immagine selezionata eseguendo il comando ibmcloud cr image-restore.

ibmcloud cr image-rm IMAGE [IMAGE...]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine che desideri eliminare. Puoi eliminare più immagini contemporaneamente elencando ogni immagine nel comando con uno spazio tra ciascun nome. È possibile identificare le immagini utilizzando il digest <dns>/<namespace>/<repo>@<digest> oppure il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.

Le immagini vengono archiviate nel cestino per 30 giorni.

Per trovare i nomi delle tue immagini, esegui uno dei seguenti comandi:

  • Per identificare la tua immagine tramite digest, esegui il comando ibmcloud cr image-digests. Combinare il contenuto della colonna Repository (repository) e della colonna Digest (digest) separati da un simbolo di chioccia (@) per creare il nome dell'immagine nel formato repository@digest.
  • Per identificare la tua immagine tramite tag, esegui il comando ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag. Se nel nome immagine non è specificata una tag, viene eliminata per impostazione predefinita l'immagine contrassegnata con latest.

Esempi

Eliminare l'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr image-rm us.icr.io/birds/bluebird:1

Output

Il comando nell'esempio restituisce il seguente output:

Deleting image 'us.icr.io/birds/bluebird:1'...
Successfully deleted image 'us.icr.io/birds/bluebird:1'.
OK

ibmcloud cr image-tag

Aggiungi un tag specificato nel comando a un'immagine esistente, copia il tag in un altro repository oppure copia il tag in un repository in uno spazio dei nomi diverso. Quando copi una tag, vengono copiate anche tutte le firme Red Hat® per il suo digest. L'immagine di destinazione TARGET_IMAGE è la nuova immagine, mentre l'immagine di origine SOURCE_IMAGE è quella già presente su IBM Cloud Container Registry. Le immagini di origine e di destinazione devono essere nella stessa regione. È possibile fare riferimento all'immagine originale che si desidera taggare utilizzando il digest repository@digest oppure il tag repository:tag. Devi fare riferimento all'immagine di destinazione tramite tag.

È possibile identificare le immagini di origine utilizzando il digest <dns>/<namespace>/<repo>@<digest> oppure il tag <dns>/<namespace>/<repo>:<tag>. È necessario fare riferimento all'immagine di destinazione tramite il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.

Per trovare i nomi delle tue immagini, utilizza una delle seguenti opzioni:

  • Per identificare la tua immagine tramite digest, esegui il comando ibmcloud cr image-digests. Combinare il contenuto della colonna Repository (repository) e della colonna Digest (digest) separati da un simbolo di chioccia (@) per creare il nome dell'immagine nel formato repository@digest.
  • Per identificare la tua immagine tramite tag, esegui il comando ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag.

Se ricevi un errore manifesto quando tenti di contrassegnare la tua immagine, i seguenti argomenti potrebbero essere di aiuto:

ibmcloud cr image-tag [SOURCE_IMAGE] [TARGET_IMAGE]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

SOURCE_IMAGE
Il nome dell'immagine di origine. È possibile identificare le immagini di origine utilizzando il digest <dns>/<namespace>/<repo>@<digest> oppure il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.
TARGET_IMAGE
Il nome dell'immagine di destinazione. TARGET_IMAGE deve essere nel formato repository:tag, ad esempio us.icr.io/namespace/image:latest.

Esempi

Aggiungere un altro tag di riferimento latest, all'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine di origine e us.icr.io/birds/bluebird:latest come immagine di destinazione.

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

Copiare l'immagine us.icr.io/birds/bluebird:peck in un altro repository nello stesso spazio dei nomi birds/pigeon inserendo us.icr.io/birds/bluebird:peck come immagine di origine e us.icr.io/birds/pigeon:peck come immagine di destinazione.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

Copiare l'immagine us.icr.io/birds/bluebird:peck in un altro spazio dei nomi a cui si ha accesso, in questo esempio lo spazio dei nomi animals, inserendo us.icr.io/birds/bluebird:peck come immagine sorgente e us.icr.io/animals/dog:bark come immagine di destinazione.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

Esempio 1

Aggiungere un altro tag di riferimento latest, all'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine di origine e us.icr.io/birds/bluebird:latest come immagine di destinazione.

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

Risultato per esempio 1

Il comando nell'esempio 1 restituisce il seguente output:

Tagging 'us.icr.io/birds/bluebird:1' to 'us.icr.io/birds/bluebird:latest'...
OK

Esempio 2

Copiare l'immagine us.icr.io/birds/bluebird:peck in un altro repository nello stesso spazio dei nomi birds/pigeon inserendo us.icr.io/birds/bluebird:peck come immagine di origine e us.icr.io/birds/pigeon:peck come immagine di destinazione.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

Risultato per esempio 2

Il comando nell'esempio 2 restituisce il seguente output:

Tagging 'us.icr.io/birds/bluebird:peck' to 'us.icr.io/birds/pigeon:peck'...
OK

Esempio 3

Copiare l'immagine us.icr.io/birds/bluebird:peck in un altro spazio dei nomi a cui si ha accesso, in questo esempio lo spazio dei nomi animals, inserendo us.icr.io/birds/bluebird:peck come immagine sorgente e us.icr.io/animals/dog:bark come immagine di destinazione.

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

Risultato dell'esempio 3

Il comando dell'esempio 3 restituisce il seguente risultato:

Tagging 'us.icr.io/birds/bluebird:peck' to 'us.icr.io/animals/dog:bark'...
OK

ibmcloud cr image-untag

Rimuovi una o più tag tag da ogni immagine specificata in IBM Cloud Container Registry.

Per rimuovere un tag specifico da un'immagine e assicurarsi che l'immagine sottostante e gli altri tag rimangano al loro posto, utilizzare il comando ibmcloud cr image-untag . Se si desidera eliminare l'immagine sottostante e tutte le relative tag, utilizzare il comando ibmcloud cr image-rm.

ibmcloud cr image-untag IMAGE [IMAGE...]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine per cui vuoi rimuovere la tag. Puoi eliminare il tag da più immagini contemporaneamente elencando ogni immagine nel comando con uno spazio tra ogni nome. IMAGE deve essere nel formato repository:tag, ad esempio us.icr.io/namespace/image:latest.

Per trovare i nomi delle tue immagini, esegui ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag. Se nel nome immagine non è specificata alcuna tag, il comando ha esito negativo.

Esempi

Rimuovere il tag 1 dall'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr image-untag us.icr.io/birds/bluebird:1

Output

Il comando nell'esempio restituisce il seguente output:

Removing tag for image 'us.icr.io/birds/bluebird:1'...
Successfully removed tag '1' from image 'us.icr.io/birds/bluebird:1'.
OK

ibmcloud cr info

Visualizza il nome e l'account del registro a cui sei collegato.

ibmcloud cr info [--verbose]

Opzioni comando

--verbose
(Facoltativo) Visualizza ulteriori informazioni sull'ambiente del Registro di sistema.

Esempi

Trovare il nome e l'account del registro.

ibmcloud cr info

Output

Il comando nell'esempio restituisce il seguente output:

Plugin version                    1.3.16
Container Registry                us.icr.io
Container Registry API endpoint   https://us.icr.io/api
IBM Cloud API endpoint            https://cloud.ibm.com
IBM Cloud account details         X's Account (1100110011001100)
OK

ibmcloud cr login

Registra il client Docker o Podman locale in IBM Cloud Container Registry.

Questo comando è richiesto se si desidera eseguire i comandi push o pull per il registro. Se vuoi eseguire altri comandi ibmcloud cr, non ti è richiesto di accedere a Container Registry.

ibmcloud cr login [--client CLIENT]

Container Registry supporta altri client oltre a Docker e Podman. Per accedere utilizzando altri client, vedi Accesso interattivo ai tuoi spazi dei nomi.

Se riscontri problemi durante il login, consulta Perché non riesco ad accedere a Container Registry? per assistenza. macOS Se utilizzi un Mac e riscontri problemi durante il login, consultaPerché il login a Docker sul mio Mac non funziona? per assistenza.

L'accesso a Container Registry utilizzando il ibmcloud cr login comando è soggetto ai limiti di sessione di accesso IAM. Se il tuo login scade, consulta Perché il login all' Container Registry continua a scadere? per assistenza.

Opzioni comando

--client CLIENT
(Facoltativo) Selezionare il client a cui si desidera accedere. I valori validi sono docker e podman. Se questa opzione non viene utilizzata e Docker è installato, il valore predefinito è docker; se Docker non è installato, il valore predefinito è podman.

Esempi

Per accedere al registro utilizzando Podman, immettere podman come client.

ibmcloud cr login --client podman

Output

Il comando nell'esempio restituisce il seguente output:

Logging 'podman' in to 'us.icr.io'...
Logged in to 'us.icr.io'.
OK

ibmcloud cr manifest-inspect

Visualizza il contenuto di manifest per un'immagine. Puoi fare riferimento all'immagine che vuoi ispezionare tramite digest repository@digest o tramite tag repository:tag.

ibmcloud cr manifest-inspect [--quiet] IMAGE

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine per cui vuoi ispezionare il manifest. È possibile identificare le immagini utilizzando il digest <dns>/<namespace>/<repo>@<digest> oppure il tag <dns>/<namespace>/<repo>:<tag>. Dove <dns> è il nome di dominio, <namespace> è lo spazio dei nomi, <repo> è il repository, <digest> è il digest e <tag> è il tag.

Per trovare i nomi delle tue immagini, esegui uno dei seguenti comandi:

  • Per identificare la tua immagine tramite digest, esegui il comando ibmcloud cr image-digests. Combinare il contenuto della colonna Repository (repository) e della colonna Digest (digest) separati da un simbolo di chioccia (@) per creare il nome dell'immagine nel formato repository@digest.
  • Per identificare la tua immagine tramite tag, esegui il comando ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag.

Opzioni comando

--quiet, -q
(Facoltativo) Riduce l'output per visualizzare solo gli elementi essenziali.

Esempi

Visualizzare il contenuto del manifesto dell'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr manifest-inspect us.icr.io/birds/bluebird:1

Output

Il comando nell'esempio restituisce il seguente output:

{
   "schemaVersion": 2,
   "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
   "config": {
      "mediaType": "application/vnd.docker.container.image.v1+json",
      "size": 1470,
      "digest": "sha256:11ab001ab10011cd1000101cd0101010001ab111100cd00ab1119f3de21ba0cd"
   },
   "layers": [
      {
         "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
         "size": 2479088,
         "digest": "sha256:22ef00ef002220002ab200222000ab00ef2222000ab00222ef1100cd003399f0"
      }
   ]
}

ibmcloud cr namespace-add

Scegli un nome per il tuo spazio dei nomiUna raccolta di repository che memorizzano le immagini in un registro. Uno spazio dei nomi è associato a un account IBM Cloud , che può includere più spazi dei nomi. e aggiungili al tuo account IBM Cloud.

Puoi creare uno spazio dei nomi in un gruppo di risorseL'ambiente e i vincoli che vengono rispettati delle istanze della risorsa contenute. Un utente può essere associato a un gruppo di risorse per abilitare la collaborazione. a tua scelta utilizzando una delle seguenti opzioni.

  • Prima di creare lo spazio dei nomi, esegui il comando ibmcloud target -g RESOURCE_GROUP, dove RESOURCE_GROUP è il gruppo di risorse.
  • Specificare il gruppo di risorse richiesto utilizzando l'opzione -g sul comando ibmcloud cr namespace-add.

Se si crea uno spazio dei nomi in un gruppo di risorse, è possibile configurare l'accesso alle risorse all'interno dello spazio dei nomi al livello gruppo di risorse. Tuttavia, puoi ancora impostare le autorizzazioni per lo spazio dei nomi a livello di account o nello spazio dei nomi stesso. Se non si specifica un gruppo di risorse e non viene indicato alcun gruppo di risorse come destinazione, viene utilizzato il gruppo di risorse predefinito.

Se hai un vecchio spazio dei nomi che non si trova in un gruppo di risorse, puoi assegnarlo a un gruppo di risorse, vedi ibmcloud cr namespace-assign.

Gli spazi dei nomi assegnati a un gruppo di risorse vengono mostrati nella pagina Elenco risorse della console IBM Cloud.

ibmcloud cr namespace-add [-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)] NAMESPACE

Per ulteriori informazioni sui gruppi di risorse, vedi Creazione di un gruppo di risorse.

Se hai un problema quando provi ad aggiungere uno spazio dei nomi, vedi Perché non posso aggiungere uno spazio dei nomi? per assistenza.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di gestione della piattaforma " e " Ruoli di accesso" per la configurazione di Container Registry.

Argomenti comando

NAMESPACE

Lo spazio dei nomi che desideri aggiungere. Lo spazio dei nomi deve essere univoco tra tutti gli account IBM Cloud nella stessa regione. Gli spazi dei nomi devono avere tra i 4 e i 30 caratteri e contenere solo lettere minuscole, numeri, trattini (-) e caratteri di sottolineatura (_). Gli spazi dei nomi devono iniziare e terminare con una lettera o un numero.

Non inserire informazioni personali nei tuoi nomi dello spazio dei nomi.

Opzioni comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)
(Facoltativo) Specifica il nome o l'ID del gruppo di risorse a cui vuoi aggiungere lo spazio dei nomi. Se non imposti questa opzione, viene utilizzato il gruppo di risorse di destinazione. Se non imposti questa opzione e un gruppo di risorse non è specificato come destinazione, viene utilizzato il gruppo di risorse predefinito per l'account.

Esempi

Create uno spazio dei nomi con il nome birds2 e aggiungetelo al gruppo di risorse beaks inserendo beaks come nome del gruppo di risorse e birds2 come spazio dei nomi.

ibmcloud cr namespace-add -g beaks birds2

Output

Il comando nell'esempio restituisce il seguente output:

Adding namespace 'birds2' in resource group 'beaks' for account X's Account in registry us.icr.io...
Successfully added namespace 'birds2'
OK

ibmcloud cr namespace-assign

Gli spazi dei nomi creati nella versione 0.1.484 della CLI di Container Registry o in versioni precedenti, oppure nella console IBM Cloud prima del 29 luglio 2020, non sono assegnati a gruppi di risorse. Puoi assegnare uno spazio dei nomi non assegnato a un gruppo di risorse per il tuo account IBM Cloud. Se si assegna uno spazio dei nomi a un gruppo di risorse, è possibile configurare l'accesso alle risorse all'interno dello spazio dei nomi a livello di gruppo di risorse. Se non si specifica un gruppo di risorse e non viene selezionato alcun gruppo di risorse come destinazione, il comando non va a buon fine.

Puoi assegnare uno spazio dei nomi a un gruppo di risorse solo una volta. Quando uno spazio dei nomi si trova in un gruppo di risorse, non puoi spostarlo in un altro gruppo di risorse.

Per scoprire quali spazi dei nomi sono assegnati e quali non sono assegnati ai gruppi di risorse, esegui il comando ibmcloud cr namespace-list con l'opzione -v. Gli spazi dei nomi assegnati a un gruppo di risorse vengono visualizzati anche nella pagina Elenco risorse della console IBM Cloud.

ibmcloud cr namespace-assign [-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)] NAMESPACE

Per ulteriori informazioni sui gruppi di risorse, vedi Creazione di un gruppo di risorse.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di gestione della piattaforma " e " Ruoli di accesso" per la configurazione di Container Registry.

Argomenti comando

NAMESPACE
Lo spazio dei nomi che vuoi assegnare a un gruppo di risorse.

Opzioni comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)
(Facoltativo) Specifica il nome o l'ID del gruppo di risorse a cui vuoi assegnare lo spazio dei nomi. Se non imposti questa opzione, viene utilizzato il gruppo di risorse di destinazione.

Esempi

Assegnate uno spazio dei nomi con il nome birds al gruppo di risorse beaks inserendo beaks come nome del gruppo di risorse e birds come spazio dei nomi.

ibmcloud cr namespace-assign -g beaks birds

Output

Il comando nell'esempio restituisce il seguente output:

Assigning namespace 'birds' to resource group 'beaks' for account X's Account in registry us.icr.io...
Successfully assigned namespace 'birds' to resource group 'beaks.'
OK

ibmcloud cr namespace-list (ibmcloud cr namespaces)

Alias: namespaces

Visualizza tutti gli spazi dei nomi che appartengono al tuo account IBM Cloud. Puoi utilizzare questo comando per elencare i tuoi spazi dei nomi in modo da poter verificare quali spazi dei nomi sono assegnati ai gruppi di risorse e quali non sono assegnati. Gli spazi dei nomi assegnati a un gruppo di risorse vengono visualizzati anche nella pagina " Elenco risorse " della console IBM Cloud.

ibmcloud cr namespace-list [--verbose | -v] [--output json | -o json]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--verbose, -v
(Facoltativo) Consente di elencare tutti gli spazi dei nomi e includere informazioni sul gruppo di risorse e la data di creazione dello spazio dei nomi.
--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Per visualizzare un elenco di tutti i tuoi spazi dei nomi, comprese le informazioni relative ai gruppi di risorse e alle date di creazione, utilizza l'opzione " --verbose ".

ibmcloud cr namespace-list -v

Output

Il comando nell'esempio restituisce il seguente output:

Listing namespaces for account 'X's Account' in registry 'us.icr.io'...
Namespace   Resource Group   Created
birds       default          1 year ago
birds2      beaks            40 seconds ago
OK

ibmcloud cr namespace-rm

Rimuove uno spazio dei nomi dal tuo account IBM Cloud. Le immagini in questo spazio dei nomi vengono eliminate quando si rimuove lo spazio dei nomi.

ibmcloud cr namespace-rm NAMESPACE  [--force | -f]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Argomenti comando

NAMESPACE
Lo spazio dei nomi che desideri rimuovere.

Opzioni comando

--force, -f
(Facoltativo) Forza l'esecuzione del comando senza alcun prompt utente.

Esempi

Rimuovere lo spazio dei nomi birds inserendo birds come spazio dei nomi.

ibmcloud cr namespace-rm birds

Output

Il comando nell'esempio restituisce il seguente output:

Removing namespace 'birds'...
Successfully removed namespace 'birds'.
OK

ibmcloud cr plan

Visualizza il tuo piano dei prezzi per la regione del registro di destinazione.

ibmcloud cr plan [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Creare il piano tariffario in formato JSON inserendo json come output.

ibmcloud cr plan -o json

Output

Il comando nell'esempio restituisce il seguente output:

{
	"plan": "Free"
}

ibmcloud cr plan-upgrade

Esegui l'upgrade al piano standard per la regione del registro di destinazione.

ibmcloud cr plan-upgrade [PLAN]

Per ulteriori informazioni sui piani, vedi Piani del registro.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Argomenti comando

PLAN
(Facoltativo) Il nome del piano dei prezzi a cui desideri eseguire l'upgrade. Se PLAN non viene specificato, il valore predefinito è standard.

Esempi

Passare al piano tariffario standard inserendo standard come piano.

ibmcloud cr plan-upgrade standard

Output

Il comando nell'esempio restituisce il seguente output:

Upgrading account to 'standard' plan in registry 'us.icr.io'...
OK

ibmcloud cr platform-metrics

È possibile utilizzare il comando per abilitare e disabilitare le metriche della piattaforma. Puoi anche utilizzarlo per scoprire se hai le metriche della piattaforma configurate sul tuo account per la regione del registro di destinazione.

Se vuoi visualizzare la metrica della piattaforma per IBM Cloud Container Registry, devi eseguire l'opt - in eseguendo il comando ibmcloud cr platform-metrics.

È necessario specificare una delle opzioni del comando, altrimenti il comando non verrà eseguito e verrà visualizzato un messaggio di errore.

ibmcloud cr platform-metrics --enable | --disable | --status

Per ulteriori informazioni sulle metriche della piattaforma che puoi visualizzare in Container Registry, vedi Monitoraggio delle metriche per IBM Cloud Container Registry.

Prerequisiti

Opzioni comando

--enable
(Facoltativo) Attiva l'impostazione per il tuo account.
--disable
(Facoltativo) Disattiva l'impostazione per il tuo account.
--status
(Facoltativo) Indica se l'impostazione è abilitata per il tuo account.

Esempi

Abilitare le metriche della piattaforma per il proprio account utilizzando l'opzione --enable.

ibmcloud cr platform-metrics --enable

Output

Il comando nell'esempio restituisce il seguente output:

OK

ibmcloud cr private-only

Impedisci i pull o i push di immagini sulle connessioni di rete pubbliche per il tuo account per la regione di registro che stai indicando come destinazione. È necessario specificare una delle opzioni del comando, altrimenti il comando non verrà eseguito e verrà visualizzato un messaggio di errore.

ibmcloud cr private-only --enable | --disable | --status

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--enable
(Facoltativo) Impedisce i pull o i push di immagini sulle connessioni di rete pubbliche per il tuo account.
--disable
(Facoltativo) Ripristina pull o push di immagini sulle connessioni di rete pubbliche per il tuo account.
--status
(Facoltativo) Controlla se l'uso delle connessioni pubbliche non è consentito per i push o i pull di immagini nel tuo account.

Esempi

Impedire l'estrazione o l'invio di immagini su connessioni di rete pubbliche per l'account utilizzando l'opzione --enable.

ibmcloud cr private-only --enable

Output

Il comando nell'esempio restituisce il seguente output:

Enabling private-only networking for account 'X's Account' in registry 'us.icr.io'...
OK

ibmcloud cr quota

Visualizza le quote relative al traffico e allo spazio di archiviazione, nonché le informazioni sull'utilizzo rispetto a tali quote per la regione del registro a cui ti stai rivolgendo.

ibmcloud cr quota [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Visualizzare le quote di traffico e di archiviazione in formato JSON inserendo json come opzione di output.

ibmcloud cr quota -o json

Output

Il comando nell'esempio restituisce il seguente output:

{
	"usage": {
		"traffic": 0,
		"store": 0
	},
	"limit": {
		"traffic": 5368709120,
		"store": 536870912
	}
}

ibmcloud cr quota-set

Modifica la quota specificata per la regione del registro di destinazione.

ibmcloud cr quota-set [--storage STORAGE] [--traffic TRAFFIC]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.

Opzioni comando

--traffic TRAFFIC
(Facoltativo) Modifica la tua quota di traffico sul valore specificato in megabyte. L'operazione non riesce se non sei autorizzato a impostare il traffico o se imposti un valore che supera il tuo piano dei prezzi corrente.
--storage STORAGE
(Facoltativo) Modifica la tua quota di archiviazione sul valore specificato in megabyte. L'operazione non riesce se non sei autorizzato a impostare le quote di archiviazione o se imposti un valore che supera il tuo piano dei prezzi corrente.

Esempi

Impostare il limite di quota per il traffico di pull a 7000 megabyte e lo storage a 600 megabyte inserendo 7000 come quota di traffico e 600 come quota di storage.

ibmcloud cr quota-set --traffic 7000 --storage 600

Output

Il comando nell'esempio restituisce il seguente output:

Setting quotas: 'storage: 600 , traffic: 7000'...
OK

ibmcloud cr region

Visualizza la regione di destinazione e il registro. Per ulteriori informazioni, vedi Regioni.

ibmcloud cr region

Esempi

Individuare la regione e il registro a cui ci si rivolge.

ibmcloud cr region

Output

Il comando nell'esempio restituisce il seguente output:

You are targeting region 'us-south', the registry is 'us.icr.io'.
OK

ibmcloud cr region-set

Imposta una regione di destinazione per i comandi IBM Cloud Container Registry. Per elencare le regioni disponibili, esegui il comando senza opzioni. Per ulteriori informazioni, vedi Regioni.

ibmcloud cr region-set [REGION]

Argomenti comando

REGION
(Facoltativo) Il nome della regione di destinazione, ad esempio us-south. Per ulteriori informazioni, vedi Regioni.

Esempi

Rivolgersi alla regione di Dallas inserendo us-south come regione.

ibmcloud cr region-set us-south

Output

Il comando nell'esempio restituisce il seguente output:

The region is set to 'us-south', the registry is 'us.icr.io'.
OK

ibmcloud cr retention-policy-list

Elenca le politiche di conservazione delle immagini per il tuo account. Le politiche di conservazione delle immagini conservano il numero specificato di immagini per ciascun repository all'interno di uno spazio dei nomi in IBM Cloud Container Registry. Tutte le altre immagini nello spazio dei nomi vengono eliminate. È inoltre possibile verificare se l'opzione che consente di conservare tutte le immagini prive di tag è applicabile alla politica e se è stata impostata una soglia di tempo per la cancellazione.

Quando a un'immagine all'interno di un repository viene fatto riferimento da più tag, tale immagine viene contata una sola volta. Le immagini più recenti vengono conservate. L'età viene determinata dal momento in cui è stata creata l'immagine, non da quando ne è stato eseguito il push al registro.

ibmcloud cr retention-policy-list [--output | -o [json]]

Per ulteriori informazioni su come utilizzare il comando ibmcloud cr retention-policy-list, vedi Conservazione delle immagini.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--output json, -o json
(Facoltativo) Fornisce l'elenco in formato JSON.

Esempi

Elencare i criteri di conservazione dell'account in formato JSON inserendo json come output.

ibmcloud cr retention-policy-list -o json

Output

Il comando nell'esempio restituisce il seguente output:

{
	"birds": {
		"namespace": "birds",
		"account": "",
		"images_per_repo": 10,
		"deletion_threshold_days": 365,
		"retain_untagged": false
	},
	"birds2": {
		"namespace": "birds2",
		"account": "",
		"images_per_repo": -1,
		"retain_untagged": true
	}
}

ibmcloud cr retention-policy-set

Imposta una politica per conservare il numero specificato di immagini per ciascun repository all'interno di uno spazio dei nomi in IBM Cloud Container Registry. Tutte le altre immagini nello spazio dei nomi vengono eliminate. Quando si imposta una politica che viene eseguita in modo interattivo, viene eseguita quotidianamente. Puoi impostare solo una politica in ogni spazio dei nomi.

Puoi scegliere se escludere tutte le immagini non contrassegnate con tag dal numero totale di immagini che decidi di conservare. È inoltre possibile impostare una soglia di età minima in modo che le immagini con età inferiore a tale soglia vengano sempre conservate, indipendentemente dal numero di " --images ".

Quando a un'immagine, all'interno di un repository, viene fatto riferimento da più tag, tale immagine viene contata una sola volta. Le immagini più recenti vengono conservate. L'età viene determinata dal momento in cui è stata creata l'immagine, non da quando ne è stato eseguito il push al registro.

Se una politica di conservazione elimina un'immagine che vuoi mantenere, puoi ripristinare l'immagine. Per identificare l'immagine, elenca il contenuto del cestino eseguendo il comando ibmcloud cr trash-list e ripristina l'immagine selezionata eseguendo il comando ibmcloud cr image-restore.

Se vuoi annullare una politica di conservazione, vedi Aggiorna una politica di conservazione per conservare tutte le tue immagini.

ibmcloud cr retention-policy-set [--retain-untagged] [--deletion-threshold-days DAYS] [--force | -f] --images IMAGECOUNT NAMESPACE

Per ulteriori informazioni su come utilizzare il comando ibmcloud cr retention-policy-set, vedi Conservazione delle immagini.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

NAMESPACE
Lo spazio dei nomi per il quale vuoi creare una politica.

Opzioni comando

--retain-untagged
(Facoltativo) Conserva tutte le immagini non contrassegnate con tag quando viene elaborata la politica di conservazione. Vengono analizzate solo le immagini contrassegnate con tag e, se le immagini non soddisfano i criteri, vengono eliminate. Se l'opzione non viene specificata, vengono analizzate tutte le immagini contrassegnate con tag o meno e, se le immagini non soddisfano i criteri, vengono eliminate.
--deletion-threshold-days
(Facoltativo) Imposta l'età minima, espressa in giorni, che un'immagine deve avere prima che la politica di conservazione possa eliminarla. Le immagini più recenti di DAYS vengono sempre conservate, anche se la loro conservazione supera il numero specificato in --images. DAYS deve essere un numero intero positivo. Il valore predefinito è 0, il che significa che non viene applicata alcuna soglia.
--force, -f
(Facoltativo) Forza l'esecuzione del comando senza alcun prompt utente.
--images
Determina quante immagini conservare all'interno di ogni repository nello spazio dei nomi specificato. Le immagini più recenti vengono conservate. L'età delle immagini è determinata dalla relativa data di creazione. IMAGE_COUNT è il numero di immagini che vuoi conservare in ogni repository per lo spazio nomi. Per ripristinare le impostazioni predefinite di una policy, in modo che tutte le immagini rimangano impostate su IMAGE_COUNT, visitare All.

Esempio 1

Impostare un criterio che conservi le 20 immagini più recenti all'interno di ogni repository nello spazio dei nomi birds inserendo 20 come numero di immagini da conservare e birds come spazio dei nomi. Analizza tutte le immagini contrassegnate e non contrassegnate; se le immagini non soddisfano i criteri, vengono eliminate.

ibmcloud cr retention-policy-set --images 20 birds

Risultato per esempio 1

Il comando nell'esempio 1 restituisce il seguente output:

Found n images to delete.
OK
A scheduled retention policy is set that keeps 20 images in each repository in birds and retain-untagged is set to false.
OK

Esempio 2

Imposta una politica che conservi le 10 immagini più recenti in ogni repository dello spazio dei nomi birds, ma che protegga dalla cancellazione qualsiasi immagine con meno di 90 giorni di vita, anche se ciò comporta il superamento del limite di 10 immagini.

ibmcloud cr retention-policy-set --images 10 --deletion-threshold-days 90 birds

Risultato per esempio 2

Il comando nell'esempio 2 restituisce il seguente output:

Found n images to delete.
OK
A scheduled retention policy is set that keeps 10 images in each repository in birds, with a deletion threshold of 90 days, and retain-untagged is set to false.
OK

Esempio 3

Riportare il criterio allo stato predefinito in modo da mantenere tutte le immagini nello spazio dei nomi birds, inserendo All come numero di immagini da mantenere e birds come spazio dei nomi.

ibmcloud cr retention-policy-set --images All birds

Risultato dell'esempio 3

Il comando dell'esempio 3 restituisce il seguente risultato:

The retention policy to keep all images in birds is set.
OK

ibmcloud cr retention-run

Ripulisce uno spazio dei nomi conservando un numero specificato di immagini per ciascun repository all'interno di uno spazio dei nomi in IBM Cloud Container Registry. Tutte le altre immagini nello spazio dei nomi vengono eliminate.

Puoi scegliere se escludere tutte le immagini non contrassegnate con tag dal numero totale di immagini che decidi di conservare. È inoltre possibile impostare una soglia di età minima in modo che le immagini con età inferiore a tale soglia vengano sempre conservate, indipendentemente dal numero di " --images ".

Quando a un'immagine, all'interno di un repository, viene fatto riferimento da più tag, tale immagine viene contata una sola volta. Le immagini più recenti vengono conservate. L'età viene determinata dal momento in cui è stata creata l'immagine, non da quando ne è stato eseguito il push al registro.

Il comando di retention viene eseguito su ogni repository del proprio spazio dei nomi. Se avete più di un repository nel vostro spazio dei nomi, il conteggio delle immagini dopo l'esecuzione del comando di conservazione potrebbe essere superiore al numero impostato come massimo per un repository. Ad esempio, se si imposta il comando di conservazione a 500 immagini per repository e si hanno 10 repository nel proprio spazio dei nomi, si potrebbe avere un numero di immagini pari a 5.000.

Se vuoi ripristinare un'immagine eliminata, puoi elencare il contenuto del cestino eseguendo il comando ibmcloud cr trash-list e ripristinare un'immagine selezionata eseguendo il comando ibmcloud cr image-restore.

Se un'immagine che prevedi di vedere non viene visualizzata nell'elenco che viene prodotto, vedi Perché il comando di conservazione non mostra tutte le immagini? per assistenza.

ibmcloud cr retention-run [--force | -f ] [--output | -o [json]] [--retain-untagged] [--deletion-threshold-days DAYS] --images IMAGECOUNT NAMESPACE

Per ulteriori informazioni su come utilizzare il comando ibmcloud cr retention-run, vedi Conservazione delle immagini.

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

NAMESPACE
Lo spazio dei nomi che desideri ripulire.

Opzioni comando

--force, -f
(Facoltativo) Forza l'esecuzione del comando senza alcun prompt utente.
--output json, -o json
(Facoltativo) Emette un JSON che contiene i risultati della ripulitura del tuo spazio dei nomi. Questa opzione deve essere utilizzata con --force.
--retain-untagged
(Facoltativo) Conserva tutte le immagini non contrassegnate con tag quando viene elaborata la politica di conservazione. Vengono analizzate solo le immagini contrassegnate con tag e, se le immagini non soddisfano i criteri, vengono eliminate. Se l'opzione non viene specificata, vengono analizzate tutte le immagini contrassegnate con tag o meno e, se le immagini non soddisfano i criteri, vengono eliminate.
--deletion-threshold-days
(Facoltativo) Imposta l'età minima, espressa in giorni, che un'immagine deve raggiungere prima che il processo di conservazione possa eliminarla. Le immagini più recenti di DAYS vengono sempre conservate, anche se la loro conservazione supera il numero specificato in --images. DAYS deve essere un numero intero positivo. Il valore predefinito è 0, il che significa che non viene applicata alcuna soglia.
--images
Determina quante immagini conservare all'interno di ogni repository nello spazio dei nomi specificato. Le immagini più recenti vengono conservate. L'età delle immagini è determinata dalla relativa data di creazione. IMAGE_COUNT è il numero di immagini che vuoi conservare in ogni repository per lo spazio nomi.

Esempi

Conservare le 20 immagini più recenti all'interno di ciascun repository nello spazio dei nomi birds inserendo 20 come numero di immagini da conservare e birds come spazio dei nomi.

ibmcloud cr retention-run --images 20 birds

Output

Il comando nell'esempio restituisce il seguente output:

Retrieving images to delete from namespace 'birds' in registry us.icr.io'...
Found n images to delete.
OK

ibmcloud cr trash-list

Visualizza tutte le immagini nel cestino nel tuo account IBM Cloud. È inoltre possibile visualizzare il numero di giorni che mancano alla rimozione dell'immagine dal cestino. Il numero di giorni rimanenti fino alla rimozione viene arrotondato per eccesso. Ad esempio, se il tempo fino alla rimozione è 2 ore, viene visualizzato come 1 giorno. Le immagini rimangono nel cestino per 30 giorni dopo essere state eliminate dal tuo repository attivo.

Se vuoi ripristinare un'immagine dal cestino, esegui il comando ibmcloud cr image-restore; vedi Ripristino delle immagini.

Non è possibile eliminare le immagini dal cestino. Le immagini vengono archiviate nel cestino per 30 giorni. Le immagini presenti nel cestino non vengono addebitate.

ibmcloud cr trash-list [--restrict NAMESPACE] [--output | -o [json]]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Opzioni comando

--restrict NAMESPACE
(Facoltativo) Limita l'output per visualizzare solo le immagini nello spazio dei nomi specificato.
--output json, -o json
(Facoltativo) Emette un JSON che contiene i dettagli del contenuto del cestino.

Esempi

Visualizzare le immagini che si trovano nel cestino nello spazio dei nomi birds inserendo birds come restrizione.

ibmcloud cr trash-list --restrict birds

Output

Il comando nell'esempio restituisce il seguente output:

Listing the contents of the trash...
Digest   Days until expiry   Tags
110011   24                  1
OK

ibmcloud cr va-version

Scopri quale versione di Vulnerability Advisor stai usando. La Versione 4 è l'unica versione valida.

ibmcloud cr va-version

Esempi

Scopri quale versione di Vulnerability Advisor stai usando.

ibmcloud cr va-version

Output

Il comando nell'esempio restituisce il seguente output:

You are targeting Vulnerability Advisor version 'v4'.
OK

ibmcloud cr va-version-set

Impostare la versione di Vulnerability Advisor. L'unico valore valido è v4.

Se provi a impostare una versione non valida di Vulnerability Advisor, riceverai un errore. Per assistenza, consulta Perché ricevo un errore relativo alla versione non valida di Vulnerability Advisor specificata?

ibmcloud cr va-version-set [VERSION]

Argomenti comando

VERSION
(Facoltativo) La versione di Vulnerability Advisor che si desidera utilizzare. L'unico valore valido è v4. Se non viene specificato VERSION, il valore predefinito è v4.

Esempi

Impostare la versione di Vulnerability Advisor alla versione 4 inserendo v4 come versione:

ibmcloud cr va-version-set v4

Output

Il comando nell'esempio restituisce il seguente output:

You are targeting Vulnerability Advisor version 'v4'.
OK

ibmcloud cr vulnerability-assessment

Alias: va (ibmcloud cr va)

Visualizza un report di valutazione delle vulnerabilità per le tue immagini.

ibmcloud cr vulnerability-assessment [--extended | -e] [--vulnerabilities | -v] [--output FORMAT | -o FORMAT] IMAGE [IMAGE...]

Prerequisiti

Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione " Ruoli di accesso per l'utilizzo di Container Registry ".

Argomenti comando

IMAGE

Il nome dell'immagine per cui vuoi ottenere un report. Il report indica se l'immagine ha delle vulnerabilità di pacchetto note. Puoi richiedere report per più immagini contemporaneamente elencando ogni immagine nel comando con uno spazio tra ciascun nome.

Per trovare i nomi delle tue immagini, esegui ibmcloud cr image-list. Combinare il contenuto della colonna Repository (repository) e la colonna Tag (tag) separati da due punti (:) per creare il nome immagine nel formato repository:tag. Se nel nome immagine non è specificata alcuna tag, il report valuta l'immagine contrassegnata con la tag latest.

Per ulteriori informazioni sulle immagini di base Docker supportate, vedi Pacchetti vulnerabili.

Per ulteriori informazioni, vedi Gestione della sicurezza delle immagini con il Vulnerability Advisor.

Opzioni comando

--extended, -e

(Facoltativo) L'output del comando mostra informazioni aggiuntive sulle correzioni per i pacchetti vulnerabili.

--vulnerabilities, -v

(Facoltativo) L'output del comando è limitato per mostrare solo le vulnerabilità.

--output FORMAT, -o FORMAT

(Facoltativo) L'output del comando viene restituito nel formato scelto. Il formato predefinito è text.

Sono supportati i seguenti formati:

  • text
  • json

Esempi

Visualizzare un rapporto di valutazione delle vulnerabilità standard per l'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

Visualizzare un rapporto di valutazione delle vulnerabilità che mostra le vulnerabilità dell'immagine us.icr.io/birds/bluebird:1 in formato JSON utilizzando l'opzione -- vulnerabilities e inserendo json come formato per l'output e us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr vulnerability-assessment --vulnerabilities --output json us.icr.io/birds/bluebird:1

Esempio 1

Visualizzare un rapporto di valutazione delle vulnerabilità standard per l'immagine us.icr.io/birds/bluebird:1 inserendo us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

Risultato per esempio 1

Il comando nell'esempio 1 restituisce il seguente output:

Checking security issues for 'us.icr.io/birds/bluebird:1'...
Image                              Current   Configuration Issues   Vulnerabilities
us.icr.io/birds/bluebird:1         OK        0                      0
OK

Esempio 2

Visualizzare un rapporto di valutazione delle vulnerabilità che mostra le vulnerabilità dell'immagine us.icr.io/birds/bluebird:1 in formato JSON utilizzando l'opzione -- vulnerabilities e inserendo json come formato per l'output e us.icr.io/birds/bluebird:1 come immagine.

ibmcloud cr vulnerability-assessment --vulnerabilities --output json us.icr.io/birds/bluebird:1

Risultato per esempio 2

Il comando nell'esempio 2 restituisce il seguente output:

[
  {
    "image": "us.icr.io/birds/bluebird:1",
    "vulnerabilities": [],
    "status": "OK"
  }
]