Notas

Para obtener más información sobre cómo utilizar la CLI Container Registry, los comandos ibmcloud cr, consulte Introducción a IBM Cloud Container Registry.

Se te notificará en la línea comando cuando haya actualizaciones disponibles para la CLI ibmcloud y los complementos de la CLI container-registry. Asegúrate de mantener actualizadas tus interfaces de línea de comandos (CLI) para poder utilizar todos los comandos y opciones disponibles. Si quieres ver la versión actual de tu complemento de la CLI container-registry, ejecuta el comando ibmcloud plugin list.

Para obtener más información sobre la plataforma IAM y los roles de acceso al servicio que se requieren para algunos comandos de Container Registry, consulte Gestión del acceso a IAM para Container Registry.

No coloque información personal en las imágenes de contenedor, nombres de espacio de nombres, campos de descripción, o en cualesquiera datos de configuración de imágenes (por ejemplo, nombres de imágenes o etiquetas de imagen).

Si Container Registryibmcloud cr comandos fallan con un error que indica que no son comandos registrados, consulte ¿Por qué fallan comandos Container Registry comandos(ibmcloud cr)con un mensaje que indica que no están registrados? para obtener ayuda. Si los comandos fallan y aparece un mensaje indicando que no has iniciado sesión, consulta ¿Por qué no puedo iniciar sesión en Container Registry? para obtener ayuda.

Ejemplos

Conozca los detalles del punto final de la API de registro.

ibmcloud cr api

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--scope SCOPE

Para establecer su cuenta como ámbito, utilice el valor "*".

Para establecer un espacio de nombres, repositorio, resumen o etiqueta como ámbito, especifique el valor en uno de los formatos siguientes:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

El tipo del problema de seguridad que desea eximir. Ejecute ibmcloud cr exemption-types para averiguar los tipos de problema válidos.

--issue-id ISSUE_ID

El ID del problema de seguridad que desea eximir. Para encontrar un ID de incidencia, ejecuta ibmcloud cr va <image>, donde <image> es el nombre de tu imagen, y utiliza el valor correspondiente de la columna ID de vulnerabilidad.

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Cree una exención CVE para el CVE con ID CVE-2018-17929 para todas las imágenes del repositorio us.icr.io/birds/bluebird introduciendo us.icr.io/birds/bluebird para el ámbito, cve para el tipo de incidencia y CVE-2018-17929 para el ID de incidencia.

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

Cree una exención de CVE para toda la cuenta para el CVE con ID CVE-2018-17929 introduciendo "*" para el ámbito, cve para el tipo de incidencia y CVE-2018-17929 para el ID de incidencia.

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

Ejemplo 1

Cree una exención CVE para el CVE con ID CVE-2018-17929 para todas las imágenes del repositorio us.icr.io/birds/bluebird introduciendo us.icr.io/birds/bluebird para el ámbito, cve para el tipo de incidencia y CVE-2018-17929 para el ID de incidencia.

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

Resultado para el ejemplo 1

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Cree una exención de CVE para toda la cuenta para el CVE con ID CVE-2018-17929 introduciendo "*" para el ámbito, cve para el tipo de incidencia y CVE-2018-17929 para el ID de incidencia.

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

Salida para el ejemplo 2

El comando del ejemplo 2 devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--scope SCOPE

(Opcional) Únicamente muestra una lista de las exenciones que se aplican a este ámbito.

Para establecer un espacio de nombres, repositorio, resumen o etiqueta como ámbito, especifique el valor en uno de los formatos siguientes:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Enumere todas sus exenciones por problemas de seguridad que se aplican a las imágenes del repositorio birds/bluebird introduciendo birds/bluebird como ámbito.

La salida incluye las exenciones correspondientes a toda la cuenta, las exenciones que se limitan al espacio de nombres birds y las exenciones que se limitan al repositorio birds/bluebird. La salida no incluye ninguna exención que se limite a etiquetas específicas dentro del repositorio birds/bluebird.

ibmcloud cr exemption-list --scope birds/bluebird

