Creación de un repositorio

Descubra cómo crear un repositorio en Container Registry.

Después de crear un repositorio estándar, puede transferir una imagen al mismo mediante la interfaz de línea de comandos de Docker (consulte Transferencia de imágenes con la interfaz de línea de comandos de Docker). Las imágenes que posteriormente se transfieren al registro que incluye el mismo nombre de repositorio se agrupan en ese repositorio.

Cuando la capacidad de nivel superior está desactivada, un nombre de repositorio puede incluir caracteres de barra inclinada (/). Por ejemplo, project01/acme-web-app y project01/my-test-app son nombres válidos para repositorios independientes.

Cuando la capacidad de nivel superior está activada, el nombre del repositorio debe contener un único segmento de ruta de acceso y no puede incluir caracteres de barra inclinada (/). Por ejemplo, app es un nombre de repositorio válido, pero app/backend no lo es. Después de crear el repositorio app, las imágenes se pueden almacenar en su ruta raíz o rutas secundarias, como app:v1 y app/backend:v1. Ambos pertenecen al repositorio app.

Para obtener más información y ejemplos, consulte repository name.

Al crear un repositorio, selecciona el tipo de repositorio:

  • Estándar: soporta transferencias y recuperaciones de imágenes y almacena imágenes en la región seleccionada.

  • Caché de recuperación: repositorio privado que recupera las imágenes solicitadas de un registro de Container Registry ascendente configurado en el mismo dominio de OCI y las almacena en caché en la región seleccionada. Los clientes pueden extraer imágenes del repositorio, pero no pueden transferirlas.

Puede activar la capacidad de nivel superior al crear cualquier tipo de repositorio. Después de crear el repositorio, no puede cambiar su tipo de repositorio ni la configuración de capacidad de nivel superior.

La creación de un repositorio antes de transferir una imagen es el flujo de trabajo habitual, pero no siempre es necesario. Si no está autorizado a gestionar repositorios en el compartimento raíz del arrendamiento, siempre debe transferir una imagen a un repositorio existente. Sin embargo, si está autorizado a transferir imágenes al compartimento raíz del arrendamiento y desea hacerlo, no es necesario un repositorio existente.

Al transferir una imagen, normalmente se utiliza un comando con el formato docker push <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. Si selecciona la opción Crear repositorio al realizar la primera transferencia en el compartimento raíz y transfiere una imagen a una ruta que no pertenece a un repositorio existente, se crea automáticamente un nuevo repositorio estándar privado con la capacidad de nivel superior desactivada en el compartimento raíz del arrendamiento.

Por ejemplo, si introduce el comando docker push ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project02/acme-web-app:7.5.2 y el repositorio project02/acme-web-app no existe, se creará automáticamente en el compartimento raíz un repositorio privado denominado project02/acme-web-app.

Si la ruta de imagen pertenece a un repositorio estándar existente con la capacidad de nivel superior activada, la transferencia agrega la imagen a ese repositorio sin crear un repositorio independiente. Por ejemplo, si el repositorio estándar app tiene activada la capacidad de nivel superior, al transferir app/backend:v1 se agrega la imagen en la ruta secundaria backend en el repositorio app. No crea un repositorio denominado app/backend.

