IBM Cloud Docs
Acerca de Container Registry

Acerca de Container Registry

Utilice IBM Cloud® Container Registry para almacenar y acceder a las imágenes de contenedor privadas en una arquitectura altamente disponible y escalable.

IBM Cloud Container Registry proporciona un registro de imágenes privado, cifrado, multiarrendatario, escalable y de alta disponibilidad que IBM aloja y gestiona. Puede utilizar Container Registry configurando su propio espacio deUna serie de repositorios que almacenan imágenes en un registro. Un espacio de nombres se asocia a una cuenta de IBM Cloud, que puede incluir varios espacios de nombres. nombres de imagen y enviando imágenes de contenedor a su espacio de nombres.

Diagrama que muestra cómo IBM Cloud Container Registry interactúa con las imágenes.
Cómo interactúa Container Registry con las imágenes

Una imagen de Docker es la base para todos los contenedores que cree. Una imagen se crea a partir de un DockerfileUn archivo de texto que contiene instrucciones para crear una imagen de Docker., que es un archivo que contiene instrucciones sobre cómo construir la imagen. Un Dockerfile puede hacer referencia a artefactos de compilación en sus instrucciones que se almacenan por separado, como una aplicación, la configuración de la aplicación y sus dependencias. Las imágenes suelen almacenarse en un registro que puede ser accesible al público (registro público) o configurarse con acceso limitado para un grupo de usuarios (registro privado). Mediante Container Registry, sólo los usuarios con acceso a su cuenta de IBM Cloud pueden acceder a sus imágenes.

Al enviar imágenes por push a Container Registry, se beneficia de las características integradas de Vulnerability Advisor, que realizan exploraciones en busca de posibles problemas de seguridad y vulnerabilidades. Vulnerability Advisor comprueba si hay paquetes vulnerables en determinadas imágenes básicas de Docker y vulnerabilidades conocidas en los valores de configuración de las apps. Cuando se encuentran vulnerabilidades, se proporciona información acerca de las mismas. Puede utilizar esta información para resolver problemas de seguridad, de forma que no se desplieguen contenedores a partir de imágenes vulnerables.

Revise la siguiente tabla para obtener una visión general de las ventajas de utilizar Container Registry.

Container Registry beneficios
Beneficio Descripción
Registro privado escalable y de alta disponibilidad. Configure su propio espacio de nombres de imágenes en un registro privado cifrado, escalable, de alta disponibilidad y multiinquilino alojado y gestionado por IBM.

Almacena tus imágenes privadas de Docker y compártelas con los usuarios de tu cuenta de IBM Cloud.

Conformidad con la seguridad de imágenes con Vulnerability Advisor. Benefíciese de la exploración automática de imágenes en el espacio de nombres.

Revise las recomendaciones específicas del sistema operativo para solucionar posibles vulnerabilidades y proteger la seguridad de los contenedores.

Límites de almacenamiento para almacenamiento y tráfico de extracción. Aproveche las ventajas del almacenamiento gratuito y del tráfico de extracción de sus imágenes privadas hasta alcanzar su cuota gratuita.

Configure límites de cuota personalizados para la cantidad de almacenamiento y tráfico de extracción mensual para no superar el nivel de pago elegido.

Planes de servicio

Existe la posibilidad de elegir entre los planes de servicio de Container Registry estándar o gratuitos para almacenar las imágenes de Docker y hacer disponibles estas imágenes para los usuarios de su cuenta de IBM Cloud.

El plan de servicio de IBM Cloud Container Registry determina la cantidad de almacenamiento y tráfico de extracción que puede utilizar para las imágenes privadas. El plan de servicio está asociado a su cuenta de IBM Cloud y los límites para el almacenamiento y el tráfico de extracción de imágenes se aplican a todos los espacios de nombres que haya configurado en su cuenta.

Los planes de servicio se aplican a la instancia de registro específica (uno de los registros regionales o el registro global) con la que esté trabajando en ese momento. Todos los valores del plan se deben gestionar por separado para su cuenta en cada instancia de registro. Para obtener más información, consulte Regiones.

La tabla siguiente muestra los planes de servicio de IBM Cloud Container Registry disponibles y sus características. Para obtener más información sobre cómo funciona la facturación y qué sucede cuando se superan los límites del plan de servicios, consulte Límites de cuota y facturación.