Enumere todas sus exenciones por problemas de seguridad que se aplican a las imágenes en el resumen birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 introduciendo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 como ámbito.

El resultado incluye exenciones que se aplican a toda la cuenta, exenciones cuyo ámbito se limita al espacio de birds nombres y exenciones cuyo ámbito se limita al repositorio birds/bluebird y al birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 resumen. La salida no incluye ninguna exención que se limite a etiquetas específicas dentro del repositorio birds/bluebird.

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

Ejemplo 1

Enumere todas sus exenciones por problemas de seguridad que se aplican a las imágenes del repositorio birds/bluebird introduciendo birds/bluebird como ámbito.

ibmcloud cr exemption-list --scope birds/bluebird

Resultado para el ejemplo 1

La salida incluye las exenciones correspondientes a toda la cuenta, las exenciones que se limitan al espacio de nombres birds y las exenciones que se limitan al repositorio birds/bluebird. La salida no incluye ninguna exención que se limite a etiquetas específicas dentro del repositorio birds/bluebird.

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Enumere todas sus exenciones por problemas de seguridad que se aplican a las imágenes en el resumen birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 introduciendo birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 como ámbito.

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

Salida para el ejemplo 2

El resultado incluye exenciones que se aplican a toda la cuenta, exenciones cuyo ámbito se limita al espacio de birds nombres y exenciones cuyo ámbito se limita al repositorio birds/bluebird y al birds/bluebird@sha256:1010101010101010101010101010101010101010101010101010101010101010 resumen. La salida no incluye ninguna exención que se limite a etiquetas específicas dentro del repositorio birds/bluebird.

El comando del ejemplo 2 devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--scope SCOPE

Para establecer su cuenta como ámbito, utilice el valor "*".

Para establecer un espacio de nombres, repositorio, resumen o etiqueta como ámbito, especifique el valor en uno de los formatos siguientes:

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

El tipo de incidencia correspondiente a la exención por motivos de seguridad que desea eliminar. Para conocer los tipos de incidencias que dan derecho a exenciones, ejecuta ibmcloud cr exemption-list.

--issue-id ISSUE_ID

ID de la exención para el problema de seguridad que desea eliminar. Para encontrar los ID para sus exenciones, ejecute ibmcloud cr exemption-list.

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Elimine una exención de CVE para el CVE con ID CVE-2018-17929 para todas las imágenes del repositorio us.icr.io/birds/bluebird introduciendo us.icr.io/birds/bluebird como ámbito, cve como tipo de incidencia y CVE-2018-17929 como ID de incidencia.

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

Elimine una exención de CVE para toda la cuenta para el CVE con ID CVE-2018-17929 introduciendo "*" como ámbito, cve como tipo de incidencia y CVE-2018-17929 como ID de incidencia.

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

Ejemplo 1

Elimine una exención de CVE para el CVE con ID CVE-2018-17929 para todas las imágenes del repositorio us.icr.io/birds/bluebird introduciendo us.icr.io/birds/bluebird como ámbito, cve como tipo de incidencia y CVE-2018-17929 como ID de incidencia.

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

Resultado para el ejemplo 1

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Elimine una exención de CVE para toda la cuenta para el CVE con ID CVE-2018-17929 introduciendo "*" como ámbito, cve como tipo de incidencia y CVE-2018-17929 como ID de incidencia.

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

Salida para el ejemplo 2

El comando del ejemplo 2 devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Enumere los tipos de problemas de seguridad.

ibmcloud cr exemption-types

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Ejemplos

Utilice las políticas de IAM para permitir una autorización detallada.

ibmcloud cr iam-policies-enable

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Ejemplos

Muestra el estado de la política de acceso IAM para su cuenta.

ibmcloud cr iam-policies-status

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--format FORMAT

(Opcional) Formatear los elementos de salida mediante una plantilla de Go. Para obtener más información, consulte Formateo y filtrado de la salida de CLI de Container Registry.

--quiet, -q

(Opcional) Cada imagen se lista en el formato: repository@digest

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

--restrict RESTRICTION

(Opcional) Limitar la salida para visualizar solo imágenes en el espacio de nombres o repositorio especificados.

