Extracción de imágenes con la CLI de Docker

Descubra cómo extraer imágenes de Container Registry mediante la CLI de Docker.

Utilice la CLI de Docker para extraer imágenes de Oracle Cloud Infrastructure Registry (también conocido como Container Registry).

Los permisos controlan las imágenes que puede extraer de Container Registry (consulte Políticas para controlar el acceso al repositorio). Puede extraer imágenes de los repositorios que ha creado, de los repositorios públicos y de los repositorios a los que se otorga acceso a los grupos a los que pertenece mediante las políticas de identidad. Si pertenece al grupo Administradores, puede extraer imágenes de cualquier repositorio en el arrendamiento.

Para extraer una imagen de un repositorio de caché de recuperación, autentique en Container Registry y utilice docker pull como lo haría con cualquier otro repositorio privado.

Si la imagen solicitada no se almacena en caché local, Container Registry utiliza las credenciales ascendentes configuradas del repositorio para recuperar la imagen del registro ascendente. Container Registry transmite la imagen al cliente y la almacena en caché en la región que contiene el repositorio de caché de recuperación para las extracciones posteriores.

Al extraer una imagen por etiqueta, Container Registry también comprueba si hay cambios en el registro ascendente cuando vence la actualización de la etiqueta.

Nota

Container Registry es un registro compatible con la iniciativa de contenedor abierto. 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 este tema se supone que está almacenando imágenes de Docker y utilizando la CLI de Docker.

Para extraer imágenes de Container Registry mediante la CLI de Docker:

  1. Si ya tiene un token de autenticación, vaya al paso siguiente. De lo contrario:

    1. En la esquina superior derecha de la consola, abra el menú Perfil Icono de menú de perfil y, a continuación, seleccione la configuración de usuario (o Mi perfil o el nombre de su cuenta) para ver los detalles.

    2. En el separador Tokenes y claves, vaya a la sección Tokens de autenticación y seleccione Generar token.

    3. Introduzca una descripción fácil de recordar para el token de autenticación. Evite introducir información confidencial.

    4. Seleccione Generar token. Se muestra el nuevo token de autenticación.

    5. Copie el token de autenticación inmediatamente en una ubicación segura desde donde pueda recuperarlo más tarde, ya que no verá el token de autenticación de nuevo en la consola.

    6. Cierre el diálogo Generar Token.

  2. En una ventana de terminal de la máquina cliente que ejecuta Docker, conéctese a Container Registry introduciendo docker login <registry-domain>, donde <registry-domain> incluye una clave de región o un identificador de región para la región de Container Registry que está utilizando. Por ejemplo, docker login ocir.us-ashburn-1.oci.oraclecloud.com. Consulte Disponibilidad por región.

  3. Cuando se le solicite un nombre de usuario, introduzca su nombre de usuario, con el formato <tenancy-namespace>/<username>, donde <tenancy-namespace> es la cadena de espacio de nombres de almacenamiento de objetos generada automáticamente del arrendamiento (como se muestra en la página Información general de arrendamiento). Por ejemplo, ansh81vru1zp/jdoe@acme.com

    Si su arrendamiento está federado con Oracle Identity Cloud Service, utilice el formato <tenancy-namespace>/<domain-name>/<username>. Para los usuarios federados, <domain-name>/<username> se muestra en el menú Perfil Icono de menú de perfil de la consola. Por ejemplo, si la cadena de espacio de nombres de su arrendamiento es ansh81vru1zp y su arrendamiento está federado con Oracle Identity Cloud Service, y su nombre de usuario es jdoe@acme.com, introduzca ansh81vru1zp/oracleidentitycloudservice/jdoe@acme.com.

  4. Cuando se le solicite una contraseña, introduzca el token de autenticación que ha copiado antes.

  5. Para extraer la imagen de Docker de Container Registry a la máquina cliente, introduzca:

    docker pull <registry-domain>/<tenancy-namespace>/<repo-name>:<version>

    donde:

    • <registry-domain> incluye la clave de región o el identificador de región de la región de Container Registry que está utilizando. Por ejemplo, ocir.us-ashburn-1.oci.oraclecloud.com. Consulte Resumen de terminología.

    • <tenancy-namespace> es la cadena del espacio de nombres de almacenamiento de objetos generada automáticamente del arrendamiento propietario del repositorio del que desea extraer la imagen (como se muestra en la página Información general de arrendamiento). 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). Tenga en cuenta también que su usuario debe tener acceso al arrendamiento.

    • <repo-name> es el nombre de un repositorio del que desea extraer la imagen (por ejemplo, project01/acme-web-app). Tenga en cuenta que su usuario debe tener acceso al repositorio (consulte Repositorios). Cuando la capacidad de nivel superior esté activada en el repositorio app, especifique app para extraer una imagen en la raíz del repositorio o app/backend para extraer una imagen en la ruta secundaria backend. Ambas rutas pertenecen al repositorio app; app/backend no es un repositorio independiente. El mismo formato de referencia de imagen se aplica a los repositorios de caché estándar y de extracción.
    • <version> es el identificador de versión de la imagen que desea extraer de Container Registry (por ejemplo, v2.0.test).

    Por ejemplo:

    docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test

    En el caso de un repositorio denominado app con la capacidad de nivel superior activada, puede extraer imágenes en la raíz del repositorio o en una ruta secundaria.

    Extraer una imagen en la raíz del repositorio por etiqueta:

    docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/app:v2.0.test

    Extraer una imagen en la ruta secundaria backend por etiqueta:

    docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/app/backend:v2.0.test

    Extraiga una imagen en la ruta secundaria backend por resumen:

    docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/app/backend@sha256:<digest>

    Sustituya <digest> por el valor de resumen SHA-256 real de la imagen. Una referencia de resumen utiliza @sha256:<digest> en lugar de :<version>.

    Si no especifica ni una etiqueta ni un resumen en el comando docker pull, Docker utiliza la etiqueta latest.

  6. Para confirmar que la imagen se ha extraído de Container Registry, introduzca docker images y verifique que la lista de imágenes de la máquina cliente ahora incluye la imagen que acaba de extraer.

    Por ejemplo:

    
    $ docker images
    REPOSITORY                                                                TAG                   IMAGE ID      CREATED       SIZE
    ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app v2.0.test             8e0506e14874  1 minute ago  162.6 MB
    acme-web-app                                                              latest                8e0506e14874  2 hours ago   162.6 MB
    acme-web-app                                                              v1.0                  7d9495d03763  2 hours ago   162.6 MB
    <none>                                                                    <none>                6ebd328f833d  5 hours ago   162.6 MB
    hello-world                                                               latest                80b84820d442  5 weeks ago   890 B