Documentación de Oracle Cloud Infrastructure

Creación de un repositorio

Descubra cómo crear un repositorio en Container Registry.

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

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 utiliza un comando con el formato docker push <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. Sin embargo, si selecciona la opción Crear repositorio al realizar la primera transferencia en el compartimento raíz y transfiere una imagen con un comando que incluya el nombre de un repositorio que aún no exista, se crea un nuevo repositorio privado automáticamente en el compartimento raíz.

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.

Debe pertenecer al grupo Administradores del arrendamiento o haber obtenido 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.

  • Para crear un repositorio en Container Registry mediante la consola y, opcionalmente, permitir la creación automática del repositorio:

    1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Contenedores y artefactos, haga clic en Container Registry.
    2. Seleccione la región en la que desea crear el repositorio.
    3. Seleccione un compartimento en el que tenga permiso para trabajar.
    4. Haga clic en Crear repositorio.

    5. En el panel Crear repositorio, especifique los detalles del repositorio:

      • Crear en compartimento: compartimento en el que se va a crear el repositorio. El compartimento por defecto es el que ha seleccionado anteriormente, pero puede seleccionar cualquier compartimento en el que tenga permiso para trabajar.
      • Acceso: si el repositorio es público o privado. Solo puede hacer público el repositorio si pertenece al grupo de administradores del arrendamiento o si se le ha otorgado el permiso REPOSITORY_MANAGE. Tenga en cuenta lo siguiente:
        • Si hace público el repositorio, cualquier usuario con acceso a Internet y conocimientos de la URL correspondiente puede extraer imágenes del repositorio.
        • Si hace privado el repositorio, usted (y los usuarios que pertenecen al grupo de administradores del arrendamiento) pueden realizar cualquier operación en el repositorio.
      • Nombre del repositorio: nombre que se elige para el repositorio. El nombre que introduzca debe ser único en todos los compartimentos del arrendamiento. Evite introducir información confidencial.
      • Etiquetas: opcionalmente, una o más etiquetas de formato libre o etiquetas definidas para aplicar al repositorio. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Si no está seguro de si deben aplicar etiquetas, omita esta opción (puede aplicar las etiquetas posteriormente) o pregunte al 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.
    6. Haga clic en Crear.

    7. (Opcional) Si desea 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. Haga clic en Valores.
      2. Seleccione Crear repositorio al realizar la primera transferencia en el compartimento raíz.

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