--include-ibm

(Opcional) Incluye en la salida las imágenes públicas proporcionadas por IBM. De forma predeterminada solamente se listan las imágenes privadas. Solo puede ver las imágenes proporcionadas por IBM en el registro global.

--no-va

(Opcional) Excluye los resultados del estado de seguridad del Vulnerability Advisor de la salida. Si no necesita los resultados del estado de seguridad como parte de la salida de ibmcloud cr image-digests, puede utilizar esta opción para aumentar el rendimiento.

--va

(Opcional) Incluye los resultados del estado de seguridad de Vulnerability Advisor en la salida. Puede utilizar la --va opción con la --restrict opción para recibir solo la información que necesita.

Ejemplo

Muestra todas las imágenes del espacio de nombres birds, incluidas las no etiquetadas, en el formato repository@digest utilizando --quiet para listar las imágenes en el formato repository@digest e introduciendo birds como restricción.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen de la que desea obtener un informe. Puede examinar varias imágenes creando una lista de cada imagen en el mandato con un espacio entre cada nombre.

Puede identificar imágenes utilizando el resumen <dns>/<namespace>/<repo>@<digest> o por la etiqueta <dns>/<namespace>/<repo>:<tag>. Donde <dns> es el nombre de dominio, <namespace> es el espacio de nombres, <repo> es el repositorio, <digest> es el resumen y <tag> es la etiqueta.

Para encontrar los nombres de sus imágenes, ejecute uno de los mandatos siguientes:

• Para identificar la imagen por resumen, ejecute el mandato ibmcloud cr image-digests. Combine el contenido de la columna Repositorio (repository) y la columna Resumen (digest) separados por un símbolo en (@) para crear el nombre de imagen en el formato repository@digest.
• Para identificar su imagen por etiqueta, ejecute el mandato ibmcloud cr image-list. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag. Si no se especifica una etiqueta en el nombre de la imagen, la imagen etiquetada como latest se suprime de forma predeterminada.

Opciones de comando

--format FORMAT

(Opcional) Formatear los elementos de salida mediante una plantilla de Go. Para obtener más información, consulte Formateo y filtrado de la salida de CLI de Container Registry.

Ejemplos

Muestra detalles sobre los puertos expuestos para la imagen us.icr.io/birds/bluebird:1 utilizando la directiva de formato "{{ .Config.ExposedPorts }}" e introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--format FORMAT

(Opcional) Formatear los elementos de salida mediante una plantilla de Go. Para obtener más información, consulte Formateo y filtrado de la salida de CLI de Container Registry.

--quiet, -q

(Opcional) Cada imagen se lista en el formato: repository:tag

--restrict RESTRICTION

(Opcional) Limitar la salida para visualizar solo imágenes en el espacio de nombres o repositorio especificados.

--include-ibm

(Opcional) Incluye en la salida las imágenes públicas proporcionadas por IBM. De forma predeterminada solamente se listan las imágenes privadas. Solo puede ver las imágenes proporcionadas por IBM en el registro global.

--no-trunc

(Opcional) Devuelve el resumen de la imagen en su formato largo.

--show-type

(Opcional) Visualiza el tipo de manifiesto.

--no-va

(Opcional) Excluye los resultados del estado de seguridad del Vulnerability Advisor de la salida. Si no necesita los resultados del estado de seguridad como parte de la salida de ibmcloud cr image-list, puede utilizar esta opción para aumentar el rendimiento.

--va

(Opcional) Incluye los resultados del estado de seguridad de Vulnerability Advisor en la salida. Puede utilizar la --va opción con la --restrict opción para recibir solo la información que necesita.

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplo

Visualice las imágenes del espacio de nombres birds en el formato repository:tag, sin truncar los compendios de imágenes utilizando --quiet para visualizar la imagen en el formato repository:tag, --no-trunc para visualizar el compendio de imágenes en el formato largo, e introduciendo birds como restricción.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

us.icr.io/birds/bluebird:1

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--force, -f

(Opcional) Forzar la ejecución del mandato sin que el usuario lo solicite.

