Migra imágenes de contenedores de App Engine a Artifact Registry

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que eliges cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. En el caso de las apps creadas después de febrero de 2020, REGION_ID.r se incluye en las URL de App Engine. En el caso de las apps existentes creadas antes de esta fecha, el ID de región es opcional en la URL.

Obtén más información acerca de los ID de región.

Container Registry dejó de estar disponible y se cerró el 18 de marzo de 2025. Te recomendamos que uses Artifact Registry para almacenar y administrar imágenes de contenedor. De forma predeterminada, las implementaciones nuevas creadas después del 5 de marzo de 2025 usan Artifact Registry en lugar de Container Registry para almacenar imágenes de aplicaciones. Artifact Registry proporciona las mismas funciones de administración de contenedores que Container Registry y, además, incluye funciones y beneficios adicionales. Como servicio completamente administrado y compatible con imágenes de contenedores y artefactos que no son de contenedores, Artifact Registry extiende las capacidades de Container Registry.

En el caso de los proyectos creados antes de mayo de 2024 o que aún no ejecutaron las herramientas de migración automatizada, sigue los pasos de esta guía para habilitar App Engine para que migre automáticamente tus flujos de implementación.

Entorno estándar de App Engine

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

  • En el caso de las implementaciones estándar existentes, la cuenta de servicio de implementación (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 otorgue el permiso de escritura explícito de Artifact Registry artifactregistry.repositories.uploadArtifacts. Para encontrar los roles asociados con tu cuenta de servicio de implementación, consulta Administra el acceso a las cuentas de servicio.

  • Las implementaciones nuevas pueden usar Artifact Registry si alguno de los siguientes roles está presente en la cuenta de servicio asociada con las implementaciones:

    Si no está presente ninguno de estos roles, otorga el rol Escritor de Artifact Registry (roles/artifactregistry.writer) a tu cuenta de servicio de implementación.

Si no proporcionas los permisos obligatorios, no podrás implementar versiones nuevas en el entorno estándar.

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

Entorno flexible de App Engine

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

  • Para que las implementaciones flexibles existentes funcionen como se espera con Artifact Registry, la cuenta de servicio de implementación (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 otorgue los permisos explícitos de Artifact Registry, como artifactregistry.repositories.downloadArtifacts para lectura y artifactregistry.repositories.uploadArtifacts para escritura. Para encontrar los roles asociados con tu cuenta de servicio de implementación, consulta Administra el acceso a las cuentas de servicio.

  • Las implementaciones nuevas pueden usar Artifact Registry si alguno de los siguientes roles está presente en la cuenta de servicio asociada con las implementaciones:

    Si no está presente ninguno de estos roles, otorga el rol Administrador de repositorios de Artifact Registry (roles/artifactregistry.repoAdmin) a tu cuenta de servicio de implementación.

Si no proporcionas los permisos obligatorios, no podrás implementar aplicaciones en el entorno flexible. Tampoco se podrán escalar ni reiniciar las instancias.

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

Migra a Artifact Registry para obtener imágenes de contenedor compiladas de forma manual

El proceso de migración automatizado no se aplica si implementaste tus apps con imágenes de contenedor compiladas previamente o de forma manual desde Container Registry. Por ejemplo, el proceso de migración automatizado no funciona si compilaste imágenes de contenedor con Docker, enviaste estas imágenes a Container Registry y, luego, implementaste tus apps con el comando gcloud app deploy --image-url.

Si usas imágenes de contenedor compiladas previamente o de forma manual desde Container Registry para implementar tus apps, 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 gcr.io alojados en Artifact Registry. No es necesario volver a implementar versiones nuevas de tu servicio si usas esta herramienta. Para obtener más información, consulta Cómo migrar automáticamente de Container Registry a Artifact Registry.

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

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