Migrar imágenes de contenedor de App Engine a Artifact Registry

ID de región

El REGION_ID es un código abreviado que Google asigna en función de la región que selecciones al crear tu aplicación. El código no corresponde a un país o provincia, aunque algunos IDs de región pueden parecerse a los códigos de país y provincia que se usan habitualmente. En las aplicaciones creadas después de febrero del 2020, REGION_ID.r se incluye en las URLs de App Engine. En las aplicaciones creadas antes de esa fecha, el ID de región es opcional en la URL.

Más información sobre los IDs de región

Container Registry está obsoleto y se retiró el 18 de marzo del 2025. Te recomendamos que uses Artifact Registry para almacenar y gestionar imágenes de contenedor. De forma predeterminada, los nuevos despliegues creados después del 5 de marzo del 2025 usarán Artifact Registry en lugar de Container Registry para almacenar imágenes de aplicaciones. Artifact Registry ofrece las mismas funciones de gestión de contenedores que Container Registry e incluye funciones y ventajas adicionales. Artifact Registry es un servicio totalmente gestionado que admite tanto imágenes de contenedor como artefactos que no son de contenedor, por lo que amplía las funciones de Container Registry.

Si tienes proyectos que se crearon antes de mayo del 2024 o que aún no han ejecutado la herramienta de migración automática, sigue los pasos de esta guía para permitir que App Engine migre automáticamente tus flujos de despliegue.

Entorno estándar de App Engine

La mayoría de los componentes de tu aplicación en el entorno estándar siguen un proceso de migración automatizado. Sin embargo, para que la transición a Artifact Registry sea fluida, asegúrate de que tu cuenta de servicio tenga los siguientes permisos obligatorios:

  • En las implementaciones estándar, la cuenta de servicio de implementación (la cuenta de servicio predeterminada de App Engine [PROJECT_ID@appspot.gserviceaccount.com] o tu cuenta de servicio personalizada) debe tener un rol que le conceda el permiso de escritura explícito de Artifact Registry artifactregistry.repositories.uploadArtifacts. Para ver los roles asociados a tu cuenta de servicio de implementación, consulta Gestionar el acceso a cuentas de servicio.

  • Los nuevos despliegues pueden usar Artifact Registry si la cuenta de servicio asociada a ellos tiene alguno de los siguientes roles:

    Si la cuenta de servicio asociada a los despliegues no tiene ninguno de estos roles, concédele el rol Escritor de Artifact Registry (roles/artifactregistry.writer).

Si no proporciona los permisos necesarios, no podrá implementar nuevas versiones en el entorno estándar.

Durante las migraciones automatizadas, Google Cloud puede crear repositorios y copiar imágenes de Container Registry a Artifact Registry.

Entorno flexible de App Engine

La mayoría de los componentes de tu aplicación en el entorno flexible siguen un proceso de migración automatizado. Sin embargo, para que la transición a Artifact Registry sea fluida, asegúrate de que tu cuenta de servicio tenga los siguientes permisos obligatorios:

  • Para que los despliegues flexibles funcionen correctamente con Artifact Registry, la cuenta de servicio de despliegue (ya sea la cuenta de servicio predeterminada de App Engine [PROJECT_ID@appspot.gserviceaccount.com] o tu cuenta de servicio personalizada) debe tener un rol que le conceda permisos explícitos de Artifact Registry, como artifactregistry.repositories.downloadArtifacts para lectura y artifactregistry.repositories.uploadArtifacts para escritura. Para ver los roles asociados a tu cuenta de servicio de implementación, consulta Gestionar el acceso a cuentas de servicio.

  • Los nuevos despliegues pueden usar Artifact Registry si la cuenta de servicio asociada a ellos tiene alguno de los siguientes roles:

    Si la cuenta de servicio asociada a los despliegues no tiene ninguno de estos roles, concédele el rol Administrador de repositorios de Artifact Registry (roles/artifactregistry.repoAdmin).

Si no proporciona los permisos necesarios, no podrá desplegar aplicaciones en el entorno flexible. Tampoco se pueden escalar ni reiniciar las instancias.

Durante las migraciones automatizadas, Google Cloud puede crear repositorios y copiar imágenes de Container Registry a Artifact Registry.

Migrar a Artifact Registry para imágenes de contenedor compiladas manualmente

El proceso de migración automática no se aplica si has desplegado tus aplicaciones anteriormente con imágenes de contenedor prediseñadas o compiladas manualmente de Container Registry. Por ejemplo, el proceso de migración automática no funciona si has creado imágenes de contenedor con Docker, las has insertado en Container Registry y has desplegado tus aplicaciones con el comando gcloud app deploy --image-url.

Si usas imágenes de contenedor precompiladas o compiladas manualmente de Container Registry para desplegar tus aplicaciones, elige una de las siguientes opciones para migrar a Artifact Registry:

  • Usa la herramienta de migración automática para migrar de Container Registry a repositorios de gcr.io alojados en Artifact Registry. No es necesario que implementes nuevas versiones de tu servicio si usas esta herramienta. Para obtener más información, consulta Migrar automáticamente de Container Registry a Artifact Registry.

  • Mueve manualmente las imágenes de contenedor de Container Registry a Artifact Registry y vuelve a desplegar las nuevas versiones de tu servicio. Para obtener más información, consulta Migración manual a repositorios de gcr.io en Artifact Registry.

  • Usa la marca copy-only para copiar tus imágenes de contenedor en Artifact Registry y volver a desplegar nuevas versiones de tu servicio.