Container Registry planos
Características Gratuito Standard
Descripción. Pruebe Container Registry para almacenar y compartir las imágenes de Docker. Este plan es el plan de servicio predeterminado cuando configura el primer espacio de nombres en Container Registry. Aproveche el uso ilimitado de almacenamiento y tráfico de extracción para gestionar las imágenes de Docker para todos los espacios de nombres de su cuenta de IBM Cloud.
Cantidad de almacenamiento para las imágenes. 500 MB Ilimitado
Tráfico de extracción. 5 GB por mes Ilimitado
Facturación. Si supera los límites de almacenamiento o los límites de extracción de tráfico, no puede enviar por push ni extraer imágenes a y desde el espacio de nombres. Para obtener más información, consulte Límites de cuota y facturación. Almacenamiento. Se le facturará por Gigabyte-mes de uso. Los primeros 0,5 GB-mes son gratuitos. A continuación, se le cobrará según lo indicado en la página de detalles de la oferta, véase Container Registry.

Atrae el tráfico. Se le facturará por Gigabyte uso mensual. Los primeros 5 GB son gratuitos. A continuación, se le cobrará tal como se indica en la página de detalles de la oferta, consulte Container Registry. Si supera los límites de almacenamiento o los límites de extracción de tráfico, no puede enviar por push ni extraer imágenes a y desde el espacio de nombres. Para obtener más información sobre el almacenamiento, el tráfico de extracción y el estimador de costes, consulte Límites de cuota y facturación.

Límites de cuota y facturación

Encontrará información y ejemplos sobre el funcionamiento del proceso de facturación y los límites de cuota en Container Registry.

Cada imagen se crea a partir de un número de capas, cada una de las cuales representa un cambio incremental con respecto a la imagen base. Cuando transfiere o extrae una imagen, la cantidad de almacenamiento y de tráfico de extracción necesaria para cada capa se añade al uso mensual. Las capas idénticas se comparten automáticamente entre las imágenes de la cuenta de IBM Cloud y se reutilizan al crear otras imágenes. El almacenamiento correspondiente a cada capa idéntica se factura una sola vez, independientemente del número de imágenes de la cuenta que hagan referencia a la capa. Las capas a las que sólo se hace referencia mediante imágenes suprimidas que están en la papelera no se cobran.

A partir del 1 de febrero de 2022, se cobra por las imágenes etiquetadas y sin etiquetar.

Los límites de cuota y la facturación se aplican a la instancia de registro específica (uno de los registros regionales o el registro global) con la que esté trabajando en ese momento. Los valores de cuota se deben gestionar por separado para su cuenta en cada instancia de registro. Para obtener más información, consulte Regiones.

Extraiga el tráfico entre los recuentos de conexiones públicas hacia el uso y la cuota. El tráfico de extracción a través de conexiones privadas no cuenta.

El siguiente ejemplo correspondiente a transferencia de imágenes:

Transfiere una imagen al espacio de nombres que se basa en la imagen Ubuntu. La imagen Ubuntu contiene varias capas. Puesto que aún no tiene estas capas en la cuenta, la cantidad de almacenamiento que necesitan dichas capas se añade a su uso mensual.

Más tarde, crea una segunda imagen que se basa en la imagen Ubuntu. Cambia la imagen base Ubuntu, por ejemplo, añade más mandatos o archivos al Dockerfile. Cada cambio representa una nueva capa de la imagen. Cuando transfiere la segunda imagen, Container Registry reconoce que todas las capas de la imagen Ubuntu base ya están almacenadas en la cuenta. No se te cobrará por almacenar estas capas por segunda vez, aunque hayas trasladado tu imagen a otro espacio de nombres. Container Registry determina las proporciones de todas las capas nuevas y añade la cantidad de almacenamiento a tu consumo mensual.

Facturación del almacenamiento y el tráfico de extracción

En función del plan de servicio que elija, se le facturará el almacenamiento y el tráfico de extracción que utilice al mes en cada región.

Cargos de almacenamiento

