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 permitir que App Engine migre automáticamente tus flujos de implementación.

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 automático. 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 el caso de las implementaciones estándar existentes, 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 otorgue el permiso de escritura explícito de Artifact Registry artifactregistry.repositories.uploadArtifacts. Para encontrar los roles asociados con la cuenta de servicio que se implementará, 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 hay ninguno de estos roles, otorga el rol de escritor de Artifact Registry (roles/artifactregistry.writer) a la cuenta de servicio de implementación.

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

Durante las migraciones automatizadas, Google Cloud podría 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 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 las implementaciones flexibles existentes funcionen como se espera con Artifact Registry, 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 otorgue los permisos explícitos de Artifact Registry, como artifactregistry.repositories.downloadArtifacts para la lectura y artifactregistry.repositories.uploadArtifacts para la escritura. Para encontrar los roles asociados con la cuenta de servicio que se implementará, 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 hay ninguno de estos roles, otorga el rol de administrador del repositorio de Artifact Registry (roles/artifactregistry.repoAdmin) a la cuenta de servicio de implementación.

Si no proporcionas los permisos necesarios, no podrás implementar aplicaciones en el entorno flexible. El escalamiento y el reinicio de instancias también fallan.

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

Cómo migrar a Artifact Registry para imágenes de contenedor compiladas de forma manual

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

Si usas imágenes de contenedores compiladas previamente o compiladas 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 de gcr.io alojados en Artifact Registry. Si usas esta herramienta, no es necesario que vuelvas a implementar versiones nuevas de tu servicio. Para obtener más información, consulta Cómo 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 implementar versiones nuevas 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 las imágenes de contenedor en Artifact Registry y volver a implementar versiones nuevas de tu servicio.