--output json, -o json

(Opcional) Genera JSON que contiene los resultados de limpiar las imágenes sin etiquetar. Esta opción se tiene que utilizar con --force.

--restrict

(Opcional) Limitar la limpieza solo a las imágenes sin etiquetar en el espacio de nombres o repositorio especificados.

Ejemplos

Elimine todas las imágenes no etiquetadas que se encuentran en el espacio de nombres birds sin ninguna pregunta al usuario y obtenga los resultados en formato JSON utilizando la opción --force para forzar la ejecución del comando sin preguntas al usuario, e introduciendo --json como salida y birds como restricción.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen que desea restaurar de la papelera.

Para encontrar los nombres de las imágenes en la papelera, ejecute el mandato ibmcloud cr trash-list.

Puede identificar las imágenes utilizando la etiqueta o el resumen. Se puede hacer referencia a la imagen a restaurar por el resumen <dns>/<namespace>/<repo>@<digest>, que restaura el resumen y todas sus etiquetas en el mismo repositorio, o por etiqueta <dns>/<namespace>/<repo>:<tag>. Donde <dns> es el nombre de dominio, <namespace> es el espacio de nombres, <repo> es el repositorio, <digest> es el resumen y <tag> es la etiqueta.

Las imágenes se almacenan en la papelera durante 30 días.

Ejemplos

Restaure la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen que desea suprimir. Puede suprimir varias imágenes al mismo tiempo creando una lista de cada imagen en el mandato con un espacio entre cada nombre. Puede identificar imágenes utilizando el resumen <dns>/<namespace>/<repo>@<digest> o por la etiqueta <dns>/<namespace>/<repo>:<tag>. Donde <dns> es el nombre de dominio, <namespace> es el espacio de nombres, <repo> es el repositorio, <digest> es el resumen y <tag> es la etiqueta.

Las imágenes se almacenan en la papelera durante 30 días.

Para encontrar los nombres de sus imágenes, ejecute uno de los mandatos siguientes:

• Para identificar la imagen por resumen, ejecute el mandato ibmcloud cr image-digests. Combine el contenido de la columna Repositorio (repository) y la columna Resumen (digest) separados por un símbolo en (@) para crear el nombre de imagen en el formato repository@digest.
• Para identificar su imagen por etiqueta, ejecute el mandato ibmcloud cr image-list. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag. Si no se especifica una etiqueta en el nombre de la imagen, la imagen etiquetada como latest se suprime de forma predeterminada.

Ejemplos

Borre la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

SOURCE_IMAGE

El nombre de la imagen de origen. Puede identificar las imágenes de origen utilizando el resumen <dns>/<namespace>/<repo>@<digest> o la etiqueta <dns>/<namespace>/<repo>:<tag>. Donde <dns> es el nombre de dominio, <namespace> es el espacio de nombres, <repo> es el repositorio, <digest> es el resumen y <tag> es la etiqueta.

TARGET_IMAGE

El nombre de la imagen de destino. TARGET_IMAGE debe tener el formato repository:tag, por ejemplo, us.icr.io/namespace/image:latest.

Ejemplos

Añada otra etiqueta de referencia latest, a la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen de origen y us.icr.io/birds/bluebird:latest como imagen de destino.

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

Copie la imagen us.icr.io/birds/bluebird:peck a otro repositorio en el mismo espacio de nombres birds/pigeon introduciendo us.icr.io/birds/bluebird:peck como imagen de origen y us.icr.io/birds/pigeon:peck como imagen de destino.

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

Copie la imagen us.icr.io/birds/bluebird:peck en otro espacio de nombres al que tenga acceso, en este ejemplo el espacio de nombres animals, introduciendo us.icr.io/birds/bluebird:peck como imagen de origen y us.icr.io/animals/dog:bark como imagen de destino.

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

Ejemplo 1

Añada otra etiqueta de referencia latest, a la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen de origen y us.icr.io/birds/bluebird:latest como imagen de destino.

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