Cada plan de servicio de IBM Cloud Container Registry viene con una cierta cantidad de almacenamiento que puede utilizar para almacenar las imágenes de Docker en los espacios de nombres de su cuenta de IBM Cloud. Si estás en el plan estándar, se te cobrará por GB-Mes de uso. Los primeros 0.5 GB-Mes de cada mes son gratuitos. Si tienes contratado el plan gratuito, puedes almacenar tus imágenes en Container Registry de forma gratuita hasta que alcances los límites de cuota del plan gratuito. Un GB-mes es un promedio de 1 GB de almacenamiento durante un mes (730 horas).

El siguiente ejemplo correspondiente al plan estándar:

Utiliza 5 GB para exactamente la mitad del mes y entonces envía por push varias imágenes a su espacio de nombres y utiliza 10 GB el resto del mes. El uso mensual se calcula tal como se muestra en el siguiente ejemplo:

(5 GB x 0,5 (meses)) + (10 GB x 0,5 (meses)) = 2,5 + 5 = 7,5 GB-mes

En el plan estándar, los primeros 0.5 GB-Mes de cada mes son gratuitos, por lo que se le cobran 7 GB-Mes ( 7.5 GB-Mes - 0.5 GB-Mes).

Cargos de tráfico de extracción

Cada plan de servicio de IBM Cloud Container Registry incluye una cierta cantidad de tráfico de extracción gratis para las imágenes privadas almacenadas en su espacio de nombres. El tráfico de extracción es el ancho de banda que se utiliza para extraer una capa de una imagen del espacio de nombres en el sistema local. Si tienes el plan estándar, se te cobrará por GB de uso al mes. Los 5 primeros GB son gratuitos. Si estás en el plan gratuito, puedes extraer imágenes de tu espacio de nombres hasta que alcances el límite de cuota del plan gratuito.

Extraiga el tráfico entre los recuentos de conexiones públicas hacia el uso y la cuota. El tráfico de extracción a través de conexiones privadas no cuenta.

El siguiente ejemplo correspondiente al plan estándar:

En el mes, sacó imágenes que contienen capas que suman 14 GB. El uso mensual se calcula tal como se muestra en el siguiente ejemplo:

En el plan estándar, los 5 primeros GB al mes son gratuitos, por lo que se le facturan 9 GB (14 GB - 5 GB).

Límites de cuota para el almacenamiento y el tráfico de extracción

En función del plan de servicio que elija, puede transferir imágenes al espacio de nombres y extraer imágenes del mismo hasta alcanzar los límites de cuota específicos del plan o personalizados para cada región.

Límites de cuota de almacenamiento

Al alcanzar o superar los límites de cuota del plan, no puede enviar ninguna imagen a los espacios de nombres de la cuenta de IBM Cloud hasta que no complete una de las tareas siguientes.

El siguiente ejemplo correspondiente al plan estándar:

Su límite de cuota actual para el almacenamiento está establecido en 1 GB. Todas las imágenes privadas almacenadas en los espacios de nombres de su cuenta de IBM Cloud ya utilizan 900 MB de este almacenamiento. Tiene 100 MB de almacenamiento disponible hasta alcanzar el límite de cuota. Un usuario quiere enviar una imagen de 2 GB al ordenador local. Puesto que aún no se ha alcanzado el límite de cuota, Container Registry permite que el usuario transfiera esta imagen.

Tras el push, Container Registry determina las proporciones reales de la imagen en su espacio de nombres, que pueden variar de las proporciones en su ordenador local, y comprueba si se ha alcanzado el límite de almacenamiento. En este ejemplo, el uso de almacenamiento aumenta de 900 MB a 2 GB. Como el límite de cuota actual está establecido en 1 GB, Container Registry le impide transferir más imágenes al espacio de nombres.

Límites de cuota de tráfico de extracción

Al alcanzar o superar los límites de cuota del plan, no puede extraer ninguna imagen de los espacios de nombres de la cuenta de IBM Cloud hasta que no complete una de las tareas siguientes.

Extraiga el tráfico entre los recuentos de conexiones públicas hacia el uso y la cuota. El tráfico de extracción a través de conexiones privadas no cuenta.

El siguiente ejemplo correspondiente al plan estándar:

En el mes, el límite de cuota para el tráfico de extracción está establecido en 5 GB. Ya ha extraído imágenes de los espacios de nombres y ha utilizado 4,5 GB de este tráfico de extracción. Tiene 0,5 GB de tráfico de extracción disponible hasta alcanzar el límite de cuota. Un usuario quiere extraer una imagen de 1 GB de su espacio de nombres. Puesto que aún no se ha alcanzado el límite de cuota, Container Registry permite que el usuario extraiga esta imagen.

