Desactivaciones de funciones

Los siguientes avisos de discontinuación afectan a Container Registry. Consulta también los avisos de desactivación de Docker y su changelog.

Nota: Desde el 1 de marzo del 2017, Docker sigue un ciclo de lanzamiento mensual que usa un esquema de control de versiones de año y mes (AA.MM). Anteriormente, Docker usaba un esquema de versiones principales, secundarias y de parche (con el formato X.X.X). La última versión que usó este esquema fue la 1.13.1. Para obtener más información, consulta el aviso de Docker sobre este cambio.

API Docker Registry v1 y clientes de Docker anteriores a la versión 1.6

El 14 de diciembre del 2016, anunciamos que, a partir del 28 de febrero del 2017, con el lanzamiento de Docker v1.13, Docker Engine ya no admitiría el protocolo v1.

Por lo tanto, Container Registry ya no admite clientes de Docker con versiones anteriores a la 1.6. Después del 28 de febrero del 2017, los clientes de Docker con una versión inferior a la 1.6 no podrán comunicarse con la API de Container Registry y las imágenes de contenedor del protocolo v1 almacenadas en Container Registry dejarán de estar disponibles.

Para comprobar si este cambio afecta a tus imágenes, sigue estos pasos:

1. Para comprobar qué versión del cliente de Docker estás usando, ejecuta el siguiente comando:

     gcloud docker -- --version
   

   Si la versión de tu cliente es inferior a la 1.6, debes actualizar tu cliente de Docker. A continuación, debes actualizar tus imágenes al protocolo Docker Registry v2.

2. Extrae una imagen de la versión 1 afectada:

     gcloud docker -- pull gcr.io/[PROJECT-ID]/[IMAGE]
   

3. Vuelve a enviar la imagen:

     gcloud docker -- push gcr.io/[PROJECT-ID]/[IMAGE]
   

Para obtener más información sobre los protocolos v1 y v2 de Docker Registry, consulta Formatos de imágenes de contenedor.

Nota: Si se produce un error continuamente, como "v1 Registry API is disabled" (La API de registro v1 está inhabilitada), al extraer o insertar imágenes, asegúrate de que el nombre de host, el ID de proyecto, el nombre de la imagen y la etiqueta o el digest estén escritos correctamente. Para obtener más información, consulta la sección Solución de problemas.

Segmentos de Container Registry no estándar

El 28 de febrero del 2017, se dejó de admitir el uso de registros de "bring-your-own-bucket" (trae tu propio contenedor) como b.gcr.io y bucket.gcr.io. Container Registry ya no sirve imágenes de contenedor alojadas en esos contenedores.

Para seguir usando tus imágenes, debes moverlas a una ubicación estándar de Container Registry, como gcr.io, us.gcr.io, asia.gcr.io o eu.gcr.io.

Para migrar tus imágenes de contenedor de un bucket no estándar a uno estándar, sigue estos pasos:

1. Extrae las imágenes del contenedor no estándar:

   gcloud docker -- pull b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG]
   

2. Vuelve a etiquetar las imágenes con un nombre de ubicación de registro estándar:

   gcloud docker -- tag b.gcr.io/[BUCKET-NAME]/[IMAGE]:[TAG] [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
   

3. Vuelve a insertar la imagen en Container Registry (con la versión 1.6 o posterior del cliente de Docker) con el ID del proyecto de destino:

   gcloud docker -- push [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
   

Cambio en el almacenamiento de metadatos de imágenes de contenedor

Desde el 28 de febrero del 2017, Container Registry ha cambiado la ubicación en la que almacena los archivos de metadatos de imágenes de contenedores. Los metadatos de las imágenes hacen referencia a información como los nombres, las etiquetas y los manifiestos de las imágenes, que identifican los archivos de capa (por digest) que componen una imagen.

Este cambio puede afectarte si accedes directamente a los archivos de metadatos de tu segmento de Cloud Storage o los manipulas, como el historial de cambios o la gestión del ciclo de vida de los objetos para eliminarlos.

Antes, cuando enviabas una imagen a Container Registry, la API de Container Registry almacenaba los metadatos y los archivos de capas de esas imágenes en un segmento de Cloud Storage de tu proyecto. Desde el 28 de febrero del 2017, Container Registry almacena los metadatos de las imágenes en una base de datos backend de alto rendimiento para mejorar el rendimiento y la funcionalidad. Los archivos de la capa de imagen se siguen almacenando en Cloud Storage.

Se ha añadido automáticamente a tu proyecto una cuenta de servicio de Container Registry con un nombre similar a [PROJECT-NUMBER]@containerregistry.iam.gserviceaccount.com. Esta cuenta de servicio activó la nueva API Container Registry y gestionó la migración. No elimines ni rebajes la versión de esta cuenta de servicio, ni desactives la nueva API Container Registry.

Nota: Si eliminas o cambias a una versión inferior de la cuenta de servicio de migración, puedes volver a crearla reactivando la API Container Registry en el menú APIs & services (APIs y servicios) de la consola de Cloud.

Comando gcloud docker y clientes de Docker con una versión superior a la 18.03

Desde el 3 de abril del 2018, gcloud docker no es compatible con las versiones de cliente de Docker superiores a la 18.03.

Para autenticar las solicitudes a Container Registry de versiones de cliente posteriores a la 18.03, usa gcloud como auxiliar de credenciales de Docker. Para ello, ejecuta el siguiente comando:

gcloud auth configure-docker

También puedes usar uno de los otros métodos de autenticación avanzados.

Advertencia: Solo debes usar un asistente de credenciales de Docker (es decir, docker-credential-gcr o docker-credential-gcloud a través de gcloud auth configure-docker) en las versiones 18.03 o posteriores. Un error en versiones anteriores del cliente de Docker ralentiza docker buildde forma drástica cuando se configuran los asistentes de credenciales.