Conceptos de Container Registry
Descubra los conceptos clave que debe comprender antes de utilizar Container Registry.
En este tema se describen los conceptos clave que debe comprender al utilizar Oracle Cloud Infrastructure Registry (también conocido como Container Registry).
Imágenes
El registro de contenedor es un registro compatible con la iniciativa de contenedor abierta . Como resultado, puede almacenar cualquier artefacto que cumpla con las especificaciones de Open Container Initiative, como imágenes de Docker, listas de manifiestos (a veces conocidas como imágenes de arquitectura múltiple) y gráficos de Helm. En las instrucciones de esta documentación se asume que está almacenando y recuperando imágenes de contenedor de Docker mediante la CLI de Docker. Las imágenes de contenedor de Docker se denominan normalmente imágenes de Docker o simplemente imágenes.
Una imagen de Docker es una plantilla de solo lectura con instrucciones para crear un contenedor de Docker. Una imagen de Docker contiene la aplicación que desea que Docker ejecute como contenedor, junto con cualquier dependencia. Para crear una imagen de Docker, primero debe crear un archivo Dockerfile para describir esa aplicación. A continuación, cree la imagen de Docker del archivo Dockerfile. Una vez que se cree una imagen de Docker, almacénela en un registro de Docker, como Container Registry.
Su ruta de imagen y su identificador de versión pueden hacer referencia a una imagen, también denominada etiqueta de imagen.
Cuando la capacidad de nivel superior está desactivada, se puede hacer referencia a una imagen del repositorio project01/acme-web-app con la etiqueta 4.6.3 como project01/acme-web-app:4.6.3.
Cuando la capacidad de nivel superior está activada en el repositorio app, las imágenes se pueden almacenar en la ruta raíz del repositorio o en las rutas secundarias que hay debajo de ella:
Se puede hacer referencia a una imagen en la ruta raíz del repositorio
app, con la etiquetav1, comoapp:v1.Se puede hacer referencia a una imagen en la ruta secundaria
backendbajo el repositorioapp, con la etiquetav1, comoapp/backend:v1.Se puede hacer referencia a una imagen en la ruta secundaria
frontendbajo el repositorioapp, con la etiquetav1, comoapp/frontend:v1.
Todas estas imágenes pertenecen al repositorio app. Las rutas secundarias no representan recursos de repositorio independientes.
Las etiquetas tienen un ámbito para cada ruta de imagen. Por ejemplo, app/backend:latest y app/frontend:latest pueden hacer referencia a diferentes imágenes.
Para obtener más información sobre cómo se agrupan las imágenes en recursos del repositorio, consulte Repositorios.
Una imagen de Docker también se puede identificar de forma única mediante su resumen de imagen, que es un hash creado a partir del contenido y los metadatos de la imagen. A diferencia de un identificador de versión, que puede apuntar a diferentes imágenes a lo largo del tiempo, el resumen siempre hace referencia a la misma imagen exacta y garantiza despliegues consistentes.
Repositorios
Un repositorio es una recopilación con nombre de imágenes de contenedor en Container Registry. Container Registry soporta dos tipos de repositorio:
Estándar: almacena imágenes transferidas por los clientes. Los depósitos estándar pueden ser privados o públicos. Cualquier usuario con acceso a Internet y conocimiento de la URL de imagen correspondiente puede extraer imágenes de un repositorio público.
Caché de recuperación: recupera y almacena en caché las imágenes solicitadas de una ruta configurada en un registro ascendente admitido. Los repositorios de caché de transferencia son privados y no aceptan transferencias de imágenes de cliente.
La capacidad de nivel superior se puede activar al crear cualquier tipo de repositorio.
Cuando la capacidad de nivel superior está desactivada, cada nombre de repositorio completo identifica un recurso de repositorio independiente, incluso cuando los nombres comparten un prefijo. Por ejemplo, project01/acme-web-app y project01/my-test-app son repositorios independientes. Su prefijo project01/ compartido no los convierte en parte de un repositorio.
Cuando la capacidad de nivel superior está activada en el repositorio app, ese repositorio puede contener imágenes en su ruta raíz y en las rutas secundarias que hay debajo. Por ejemplo:
app:v1pertenece al repositorioappe identifica una imagen en su ruta raíz.app/backend:v1pertenece al repositorioappe identifica una imagen en la ruta secundariabackend.app/frontend:v1pertenece al repositorioappe identifica una imagen en la ruta de acceso secundariafrontend.
Estas rutas de imagen pertenecen al mismo recurso de repositorio. No crea repositorios independientes denominados app/backend o app/frontend.
Cuando la capacidad de nivel superior está activada, el nombre del repositorio debe contener un único segmento de ruta de acceso y no puede contener una barra inclinada (/). En el registro regional seleccionado, el nombre del repositorio y el prefijo formado por ese nombre seguido de / se reservan en todos los compartimentos del espacio de nombres del arrendamiento.
Por ejemplo:
Después de crear el repositorio
appcon la capacidad de nivel superior activada, no puede crear un repositorio independiente denominadoapp/backenden el mismo espacio de nombres de arrendamiento y región, independientemente del compartimento.Si ya existe un repositorio denominado
appoapp/backend, no puede crear un nuevo repositorio denominadoappcon la capacidad de nivel superior activada. La creación de un repositorio no convierte ni adopta repositorios existentes.Los nombres como
app2yapplicationno entran en conflicto conappporque no utilizan el nombre reservado ni el prefijoapp/.
Los permisos, la visibilidad y la configuración de nivel de repositorio se aplican al repositorio y a todas las imágenes que posee. Para el repositorio app con la capacidad de nivel superior activada, las mismas reglas de nivel de repositorio se aplican a las imágenes en app, app/backend y app/frontend. Las rutas de imágenes secundarias no pueden tener permisos, visibilidad ni configuración independientes a nivel de repositorio.
Puede seleccionar si desea activar la capacidad de nivel superior al crear el repositorio. No puede activarlo ni desactivarlo después de crear el repositorio.
Un repositorio de caché de recuperación es privado. Los clientes pueden extraer imágenes de él, pero no pueden transferir imágenes a él. Cuando un cliente extrae una imagen que aún no está almacenada en caché en la región del repositorio, Container Registry recupera la imagen del registro ascendente configurado mediante las credenciales ascendentes configuradas para el repositorio. Container Registry transmite la imagen al cliente mientras la almacena en caché en la región del repositorio para extracciones posteriores.
Para las extracciones por etiqueta de imagen, Container Registry comprueba el registro ascendente cuando vence la actualización de la etiqueta y actualiza la etiqueta almacenada en caché si ha cambiado. Las solicitudes disparan comprobaciones de refrescamiento; Container Registry no actualiza las etiquetas en segundo plano. Consulte Comportamiento de etiqueta y resumen para conocer los intervalos de refrescamiento y el manejo de fallos.
Los usuarios autorizados pueden realizar operaciones de gestión soportadas, incluida la actualización de credenciales ascendentes, la supresión de imágenes en caché y la creación de firmas para imágenes en caché local. La eliminación de una imagen almacenada en caché no elimina la imagen del registro ascendente. Las firmas creadas para las imágenes almacenadas en caché se almacenan localmente y no se agregan al registro ascendente.
Existe un repositorio dentro de un arrendamiento, una región y un compartimento concretos. Al hacer referencia al arrendamiento al que pertenece un repositorio, debe especificar el espacio de nombres del arrendamiento. El espacio de nombres del arrendamiento es una cadena aleatoria de caracteres alfanuméricos generada automáticamente. Por ejemplo, el espacio de nombres del arrendamiento acme-dev puede ser ansh81vru1zp. Tenga en cuenta que para algunos arrendamientos más antiguos, la cadena de espacios de nombres puede ser la misma que el nombre del arrendamiento en letras minúsculas (por ejemplo, acme-dev). Para averiguar el espacio a nombre del arrendamiento actual, abra el menú Perfil
y seleccione Arrendamiento.
Debe pertenecer al grupo Administradores del arrendamiento o haber obtenido el permiso REPOSITORY_MANAGE para:
- crear un repositorio público nuevo
- cambiar un repositorio existente por un repositorio público
- cambiar un repositorio público existente por un repositorio privado
El acceso a un repositorio privado se controla mediante políticas de IAM. Los usuarios pueden realizar las operaciones soportadas para las que están autorizados actualmente. Utilice políticas de IAM para otorgar a otros usuarios el acceso necesario al repositorio.
Para un repositorio estándar, normalmente creará un repositorio vacío en un compartimento y asignará un nombre al repositorio antes de transferir cualquier imagen (por ejemplo, project01/acme-web-app). Si pertenece al grupo Administradores del arrendamiento o se le ha otorgado el permiso REPOSITORY_MANAGE, también puede especificar si el repositorio va a ser privado o público (consulte Políticas para controlar el acceso al repositorio). Una vez creado el repositorio, las imágenes que se transfieren posteriormente a Container Registry que incluyen el nombre del repositorio se transfieren a ese repositorio.
Por ejemplo, por comodidad, puede querer agrupar varias versiones de una imagen en el arrendamiento acme-dev de la región Ashburn en el repositorio denominado project01/acme-web-app. En primer lugar, cree el repositorio project01/acme-web-app. A continuación, incluya el nombre del repositorio al transferir la imagen, con el formato <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. Por ejemplo, ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:4.6.3.
Tenga en cuenta que la creación de un repositorio vacío antes de transferir una imagen es casi seguro que será su flujo de trabajo normal. Y si solo está autorizado a gestionar repositorios en compartimentos y no en el compartimento raíz del arrendamiento, siempre tendrá que crear un repositorio antes de transferir una imagen. Sin embargo, si está en la posición inusual de intentar transferir imágenes al compartimento raíz, no es estrictamente necesario crear un repositorio vacío con antelación. Para obtener más información, consulte Creación de un repositorio.
Resumen de terminología
Al trabajar con repositorios en Container Registry, le resultará útil tener una comprensión clara de los siguientes términos y cómo se relacionan entre sí.
- ruta de acceso al repositorio
-
Una ruta de repositorio (a veces denominada
<repo-path>en esta documentación) es la ruta de acceso completa a un repositorio en Container Registry. Una ruta de acceso al repositorio tiene el formato<registry-domain>/<tenancy-namespace>/<repo-name>.Por ejemplo:
-
ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app -
iad.ocir.io/ansh81vru1zp/project01/acme-web-app -
us-phoenix-1.ocir.io/cbujx0t3wa3r/my-hello-app
-
- dominio de registro
-
Un dominio de registro de Container Registry incluye una clave de región de Container Registry o un identificador de región. Un dominio de registro de Container Registry tiene uno de los siguientes formatos:
- (recomendado)
ocir.<region-identifier>.oci.oraclecloud.com -
<region-key>.ocir.io(solo dominios OC1) -
<region-identifier>.ocir.io(solo dominios OC1)
Por ejemplo:
-
ocir.us-ashburn-1.oci.oraclecloud.com -
iad.ocir.io -
us-phoenix-1.ocir.io
Para obtener la lista de identificadores de región y claves de región, consulte Disponibilidad por región.
- (recomendado)
- identificador de región
-
Un identificador de región (a veces denominado
<region-identifier>en esta documentación) identifica la región de Container Registry que está utilizando.Por ejemplo:
-
us-ashburn-1 -
us-phoenix-1
Para obtener la lista de identificadores de región, consulte Disponibilidad por región.
-
- clave de la región
-
Una clave de región (a veces denominada
<region-key>en esta documentación) identifica la región de Container Registry que está utilizando.Por ejemplo:
-
iad -
phx
Para obtener una lista de claves de región, consulte Disponibilidad por región.
-
- espacio de nombres de arrendamiento
-
Un espacio de nombres de arrendamiento (a veces denominado
<tenancy-namespace>en esta documentación) es una cadena de caracteres alfanuméricos autogenerada, aleatoria e inmutable. Por ejemplo, el espacio de nombres del arrendamientoacme-devpuede seransh81vru1zp.Tenga en cuenta que para algunos arrendamientos más antiguos, la cadena de espacios de nombres puede ser la misma que el nombre de arrendamiento en letras minúsculas (por ejemplo,
acme-dev). Para averiguar el espacio a nombre del arrendamiento actual, abra el menú Perfil
y seleccione Arrendamiento. El espacio de nombres de arrendamiento se muestra en el campo Espacio de nombres de almacenamiento de objetos. - nombre del repositorio
-
Un nombre de repositorio (a veces denominado
<repo-name>en esta documentación) es el nombre que identifica un repositorio en Container Registry. Los nombres de repositorio son únicos en todos los compartimentos del registro regional de un arrendamiento. Un nombre puede contener caracteres de barra cuando la capacidad de nivel superior está desactivada. Cuando la capacidad de nivel superior está activada, el nombre debe contener un único segmento de ruta.Por ejemplo:
-
project01/acme-web-app -
project01/my-test-app -
my-hello-app -
project01/acme-web-app/component1 -
project01/acme-web-app/component2 -
project01/acme-web-app/component1/subcomponent1
Cuando la capacidad de nivel superior está desactivada, un nombre de repositorio puede incluir caracteres de barra inclinada (
/) y cada nombre completo identifica un repositorio independiente. Por ejemplo,project01/acme-web-appyproject01/my-test-appson repositorios independientes. Su prefijoproject01/compartido no los agrupa en un repositorio.Cuando la capacidad de nivel superior está activada en el repositorio
app, las imágenes se pueden almacenar en su ruta raíz o en rutas secundarias debajo de ella. Se hace referencia a una imagen con la etiquetav1en la raíz comoapp:v1. Se hace referencia a las imágenes con la misma etiqueta en las rutas secundariasbackendyfrontendcomoapp/backend:v1yapp/frontend:v1. Las tres imágenes pertenecen al repositorioapp;backendyfrontendson rutas de imágenes secundarias, no repositorios independientes. -
- capacidad de nivel superior
La capacidad de nivel superior permite que un repositorio de caché estándar o de extracción contenga imágenes en su ruta raíz y en rutas secundarias debajo de su nombre.
Para el repositorio
appcon la capacidad de nivel superior activada,app:v1hace referencia a una imagen en la raíz; las imágenes de referenciaapp/backend:v1yapp/frontend:v1en las rutas secundarias. Todos pertenecen al repositorioappy comparten sus permisos de nivel de repositorio, visibilidad y configuración. Las rutas secundarias no son repositorios independientes.Cuando la capacidad de nivel superior está activada, el nombre del repositorio debe contener un único segmento de ruta de acceso sin una barra diagonal (
/). Su nombre y el prefijo correspondiente, comoappyapp/, se reservan en el mismo espacio de nombres y región del arrendamiento, independientemente del compartimento.La capacidad está desactivada por defecto. Solo se puede activar al crear el repositorio y después no se puede cambiar la configuración.
- tipo de repositorio
El tipo de repositorio determina cómo se agregan las imágenes al repositorio:
Estándar: almacena imágenes transferidas por los clientes. Los depósitos estándar pueden ser privados o públicos.
Caché de recuperación: recupera imágenes de un registro ascendente configurado cuando los clientes las extraen y las almacenan en caché en la región del repositorio. Los repositorios de caché de transferencia son privados y no aceptan transferencias de imágenes de cliente.
- registro ascendente
El registro ascendente es el registro de origen con el que Container Registry se pone en contacto para recuperar imágenes para un repositorio de caché de recuperación o comprobar las etiquetas almacenadas en caché para las actualizaciones.
Los registros ascendentes soportados son puntos finales de Container Registry en una región de OCI diferente dentro del mismo dominio de OCI que el repositorio de caché de transferencia.
La URL de flujo ascendente configurada para el repositorio de caché de transferencia identifica el registro de origen y la ruta de acceso dentro de ese registro:
Cuando la capacidad de nivel superior está desactivada, la URL identifica una ruta de imagen ascendente exacta.
Cuando la capacidad de nivel superior está activada, la URL identifica un prefijo de ruta de acceso ascendente. Container Registry agrega la ruta secundaria solicitada a ese prefijo para localizar la imagen ascendente.
- identificador de registro
-
Un identificador de registro incluye un dominio de registro de Container Registry y un espacio de nombres de arrendamiento, con el formato
<registry-domain>/<tenancy-namespace>Por ejemplo:
-
ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp -
iad.ocir.io/ansh81vru1zp -
us-phoenix-1.ocir.io/cbujx0t3wa3r
-
- ruta de la imagen
-
Una referencia de imagen de Container Registry totalmente cualificada incluye el dominio de registro, el espacio de nombres de arrendamiento y la ruta de imagen. Puede seleccionar una imagen mediante una etiqueta (
:v1) o un resumen (@sha256:<digest>).Cuando la capacidad de nivel superior está desactivada, la ruta de imagen es el nombre del repositorio. Cuando la capacidad de nivel superior está activada, puede ser el nombre del repositorio seguido de segmentos secundarios, como
app/backend.Por ejemplo:
-
ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test -
iad.ocir.io/ansh81vru1zp/project01/acme-web-app:v2.0.test -
us-phoenix-1.ocir.io/cbujx0t3wa3r/my-hello-app:latest ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/app/backend:v1ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/app/backend@sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
-
- URI de Imagen
-
En las API de gestión de imágenes de OCI, un URI de imagen incluye el espacio de nombres del arrendamiento, la ruta de imagen y una etiqueta o resumen. No incluye el dominio de registro.
Imagen en la raíz del repositorio
Por etiqueta:
<tenancy-namespace>/<repo-name>:<version>Por resumen:
<tenancy-namespace>/<repo-name>@sha256:<digest>
Imagen en una ruta de imagen secundaria
Cuando la capacidad de nivel superior esté activada, incluya la ruta de imagen secundaria después del nombre del repositorio:
Por etiqueta:
<tenancy-namespace>/<repo-name>/<child-path>:<version>Por resumen:
<tenancy-namespace>/<repo-name>/<child-path>@sha256:<digest>
<child-path>es la ruta debajo del nombre del repositorio, comobackendobackend/api.<digest>es el valor de resumen SHA-256 hexadecimal de 64 caracteres.Por ejemplo, para el repositorio
appcon la capacidad de nivel superior activada:Imagen raíz, por etiqueta:
ansh81vru1zp/app:v1Imagen secundaria, por etiqueta:
ansh81vru1zp/app/backend:v1Imagen secundaria, por resumen:
ansh81vru1zp/app/backend@sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
El espacio de nombres y el resumen de estos ejemplos son ilustrativos. Sustituirlos por los valores de la imagen.
- Identificador de Versión
-
Un identificador de versión (a veces denominado
<version>en esta documentación) es una cadena que se utiliza para hacer referencia a una versión de imagen concreta en un repositorio conocido. Por ejemplo:-
4.6.3 -
4.6.4 -
v2.0.test
-
- nombre de imagen
-
El término "nombre de imagen" a veces se utiliza como una forma abreviada de hacer referencia a una imagen concreta en un repositorio concreto.
Cuando la capacidad de nivel superior está desactivada, un nombre de imagen tiene la estructura
<repo-name>:<version>. Por ejemplo:project01/acme-web-app:4.6.3project01/acme-web-app:4.6.4my-hello-app:latest
Cuando la capacidad de nivel superior está activada, un nombre de imagen puede identificar una imagen en la ruta raíz del repositorio o en una ruta secundaria debajo de ella:
Imagen en la raíz del repositorio:
<repo-name>:<version>Imagen en una ruta de imagen secundaria:
<repo-name>/<child-path>:<version>
Por ejemplo, cuando la capacidad de nivel superior está activada en el repositorio
app:app:v1hace referencia a una imagen con la etiquetav1en la ruta raíz del repositorio.app/backend:v1hace referencia a una imagen con la etiquetav1en la ruta secundariabackend.app/frontend:v1hace referencia a una imagen con la etiquetav1en la ruta secundariafrontend.
La ruta secundaria puede contener varios segmentos, como
backend/apienapp/backend/api:v1. Todos estos nombres de imagen hacen referencia a imágenes en el repositorioapp; las rutas secundarias no son repositorios independientes. Esta estructura de nomenclatura se aplica a los repositorios de caché estándar y de extracción con la capacidad de nivel superior activada.