Una vez extraída la imagen, Container Registry determina el ancho de banda que ha utilizado durante la extracción y comprueba si se ha alcanzado el límite del tráfico de extracción. En este ejemplo, el uso del tráfico de extracción ha aumentado de 4,5 GB a 5,5 GB. Como el límite de cuota actual está establecido en 5 GB, Container Registry le impide extraer imágenes del espacio de nombres.

Coste de Container Registry

Puede ver los costes de IBM Cloud Container Registry en la sección de planes de precios de la página de detalles de la oferta, consulte Container Registry.

Actualización del plan de servicio

Puede actualizar el plan de servicio para beneficiarse del uso ilimitado de almacenamiento y tráfico de extracción para gestionar las imágenes de Docker para todos los espacios de nombres de su cuenta de IBM Cloud.

Si desea conocer el plan de servicio que tiene para la región de registro que está estableciendo como destino, ejecute el mandato ibmcloud cr plan.

Para actualizar el plan de servicio, siga estos pasos.

  1. Inicie sesión en IBM Cloud.

    ibmcloud login
    

    Si tiene un ID federado, utilice ibmcloud login --sso para iniciar la sesión en la CLI de IBM Cloud. Especifique el nombre de usuario y utilice el URL proporcionado en su salida de CLI para recuperar el código de acceso de un solo uso. Si tiene un ID federado, el inicio de sesión falla sin la opción --sso y funciona correctamente con la opción --sso.

  2. Establezca como destino la región cuyo plan desea actualizar.

    ibmcloud cr region-set
    

    Para obtener más información, consulte ibmcloud cr region-set y Regiones.

  3. Actualizar al plan estándar.

    ibmcloud cr plan-upgrade standard
    

    Si tiene un plan Lite de IBM Cloud, debe actualizar a una cuenta de Pago por uso o Suscripción de IBM Cloud antes de ejecutar ibmcloud cr plan-upgrade.

    Para obtener más información, consulte ibmcloud cr plan-upgrade.

Términos que se utilizan en IBM Cloud Container Registry

Información sobre los términos que se utilizan en IBM Cloud Container Registry.

Para más información sobre términos específicos de Docker, consulte el glosario de Docker.

Imagen de contenedor

Sistema de archivos y sus parámetros de ejecución que se utilizan dentro de un tiempo de ejecución de contenedor para crear un contenedor. El sistema de archivos consta de una serie de capas, que se combinan en tiempo de ejecución, que se crean a medida que la imagen de contenedor se construye mediante actualizaciones sucesivas. La imagen del contenedor no conserva su estado mientras se ejecuta el contenedor.

Las imágenes de contenedor se almacenan en un repositorio que se almacena en un espacio de nombres.

Digest

Los resúmenes se utilizan como referencias inmutables a diversos objetos del registro como, por ejemplo, manifiestos de imagen, capas y artículos de configuración.

En el contexto del registro, un resumen de imagen es una referencia inmutable a una imagen que identifica una imagen utilizando el hash sha256 del manifiesto de imagen. Puede utilizar un resumen de imagen para asegurarse de que siempre hace referencia a la misma versión de una imagen. Utilice el formato largo del resumen de la imagen para trabajar con imágenes, por ejemplo, para extraer, enviar y suprimir imágenes.

Para buscar el resumen de la imagen, ejecute el mandato ibmcloud cr image-digests. El mandato ibmcloud cr image-list también devuelve el resumen de la imagen, pero, de forma predeterminada, está en un formato truncado. Puede añadir una opción al mandato ibmcloud cr image-list para devolver el resumen de imagen en el formato largo.

Cuando utilice el resumen de la imagen para identificar una imagen, utilice siempre el formato largo.

En Container Registry, cualquier referencia a "resumen" significa "resumen de imagen".

Dockerfile

Un Dockerfile es un archivo de texto que contiene instrucciones sobre cómo crear una imagen de Docker.

