Container Registry CLI

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.

Recibirá una notificación en la línea de comando cuando estén disponibles las actualizaciones de los plug-ins ibmcloud CLI y container-registry CLI. Asegúrese de mantener actualizadas sus CLI para poder utilizar todos los comandos y opciones disponibles. Si desea ver la versión actual de su complemento container-registry CLI, ejecute 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 Container Registry, consulte Gestión del acceso 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.

Ejemplo

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, consulte 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 problema, ejecute ibmcloud cr va <image>, donde <image> es el nombre de su imagen, y utilice 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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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:101010101010 introduciendo birds/bluebird@sha256:101010101010 como ámbito.

La salida incluye las exenciones correspondiente a toda la cuenta, las exenciones que se limitan al espacio de nombres birds y las exenciones que se limitan al repositorio birds/bluebird y al resumen birds/bluebird@sha256:101010101010. 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:101010101010

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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 problema para la exención del problema de seguridad que desea eliminar. Para conocer los tipos de emisión de sus exenciones, ejecute 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.

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

Requisitos previos

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

Opciones de comando

--output json, -o json

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

Ejemplo

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, consulte Roles de acceso para configurar Container Registry.

Ejemplo

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

ibmcloud cr iam-policies-enable

Ejemplo

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, consulte 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:11ab001ab10011cd1000101cd0101010001ab111100cd00ab111
us.icr.io/birds/blackbird@sha256:22ef00ef002220002gh200222000gh00ef2222000ab00222

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

Ejemplo

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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, consulte 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.

Ejemplo

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

Ejemplo

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

Ejemplo

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

Ejemplo

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

Ejemplo

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

(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.

Ejemplo

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

ibmcloud cr login --client podman

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

Ejemplo

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

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte Funciones de gestión de plataformas y Funciones 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.

Ejemplo

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, consulte Funciones de gestión de plataformas y Funciones 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.

Ejemplo

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, consulte 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.

Ejemplo

Para ver una lista de todos sus espacios de nombres, incluida la información sobre grupos de recursos y fechas de creación, utilice 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, consulte 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.

Ejemplo

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

ibmcloud cr namespace-rm birds

Requisitos previos

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

Opciones de comando

--output json, -o json

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

Ejemplo

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, consulte 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.

Ejemplo

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

ibmcloud cr plan-upgrade standard

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, consulte 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.

Ejemplo

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, consulte 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.

Ejemplo

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

Requisitos previos

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

Opciones de comando

--output json, -o json

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

Ejemplo

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, consulte 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.

Ejemplo

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

Ejemplo

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 la región de destino, por ejemplo us-south. Para obtener más información, consulte Regiones.

Ejemplo

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, consulte Roles de acceso para utilizar Container Registry.

Opciones de comando

--output json, -o json

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

Ejemplo

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": -1,
		"retain_untagged": true
	},
	"birds2": {
		"namespace": "birds2",
		"account": "",
		"images_per_repo": -1,
		"retain_untagged": true
	}
}

Requisitos previos

Para obtener más información sobre los permisos necesarios, consulte 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.

--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 devolver una política al estado predeterminado que mantiene todas las imágenes configuradas IMAGE_COUNT a 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

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

Salida para el ejemplo 2

El comando del ejemplo 2 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, consulte 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.

--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.

Ejemplo

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, consulte 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.

Ejemplo

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

Ejemplo

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

La versión de Vulnerability Advisor que desea utilizar. El único valor válido es v4.

Ejemplo

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, consulte 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