Documentación de Oracle Cloud Infrastructure

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.

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 la página Tokens de autenticación, 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 cuadro de 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 Object Storage generada automáticamente del arrendamiento (como se muestra en la página Información 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 dominio de registro.

    • <tenancy-namespace> es la cadena de 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 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 el usuario debe tener acceso al repositorio (consulte Repositorios).

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

    Tenga en cuenta que si no especifica <version> en el comando docker pull, Docker extrae la imagen con el identificador de versión 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