Típicamente, una imagen de contenedor se crea sobre una imagen base que contiene un sistema operativo base, como Ubuntu. Puede cambiar esta imagen base incrementalmente con las instrucciones del Dockerfile para definir el entorno en que la app necesita ejecutarse. Cada cambio de la imagen base describe una nueva capa de la imagen, y puede realizar varios cambios en una sola línea de Dockerfile. Las instrucciones de un Dockerfile también pueden hacer referencia a artefactos de compilación que se almacenan por separado, como una aplicación, la configuración de la aplicación y sus dependencias. Para obtener más información sobre Dockerfile, consulte la referencia Dockerfile.

Imágenes de contenedor de Docker V2

Una imagen de contenedor que cumple la especificación Image Manifest Version 2, Schema 2.

El tipo de soporte para Docker Image Manifest V2, Schema 2 es application/vnd.docker.distribution.manifest.v2+json y el tipo de soporte para la lista de manifiesto es application/vnd.docker.distribution.manifest.list.v2+json. Una imagen de contenedor de Docker V2 es un tipo de imagen de contenedor OCI. Para obtener más información sobre el soporte para Docker, consulte Docker.

Nombre de dominio

El nombre de un sistema host. Un nombre de dominio consta de una secuencia de subnombres que están separados por un carácter delimitador, por ejemplo, www.ibm.com.

Los nombres de dominio que Container Registry utiliza están en el formato us.icr.io. Los nombres de dominio anteriores que Container Registry utilizaba están en el formato registry.ng.bluemix.net. Ambos formatos de nombre de dominio hacen referencia al mismo registro y contenido. El servicio Container Registry responde a nombres de dominio anteriores y canónicos por igual. Puede enviar o extraer imágenes utilizando indistintamente cualquiera de los dos nombres de dominio.

El nombre de dominio sólo es significativo en las situaciones siguientes:

  • Cuando Kubernetes está seleccionando un secreto de extracción, elige uno que coincida con el nombre de dominio.
  • Cuando ibmcloud cr login le ayuda a iniciar sesión, utiliza nombres de dominio sólo en el formato us.icr.io.
  • Cuando las imágenes están firmadas, la firma incluye el nombre de dominio que se ha utilizado en el momento de la firma.

Para obtener más información sobre los nombres de dominio que utiliza Container Registry, consulte Regiones.

Manifiesto de imagen

Un manifiesto de imagen es un documento .json que hace referencia al objeto de configuración y a las capas de imagen necesarias para extraer y ejecutar la imagen. El hash sha256 del manifiesto de imagen es el resumen, que se utiliza para identificar la imagen. Puede ver el manifiesto de la imagen ejecutando el mandato ibmcloud cr manifest-inspect.

Imágenes de contenedor OCI

Una imagen contenedora que cumple con la especificación OCI Image Format.

El tipo de medio para las imágenes de contenedor OCI es application/vnd.oci.image.manifest.v1+json.

Registry

Un servicio de almacenamiento y distribución de imágenes de contenedor público o privado.

Se proporciona almacenamiento para imágenes de contenedor OCIUna imagen de contenedor que cumple con la especificación de formato de imagen OCI (también conocidas como imágenes de contenedor de intercambio de objetos Docker). Los clientes de OCI que utilizan el nombre de dominio de registro apropiado pueden acceder a las imágenes de contenedor OCI o "extraerlas". Cualquier persona puede acceder a las imágenes de contenedor (imágenes públicas) o el acceso puede limitarse a un grupo (imágenes privadas). Container Registry proporciona un registro de imágenes privadas, de varios arrendatarios y alta disponibilidad que aloja y gestiona IBM. Puede utilizar el registro añadiendo un espacio de nombres privado a su cuenta y luego enviar por push imágenes a su espacio de nombres.

Espacio de nombres de registro

Una carpeta que contiene carpetas o repositorios que almacenan sus imágenes de contenedor en Container Registry. El espacio de nombres del registro está asociado a la cuenta de IBM Cloud. Puede tener varios espacios de nombres de registro en una cuenta.

Cuando configura su propio espacio de nombres en Container Registry, el espacio de nombres se añade al registro URL <region>.icr.io/<my_namespace>, donde <region> es la región y <my_namespace> es su espacio de nombres. El espacio de nombres debe ser exclusivo en todas las cuentas de IBM Cloud de la misma región. Todos los usuarios de su cuenta IBM Cloud que dispongan de los permisos IAM correctos pueden ver y trabajar con las imágenes almacenadas en su espacio de nombres de registro.

