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.
-
Installa il plugin della CLI
ibmcloud, vedi Introduzione alla CLI IBM Cloud. -
Installa il plug-in CLI di
container-registry.ibmcloud plugin install container-registryPer ulteriori informazioni, consultare la sezione " Installazione del plug-in CLI di
container-registry". -
Accedi a IBM Cloud con il comando
ibmcloud loginper 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:
namespacenamespace/repositorynamespace/repository:tagnamespace/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:
namespacenamespace/repositorynamespace/repository:tagnamespace/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:
namespacenamespace/repositorynamespace/repository:tagnamespace/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
--val'opzione insieme--restrictall'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 formatorepository@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 formatorepository:tag. Se nel nome immagine non è specificata una tag, viene eliminata per impostazione predefinita l'immagine contrassegnata conlatest.
- Per identificare la tua immagine tramite digest, esegui il comando
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
--val'opzione insieme--restrictall'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 formatorepository@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 formatorepository:tag. Se nel nome immagine non è specificata una tag, viene eliminata per impostazione predefinita l'immagine contrassegnata conlatest.
- Per identificare la tua immagine tramite digest, esegui il comando
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 formatorepository@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 formatorepository:tag.
Se ricevi un errore manifesto quando tenti di contrassegnare la tua immagine, i seguenti argomenti potrebbero essere di aiuto:
- Perché ricevo un errore di tipo manifest quando contrassegno la mia immagine?
- Perché ricevo un errore di versione manifest?
- Perché ricevo un errore di elenco manifest non valido?
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_IMAGEdeve essere nel formatorepository:tag, ad esempious.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.
IMAGEdeve essere nel formatorepository:tag, ad esempious.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 formatorepository: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
dockerepodman. 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 formatorepository@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 formatorepository:tag.
- Per identificare la tua immagine tramite digest, esegui il comando
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, doveRESOURCE_GROUPè il gruppo di risorse. - Specificare il gruppo di risorse richiesto utilizzando l'opzione
-gsul comandoibmcloud 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
PLANnon 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
- Devi configurare IBM Cloud Monitoring, vedi Esercitazione introduttiva per IBM Cloud Monitoring.
- Abilita la tua istanza IBM Cloud Monitoring per le metriche della piattaforma.
- Per ulteriori informazioni sulle autorizzazioni richieste, consultare la sezione “Ruoli di accesso per la configurazione di Container Registry ”.
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
DAYSvengono sempre conservate, anche se la loro conservazione supera il numero specificato in--images.DAYSdeve 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 suIMAGE_COUNT, visitareAll.
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
DAYSvengono sempre conservate, anche se la loro conservazione supera il numero specificato in--images.DAYSdeve 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 specificatoVERSION, 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 formatorepository:tag. Se nel nome immagine non è specificata alcuna tag, il report valuta l'immagine contrassegnata con la taglatest.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:
textjson
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"
}
]