Resultado para el ejemplo 1

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Copie la imagen us.icr.io/birds/bluebird:peck a otro repositorio en el mismo espacio de nombres birds/pigeon introduciendo us.icr.io/birds/bluebird:peck como imagen de origen y us.icr.io/birds/pigeon:peck como imagen de destino.

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

Salida para el ejemplo 2

El comando del ejemplo 2 devuelve el siguiente resultado:

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

Ejemplo 3

Copie la imagen us.icr.io/birds/bluebird:peck en otro espacio de nombres al que tenga acceso, en este ejemplo el espacio de nombres animals, introduciendo us.icr.io/birds/bluebird:peck como imagen de origen y us.icr.io/animals/dog:bark como imagen de destino.

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

Resultado del ejemplo 3

El comando del ejemplo 3 devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen de la que desea eliminar una etiqueta. Puede suprimir la etiqueta de varias imágenes al mismo tiempo listando cada imagen del mandato con un espacio entre cada nombre. IMAGE debe tener el formato repository:tag, por ejemplo, us.icr.io/namespace/image:latest.

Para encontrar los nombres de sus imágenes, ejecute ibmcloud cr image-list. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag. Si en el nombre de la imagen no se ha especificado una etiqueta, el mandato falla.

Ejemplos

Elimine la etiqueta 1 de la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Opciones de comando

--verbose

(Opcional) Mostrar información adicional sobre el entorno del registro.

Ejemplos

Busca el nombre y la cuenta del registro.

ibmcloud cr info

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Opciones de comando

--client CLIENT

(Opcional) Seleccione el cliente en el que desea iniciar la sesión. Los valores válidos son docker y podman. Si no se utiliza esta opción y Docker está instalado, el valor predeterminado es docker; si Docker no está instalado, el valor predeterminado es podman.

Ejemplos

Para acceder al registro mediante Podman, introduzca podman como cliente.

ibmcloud cr login --client podman

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen cuyo manifiesto desea inspeccionar. Puede identificar imágenes utilizando el resumen <dns>/<namespace>/<repo>@<digest> o por la etiqueta <dns>/<namespace>/<repo>:<tag>. Donde <dns> es el nombre de dominio, <namespace> es el espacio de nombres, <repo> es el repositorio, <digest> es el resumen y <tag> es la etiqueta.

Para encontrar los nombres de sus imágenes, ejecute uno de los mandatos siguientes:

• Para identificar la imagen por resumen, ejecute el mandato ibmcloud cr image-digests. Combine el contenido de la columna Repositorio (repository) y la columna Resumen (digest) separados por un símbolo en (@) para crear el nombre de imagen en el formato repository@digest.
• Para identificar su imagen por etiqueta, ejecute el mandato ibmcloud cr image-list. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag.

Opciones de comando

--quiet, -q

(Opcional) Reduce la salida para mostrar solo los elementos esenciales.

Ejemplos

Visualice el contenido del manifiesto de la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

{
   "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"
      }
   ]
}

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de gestión de la plataforma y Roles de acceso para configurar Container Registry.

Argumentos de mandato

NAMESPACE

El espacio de nombres que desea añadir. El espacio de nombres debe ser exclusivo en todas las cuentas de IBM Cloud de la misma región. Los espacios de nombres deben tener entre 4 y 30 caracteres y solo deben contener letras en minúsculas, números, guiones (-) y guiones bajos (_). Los espacios de nombres deben empezar y finalizar con una letra o un número.

No coloque información personal en los nombres del espacio de nombres.

Opciones de comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(Opcional) Especifique el nombre o el ID del grupo de recursos al que desea añadir el espacio de nombres. Si no desea establecer esta opción, se utiliza el grupo de recursos de destino. Si no establece esta opción y no hay un grupo de recursos como destino, se utiliza el grupo de recursos predeterminado para la cuenta.

Ejemplos

Crea un espacio de nombres con el nombre birds2 y añádelo al grupo de recursos beaks introduciendo beaks como nombre del grupo de recursos y birds2 como espacio de nombres.

ibmcloud cr namespace-add -g beaks birds2

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de gestión de la plataforma y Roles de acceso para configurar Container Registry.

Argumentos de mandato

NAMESPACE