Puede tener 100 espacios de nombres en cada región.

Los espacios de nombres se crean en un grupo de recursos que usted especifica para poder configurar el acceso a los recursos dentro del espacio de nombres a nivel de grupo de recursos. Si no especifica un grupo de recursos y no se apunta a un grupo de recursos, se utiliza el grupo de recursos predeterminado. Si tiene un espacio de nombres antiguo que no está en un grupo de recursos, puede asignarlo a un grupo de recursos y luego establecer permisos para ese espacio de nombres a nivel de grupo de recursos. Para obtener más información sobre grupos de recursos, consulte Asignación de espacios de nombres existentes a grupos de recursos.

Los espacios de nombres asignados a un grupo de recursos se muestran en la página Lista de recursos de la consola de IBM Cloud.

Repositorio

Almacena una colección de imágenes de contenedor relacionadas. Un repositorio se almacena en un espacio de nombres. Las imágenes contenedoras se distinguen únicamente por la etiqueta o el resumen. El término repositorio se utiliza a menudo indistintamente con imagen de contenedor, pero un repositorio contiene potencialmente múltiples variantes etiquetadas de una imagen de contenedor.

Etiqueta

Un identificador que está conectado a imágenes de contenedor en un repositorio. Las etiquetas se pueden reasignar o suprimir de las imágenes.

Puede utilizar etiquetasUn identificador definido por el usuario adjunto a una agrupación de recursos que están contenidos en una cuenta. Las etiquetas son visibles en toda la cuenta. para distinguir diferentes versiones de la misma imagen base dentro de un repositorio. Cuando ejecuta un mandato de Docker y no especifica la etiqueta de una imagen del repositorio, se utilizará de forma predeterminada la imagen con la etiqueta latest.

Imagen sin etiquetar

Una imagen que no tiene ninguna etiqueta es una imagen sin etiquetar. Se puede hacer referencia a las imágenes que no están etiquetadas utilizando el formato de referencia de resumen <repository>@<digest> en lugar del formato de referencia de etiqueta <repository>:<tag>. Las imágenes sin etiquetar suelen ser el resultado de una imagen que se envía con una combinación de <repository>:<tag> preexistente. En este caso, la etiqueta se sobrescribe y la imagen original pasa estar no etiquetada.

Puede visualizar imágenes sin etiquetar mediante el mandato ibmcloud cr image-digests y limpiar imágenes sin etiquetar mediante el mandato ibmcloud cr image-prune-untagged.

Regiones

La instancia predeterminada de Container Registry es el registro global. El registro global no incluye una región en su nombre de dominio (icr.io).

Utilice la instancia global del registro a menos que tenga un requisito específico, por ejemplo, la soberanía de datos, para almacenar sus datos en una región determinada. En este caso, puede utilizar Container Registry en regiones locales.

Cada región está respaldada en una región diferente. Por ejemplo, las imágenes que se almacenan en el registro IBM Cloud Container Registry Frankfurt(eu-de) se replican en los seis centros de datos de las regiones Frankfurt(eu-de) y London(eu-gb).

La siguiente tabla muestra las ubicaciones de las copias de seguridad. Para obtener más información sobre las ubicaciones de copia de seguridad de Container Registry, consulte ¿El servicio replica los datos? para obtener ayuda.

Ubicaciones de copia de seguridad
Entorno Entorno que antes se conocía como Ubicación activa Ubicación de copia de seguridad
au-syd ap-south au-syd jp-tok
br-sao No aplicable br-sao us-south
ca-tor No aplicable ca-tor us-east (valores de servicio y política)

ca-mon (imágenes)

eu-de eu-central eu-de eu-gb
eu-es No aplicable eu-es eu-de
eu-gb uk-south eu-gb eu-de
global No aplicable us-east us-south
jp-osa No aplicable jp-osa jp-tok
jp-tok ap-north jp-tok au-syd
us-south No aplicable us-south us-east

Todos los artefactos de registro se refieren a la instancia de registro específica (uno de los registros regionales o el registro global) con la que esté trabajando en ese momento. Por ejemplo, los espacios de nombres, las imágenes, los valores de cuota y los valores del plan deben gestionarse por separado para su cuenta en cada instancia de registro.