Debe pertenecer al grupo Administradores del arrendamiento o se le ha otorgado el permiso REPOSITORY_MANAGE en el arrendamiento para crear automáticamente el repositorio privado en el compartimento raíz del arrendamiento. Consulte Políticas para controlar el acceso al repositorio.

    1. En la página de lista Container Registry, seleccione Create repository. Si necesita ayuda para buscar la página de lista, consulte Listado de repositorios.
    2. Introduzca la siguiente información:
      • Crear en compartimento: compartimento en el que se va a crear el repositorio. Puede seleccionar cualquier compartimento en el que tenga permiso para trabajar.

      • Tipo de repositorio: seleccione uno de los siguientes tipos de repositorio:

        • Repositorio estándar: crea un repositorio de lectura y escritura que funciona en la región de OCI actual.

        • Repositorio de caché de recuperación: crea un repositorio privado que recupera las imágenes solicitadas de un registro de Container Registry ascendente configurado en el mismo dominio de OCI y las almacena en caché en la región de OCI actual. Los clientes pueden extraer imágenes del repositorio, pero no pueden transferirlas.

      • Si ha seleccionado Repositorio de caché de recuperación, especifique la siguiente información:

        • URL ascendente: URL que identifica el punto final de registro ascendente, el espacio de nombres de arrendamiento ascendente y la ruta de repositorio o el prefijo de ruta de acceso. El registro ascendente debe estar en una región de OCI diferente dentro del mismo dominio de OCI que el repositorio de caché de transferencia. Puede especificar la URL con o sin el esquema https://.

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

          En los siguientes ejemplos se utiliza un repositorio de caché de recuperación denominado cache. Las referencias de imágenes locales omiten el dominio de registro y el espacio de nombres de arrendamiento para facilitar la lectura.

          Ejemplos de flujo ascendente de Container Registry

          Capacidad de nivel superior desactivada/activada Detalles
          Capacidad de nivel superior desactivada

          URL ascendente: https://phx.ocir.io/<source-namespace>/team/backend

          Referencia de imagen local: cache:v1

          Referencia de imagen ascendente: phx.ocir.io/<source-namespace>/team/backend:v1

          Capacidad de nivel superior activada

          URL ascendente: https://phx.ocir.io/<source-namespace>/team

          Referencia de imagen local: cache/backend:v1

          Referencia de imagen ascendente: phx.ocir.io/<source-namespace>/team/backend:v1

          Cuando la capacidad de nivel superior está activada, también se puede utilizar un prefijo de solo espacio de nombres, como https://phx.ocir.io/<source-namespace>, para extracciones de rutas secundarias. Por ejemplo, cache/team/backend:v1 se asigna a phx.ocir.io/<source-namespace>/team/backend:v1. Con esta configuración, no se puede resolver una referencia raíz como cache:v1 porque no identifica una ruta de imagen ascendente.

          Los repositorios ascendentes no necesitan tener activada la capacidad de nivel superior.

        • Nombre de usuario ascendente: nombre de usuario que Container Registry utiliza para autenticarse en el registro ascendente. Este usuario debe tener permiso para extraer imágenes de la ruta de acceso ascendente configurada.

          Utilice el formato <tenancy-namespace>/<username>. Por ejemplo, ansh81vru1zp/jdoe@acme.com.

          Si el arrendamiento del usuario ascendente está federado con un proveedor de identidad soportado para la autenticación de Container Registry, utilice el formato <tenancy-namespace>/<domain-name>/<username>, utilizando el nombre de dominio que se muestra para ese usuario en la consola. Por ejemplo, si el arrendamiento está federado con Oracle Identity Cloud Service y el nombre de dominio es oracleidentitycloudservice, introduzca ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com.

          Aquí, <tenancy-namespace> es el espacio de nombres de almacenamiento de objetos del arrendamiento del usuario ascendente, que se muestra en la página Información general del arrendamiento. Para los usuarios federados, <domain-name>/<username> se muestra en el menú Perfil de la consola. Consulte Transferencia de imágenes con la CLI de Docker.

        • ID de secreto ascendente: OCID de un secreto en OCI Vault del cliente que contiene la credencial de autenticación del usuario ascendente, con el formato ocid1.vaultsecret.<realm>.<region>.<unique-id>.

      • Acceso: para un repositorio estándar, especifique si el repositorio es público o privado. Solo puede hacer público el repositorio si pertenece al grupo Administradores del arrendamiento o se le ha otorgado el permiso REPOSITORY_MANAGE. Un repositorio de caché de recuperación siempre es privado. Tenga en cuenta lo siguiente:

        • Si hace que un repositorio estándar sea público, cualquier usuario con acceso a Internet y conocimientos de la URL correspondiente puede extraer imágenes del repositorio.

        • Si hace que un repositorio sea privado, usted (junto con los usuarios que pertenecen al grupo Administradores del arrendamiento) puede realizar operaciones en el repositorio para el que tiene autorización. Los repositorios de caché de recuperación no soportan operaciones push de cliente.

      • Activar estructura de repositorio de nivel superior: active esta opción para permitir que el repositorio posea su ruta de imagen raíz y rutas secundarias debajo de su nombre. La opción está disponible para ambos tipos de repositorio. Cuando está activado, el nombre del repositorio debe contener un único segmento de ruta de acceso sin /. No puede cambiar la configuración después de la creación.

      • Nombre del repositorio: nombre que se elige para el repositorio. Los nombres son únicos en todos los compartimentos del espacio de nombres del arrendamiento regional. Los repositorios existentes en app/ evitan la creación de app con la capacidad de nivel superior activada. Un repositorio existente app con la capacidad de nivel superior activada también impide la creación de un repositorio independiente denominado app/backend. Evite introducir información confidencial.

      • Etiquetas: opcionalmente, una o más etiquetas de formato libre o etiquetas definidas para aplicarlas al repositorio. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Si no está seguro si debe aplicar etiquetas, omita esta opción (puede aplicar las etiquetas posteriormente) o pregunte a su administrador. Para obtener más información, consulte Aplicación de etiquetas de formato libre y etiquetas definidas a repositorios, imágenes y firmas de imágenes.

    3. Haga clic en Crear.
    4. (Opcional) Para crear automáticamente nuevos repositorios privados en el compartimento raíz del arrendamiento cuando los comandos docker push no incluyan el nombre de un repositorio existente, siga estos pasos:
      1. En el menú Acciones, seleccione Editar política global.

      2. Seleccione Create repository on first push in root compartment.

      3. Seleccione Actualizar.

  • Utilice el comando oci Artefactos Container Repository Create y los parámetros necesarios para crear un repositorio:

    oci artifacts container repository create --display-name <repo-name> --compartment-id <compartment_ocid> [OPTIONS]

    Por ejemplo:

    oci artifacts container repository create --display-name project01/acme-web-app --compartment-id ocid1.compartment.oc1..aaaaaaaarvdfa72n...

    Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte la Referencia de la línea de comandos.

  • Ejecute la operación CreateContainerRepository para crear un repositorio.