El espacio de nombres que desea asignar a un grupo de recursos.

Opciones de comando

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(Opcional) Especifique el nombre o el ID del grupo de recursos al que desea asignar el espacio de nombres. Si no desea establecer esta opción, se utiliza el grupo de recursos de destino.

Ejemplos

Asigna un espacio de nombres con el nombre birds al grupo de recursos beaks introduciendo beaks como nombre del grupo de recursos y birds como espacio de nombres.

ibmcloud cr namespace-assign -g beaks birds

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--verbose, -v

(Opcional) Listar todos los espacios de nombres e incluir información sobre el grupo de recursos y la fecha de creación del espacio de nombres.

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Consulta una lista de todos tus espacios de nombres, incluida la información sobre los grupos de recursos y las fechas de creación, utilizando la opción --verbose.

ibmcloud cr namespace-list -v

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Argumentos de mandato

NAMESPACE

El espacio de nombres que desea eliminar.

Opciones de comando

--force, -f

(Opcional) Forzar la ejecución del mandato sin que el usuario lo solicite.

Ejemplos

Elimine el espacio de nombres birds introduciendo birds como espacio de nombres.

ibmcloud cr namespace-rm birds

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Imprima su plan de precios en formato JSON introduciendo json como salida.

ibmcloud cr plan -o json

Salida

El comando del ejemplo devuelve el siguiente resultado:

{
	"plan": "Free"
}

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Argumentos de mandato

PLAN

(Opcional) El nombre del plan de precios al que desea actualizar. Si no se especifica PLAN, el valor predeterminado será standard.

Ejemplos

Actualice al plan de precios estándar introduciendo standard como plan.

ibmcloud cr plan-upgrade standard

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

• Debe configurar IBM Cloud Monitoring, consulte la Guía de inicio para IBM Cloud Monitoring.
• Habilite la instancia de IBM Cloud Monitoring para las métricas de plataforma.
• Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--enable

(Opcional) Habilita el valor para la cuenta.

--disable

(Opcional) Inhabilita el valor para la cuenta.

--status

(Opcional) Muestra si el valor está habilitado para la cuenta.

Ejemplos

Habilite las métricas de plataforma para su cuenta utilizando la opción --enable.

ibmcloud cr platform-metrics --enable

Salida

El comando del ejemplo devuelve el siguiente resultado:

OK

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--enable

(Opcional) Impedir envíos o extracciones de imágenes sobre conexiones de red pública para la cuenta.

--disable

(Opcional) Restablecer envíos o extracciones de imágenes sobre conexiones de red pública para la cuenta.

--status

(Opcional) Comprobar si se impide el uso de conexiones públicas para envíos o extracciones de imágenes en su cuenta.

Ejemplos

Evite que su cuenta reciba o envíe imágenes a través de conexiones de red públicas utilizando la opción --enable.

ibmcloud cr private-only --enable

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Muestre sus cuotas de tráfico y almacenamiento en formato JSON introduciendo json como opción de salida.

ibmcloud cr quota -o json

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para configurar Container Registry.

Opciones de comando

--traffic TRAFFIC

(Opcional) Cambia su cuota de tráfico al valor que especifique en megabytes. La operación falla si no está autorizado a establecer cuotas de tráfico, o si establece un valor por encima del que permite su plan de precios actual.

--storage STORAGE

(Opcional) Cambia su cuota de almacenamiento al valor que especifique en megabytes. La operación falla si no está autorizado a establecer cuotas de almacenamiento, o si establece un valor por encima del que permite su plan de precios actual.

Ejemplos

Establece tu límite de cuota para el tráfico pull en 7000 megabytes y el almacenamiento en 600 megabytes introduciendo 7000 como cuota de tráfico y 600 como cuota de almacenamiento.

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

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Ejemplos

Averigüe a qué región y registro se dirige.

ibmcloud cr region

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Argumentos de mandato

REGION

(Opcional) El nombre de tu región de destino, por ejemplo us-south. Para obtener más información, consulte Regiones.

Ejemplos

Seleccione la región de Dallas introduciendo us-south como región.