Registro global

Hay disponible un registro global. El registro global no incluye una región en su nombre (icr.io). Además de alojar espacios de nombres de usuario e imágenes, este registro también aloja imágenes públicas proporcionadas por IBM.

La instancia global de Container Registry está disponible utilizando los nombres de dominio que se muestran en la tabla siguiente.

Nombre de dominio para el registro mundial
Registry Nombre de dominio Nombre de dominio privado Nombre de dominio en desuso
Global icr.io private.icr.io registry.bluemix.net

Para obtener información sobre cómo conectarse a Container Registry utilizando los nombres de dominio privados, consulte Utilización de conexiones de red privadas.

Los nombres de dominio bluemix.net existentes están en desuso, pero por ahora puede seguir usándolos. Todavía no hay una fecha de fin de soporte disponible.

Establecer como destino el registro global

Puede acceder al registro global ejecutando el mandato ibmcloud cr region-set.

  1. Para dirigirse al registro global, ejecute el mandato siguiente.

    ibmcloud cr region-set global
    
  2. Para registrar el daemon de Docker local en el registro global, ejecute el mandato ibmcloud cr login.

    Container Registry da soporte a otros clientes, así como a Docker. Para iniciar sesión utilizando otros clientes, consulte Acceso interactivo a los espacios de nombres.

Regiones locales

Las instancias regionales de Container Registry están disponibles utilizando los nombres de dominio que se muestran en la tabla siguiente.

Nombres de dominio para regiones locales
Región de registro local Región que antes se conocía como Nombre de dominio Nombre de dominio privado Nombre de dominio en desuso
au-syd ap-south au.icr.io private.au.icr.io registry.au-syd.bluemix.net
br-sao No aplicable br.icr.io private.br.icr.io No aplicable
ca-tor No aplicable ca.icr.io private.ca.icr.io No aplicable
eu-de eu-central de.icr.io private.de.icr.io registry.eu-de.bluemix.net
eu-es No aplicable es.icr.io private.es.icr.io No aplicable
eu-gb uk-south uk.icr.io private.uk.icr.io registry.eu-gb.bluemix.net
jp-osa No aplicable jp2.icr.io private.jp2.icr.io No aplicable
jp-tok ap-north jp.icr.io private.jp.icr.io No aplicable
us-south No aplicable us.icr.io private.us.icr.io registry.ng.bluemix.net

Para obtener información sobre cómo conectarse a Container Registry utilizando los nombres de dominio privados, consulte Utilización de conexiones de red privadas.

Los nombres de dominio bluemix.net existentes están en desuso, pero por ahora puede seguir usándolos. Todavía no hay una fecha de fin de soporte disponible.

Establecer como destino una región local

Si desea utilizar una región diferente a su región local, puede acceder a la región que desea, si ejecuta el mandato ibmcloud cr region-set. Puede ejecutar el mandato sin opciones para obtener una lista de regiones disponibles, o puede especificar la región como una opción.

  1. Para ejecutar el mandato con opciones, sustituya REGION por el nombre de región.

    ibmcloud cr region-set REGION
    

    Por ejemplo, para seleccionar la región eu-de, ejecute el siguiente comando.

    ibmcloud cr region-set eu-de
    
  2. Para registrar el daemon de Docker local en el registro para que pueda enviar o extraer imágenes, ejecute el mandato ibmcloud cr login.

    Container Registry da soporte a otros clientes, así como a Docker. Para iniciar sesión utilizando otros clientes, consulte Acceso interactivo a los espacios de nombres.

Clientes admitidos

Soporte para Docker

IBM Cloud Container Registry es compatible con las versiones de Docker Engine que admite Docker.

Docker solo es necesario si desea enviar por push o extraer imágenes.

Se da soporte a las imágenes de Docker V2 esquema 2. También se da soporte a las listas de manifiesto. Para más información, consulte Compatibilidad con el registro.

Las imágenes de Docker V2 Schema 1 se retiran y ya no podrá enviarlas a Container Registry.

Apoyo a otros clientes

IBM Cloud Container Registry da soporte a versiones soportadas de clientes que son compatibles con la especificación de distribución de OCI versión 1 o posterior, como por ejemplo Buildah, Podman y Skopeo.