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 a él mediante 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 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 Crear repositorio. 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.

      • 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 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 de si debe aplicar etiquetas, omita esta opción ( puede aplicar etiquetas posteriormente) o consulte con el 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. Seleccione Configuración.

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

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