ibmcloud cr region-set us-south

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--output json, -o json

(Opcional) Mostrar la salida de la lista en formato JSON.

Ejemplos

Enumere las políticas de retención de su cuenta en formato JSON introduciendo json como salida.

ibmcloud cr retention-policy-list -o json

Salida

El comando del ejemplo devuelve el siguiente resultado:

{
	"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
	}
}

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

NAMESPACE

El espacio de nombres del que desea crear una política.

Opciones de comando

--retain-untagged

(Opcional) Retiene todas las imágenes sin etiquetar cuando se procesa la política de retención. Solo se analizan las imágenes etiquetadas y, si las imágenes no cumplen los criterios, se suprimen. Si no se especifica la opción, se analizan todas las imágenes etiquetadas y sin etiquetar, y si las imágenes no cumplen los criterios, se suprimen.

--deletion-threshold-days

(Opcional) Establece la antigüedad mínima, en días, que debe tener una imagen antes de que la política de retención pueda eliminarla. Las imágenes más recientes que « DAYS » siempre se conservan, incluso si al conservarlas se supera el número de imágenes especificado en « --images ». « DAYS » debe ser un número entero positivo. El valor por defecto es « 0 », lo que significa que no se aplica ningún umbral.

--force, -f

(Opcional) Forzar la ejecución del mandato sin que el usuario lo solicite.

--images

Determina cuántas imágenes se deben guardar dentro de cada repositorio en el espacio de nombres especificado. Se retienen las imágenes más nuevas. La antigüedad de las imágenes la determina su fecha de creación. IMAGE_COUNT es el número de imágenes que desea mantener en cada repositorio para el espacio de nombres. Para restablecer una política a su estado predeterminado, en el que todas las imágenes se mantienen configuradas IMAGE_COUNT en All.

Ejemplo 1

Establezca una política que conserve las 20 imágenes más recientes de cada repositorio en el espacio de nombres birds introduciendo 20 como número de imágenes a conservar y birds como espacio de nombres. Analizar todas las imágenes etiquetadas y sin etiquetar; si las imágenes no cumplen los criterios, se eliminan.

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

Resultado para el ejemplo 1

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Establece una política que conserve las 10 imágenes más recientes de cada repositorio del espacio de nombres birds, pero que proteja de la eliminación cualquier imagen con menos de 90 días de antigüedad, incluso si el número de imágenes conservadas supera las 10.

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

Salida para el ejemplo 2

El comando del ejemplo 2 devuelve el siguiente resultado:

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

Ejemplo 3

Revertir la política al estado por defecto para mantener todas las imágenes en el espacio de nombres birds introduciendo All como número de imágenes a mantener y birds como espacio de nombres.

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

Resultado del ejemplo 3

El comando del ejemplo 3 devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

NAMESPACE

El espacio de nombres que desea limpiar.

Opciones de comando

--force, -f

(Opcional) Forzar la ejecución del mandato sin que el usuario lo solicite.

--output json, -o json

(Opcional) Genera JSON que contiene los resultados de limpiar el espacio de nombres. Esta opción se tiene que utilizar con --force.

--retain-untagged

(Opcional) Retiene todas las imágenes sin etiquetar cuando se procesa la política de retención. Solo se analizan las imágenes etiquetadas y, si las imágenes no cumplen los criterios, se suprimen. Si no se especifica la opción, se analizan todas las imágenes etiquetadas y sin etiquetar, y si las imágenes no cumplen los criterios, se suprimen.

--deletion-threshold-days

(Opcional) Establece la antigüedad mínima, en días, que debe tener una imagen para que el proceso de retención pueda eliminarla. Las imágenes más recientes que « DAYS » siempre se conservan, incluso si al conservarlas se supera el número de imágenes especificado en « --images ». « DAYS » debe ser un número entero positivo. El valor por defecto es « 0 », lo que significa que no se aplica ningún umbral.

--images

Determina cuántas imágenes se deben guardar dentro de cada repositorio en el espacio de nombres especificado. Se retienen las imágenes más nuevas. La antigüedad de las imágenes la determina su fecha de creación. IMAGE_COUNT es el número de imágenes que desea mantener en cada repositorio para el espacio de nombres.

Ejemplos

Conserve las 20 imágenes más recientes de cada repositorio en el espacio de nombres birds introduciendo 20 como número de imágenes a conservar y birds como espacio de nombres.

ibmcloud cr retention-run --images 20 birds

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Opciones de comando

--restrict NAMESPACE

(Opcional) Limita la salida para que muestre solamente las imágenes del espacio de nombres especificado.

--output json, -o json

(Opcional) Genera una salida JSON que contiene detalles del contenido de la papelera.

Ejemplos

Muestra las imágenes que están en la papelera en el espacio de nombres birds introduciendo birds como restricción.

ibmcloud cr trash-list --restrict birds

Salida

El comando del ejemplo devuelve el siguiente resultado:

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

Ejemplos

Averigüe qué versión de Vulnerability Advisor está utilizando.

ibmcloud cr va-version

Salida

El comando del ejemplo devuelve el siguiente resultado:

You are targeting Vulnerability Advisor version 'v4'.
OK

Argumentos de mandato

VERSION

(Opcional) La versión de Vulnerability Advisor que desee utilizar. El único valor válido es v4. Si no VERSION se especifica, el valor por defecto es v4.

Ejemplos

Ajuste la versión de Vulnerability Advisor a la versión 4 introduciendo v4 como versión:

ibmcloud cr va-version-set v4

Salida

El comando del ejemplo devuelve el siguiente resultado:

You are targeting Vulnerability Advisor version 'v4'.
OK

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulta Roles de acceso para utilizar Container Registry.

Argumentos de mandato

IMAGE

El nombre de la imagen de la que desea obtener un informe. El informe indica si la imagen tiene vulnerabilidades de empaquetamiento conocidas. Puede solicitar informes para varias imágenes al mismo tiempo creando una lista de cada imagen en el mandato con un espacio entre cada nombre.

Para encontrar los nombres de sus imágenes, ejecute ibmcloud cr image-list. Combine el contenido de la columna Repositorio (repository) y la columna Etiqueta (tag) separados por dos puntos (:) para crear el nombre de imagen en el formato repository:tag. Si no se especifica una etiqueta en el nombre de la imagen, el informe evalúa la imagen que está etiquetada como latest.

Para obtener más información sobre las imágenes base de Docker soportadas, consulte Paquetes vulnerables.

Para obtener más información, consulte Gestión de la seguridad de imágenes con Vulnerability Advisor.

Opciones de comando

--extended, -e

(Opcional) La salida del mandato muestra información adicional sobre arreglos para paquetes vulnerables.

--vulnerabilities, -v

(Opcional) La salida del mandato se restringe para mostrar solo vulnerabilidades.

--output FORMAT, -o FORMAT

(Opcional) La salida del mandato se devuelve en el formato elegido. El formato predeterminado es text.

Se admiten los formatos siguientes:

• text
• json

Ejemplos

Vea un informe estándar de evaluación de vulnerabilidades para la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Visualice un informe de evaluación de vulnerabilidades que muestre las vulnerabilidades de la imagen us.icr.io/birds/bluebird:1 en formato JSON utilizando la opción -- vulnerabilities, e introduciendo json como formato de salida y us.icr.io/birds/bluebird:1 como imagen.

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

Ejemplo 1

Vea un informe estándar de evaluación de vulnerabilidades para la imagen us.icr.io/birds/bluebird:1 introduciendo us.icr.io/birds/bluebird:1 como imagen.

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

Resultado para el ejemplo 1

El comando del ejemplo 1 devuelve el siguiente resultado:

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

Ejemplo 2

Visualice un informe de evaluación de vulnerabilidades que muestre las vulnerabilidades de la imagen us.icr.io/birds/bluebird:1 en formato JSON utilizando la opción -- vulnerabilities, e introduciendo json como formato de salida y us.icr.io/birds/bluebird:1 como imagen.

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

Salida para el ejemplo 2

El comando del ejemplo 2 devuelve el siguiente resultado:

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