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.
En esta guía, se describe cómo implementar tus apps existentes en el entorno flexible en Cloud Run.
Los pasos que se describen en esta guía no afectan la funcionalidad ni el flujo de tráfico de tu app de App Engine existente. El servicio de Cloud Run recién creado es una réplica del servicio de App Engine que puedes probar de forma independiente.
El entorno flexible de App Engine y Cloud Run son plataformas de aplicaciones nativas de contenedores completamente administradas, pero difieren estructuralmente. Para obtener más información sobre las similitudes y diferencias entre App Engine y Cloud Run, incluidos los beneficios de migrar a Cloud Run, consulta el resumen de comparaciones. Para implementar en Cloud Run, usa la configuración local de tu archivoapp.yaml. Esto compila una imagen de contenedor a partir de tu código fuente local, por lo que cualquier cambio reciente en tu código o configuración se incluye en la
implementación nueva.
Antes de comenzar
Asegúrate de que tu aplicación de App Engine se ejecute sin errores. Necesitas acceso al código fuente de App Engine.
Habilita la API de Cloud Run Admin y la API de Artifact Registry:
Configura tu proyecto y región con el siguiente comando:
gcloud auth login gcloud config set project PROJECT_ID gcloud config set run/region REGION gcloud components updateReemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- REGION: la región en la que deseas implementar tu servicio de Cloud Run.
Verifica si hay funciones incompatibles en tu aplicación y quítalas antes de migrar a Cloud Run. Para verificar si tu aplicación es incompatible sin realizar una migración o implementación, ejecuta el siguiente comando desde el directorio en el que se encuentra el archivo
app.yaml:gcloud beta app migrate-to-run --dry-runRevisa los resultados de la verificación de compatibilidad y realiza los cambios recomendados si es necesario.
Revisa las siguientes diferencias de Cloud Run:
Cloud Run usa el término
Revision, en lugar deVersion, para representar cada vez que implementas cambios en un servicio específico. Cuando implementas tu app en un servicio en Cloud Run por primera vez, se crea su primera revisión. Cada implementación posterior de un servicio crea otra revisión. Obtén más información para implementar en Cloud Run.Puedes implementar tu código fuente en Cloud Run con la consola deGoogle Cloud o Google Cloud CLI para configurar y administrar los parámetros de configuración de tu app. Cloud Run no requiere configuración basada en archivos. Sin embargo, la configuración de YAML es compatible.
Cada servicio que implementas en Cloud Run usa el dominio
run.appen la URL para acceder al servicio públicamente.A diferencia de los servicios de App Engine que son públicos de forma predeterminada, los servicios de Cloud Run son privados de forma predeterminada y requieren que los configures para el acceso público (no autenticado).
Roles obligatorios
Puedes elegir crear una cuenta de servicio nueva o usar la misma cuenta de servicio administrada por el usuario en Cloud Run que usas para el entorno flexible. Tú o tu administrador deben otorgar a la cuenta de implementación y a la cuenta de servicio de Cloud Build los siguientes roles de IAM.
Haz clic para ver los roles necesarios para la cuenta de implementación
Para obtener los permisos que necesitas para compilar e implementar desde la fuente, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Desarrollador de origen de Cloud Run (
roles/run.sourceDeveloper) en tu proyecto - Consumidor de Service Usage (
roles/serviceusage.serviceUsageConsumer) en tu proyecto - Usuario de cuenta de servicio (
roles/iam.serviceAccountUser) en la identidad del servicio de Cloud Run
Haz clic para ver los roles necesarios para la cuenta de servicio de Cloud Build
Cloud Build usa automáticamente la
cuenta de servicio predeterminada de Compute Engine como la cuenta de servicio predeterminada de Cloud Build para compilar tu código fuente y
el recurso de Cloud Run, a menos que anules este comportamiento. Para que
Cloud Build compile tus fuentes, pídele a tu administrador que otorgue el rol de
Compilador de Cloud Run
(roles/run.builder) a la cuenta de servicio predeterminada
de Compute Engine en tu proyecto:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \ --role=roles/run.builder
Reemplaza PROJECT_NUMBER por el número del proyecto de Google Cloud
y PROJECT_ID por el ID del proyecto de Google Cloud. Para obtener instrucciones detalladas sobre cómo encontrar el ID del proyecto y el número del proyecto,
consulta Crea
y administra proyectos.
El otorgamiento del rol de creador de Cloud Run a la cuenta de servicio predeterminada de Compute Engine tarda un par de minutos en propagarse.
Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu servicio de Cloud Run interactúa con las APIs deGoogle Cloud , como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta los permisos de implementación y cómo administrar el acceso.
Usa la configuración local de un archivo app.yaml
Implementa tu configuración local de App Engine en Cloud Run con la consola de Google Cloud o Google Cloud CLI.
Console
En la consola de Google Cloud , ve a la página App Engine.
En el menú de navegación, haz clic en Migration hub para implementar tu app de App Engine en Cloud Run.
En la tarjeta Migración de Flexible a Cloud Run, selecciona el Servicio y la Versión que deseas migrar y, luego, haz clic en Verificar compatibilidad.
En la sección Verificar compatibilidad, consulta los resultados de compatibilidad. El centro de migración ejecuta un comprobador de compatibilidad para identificar funciones incompatibles.
Revisa los resultados para verificar que tu app no tenga incompatibilidades de bloqueo y, luego, haz clic en Continuar para avanzar a la sección Revisar e implementar.
Copia el comando en la sección Implementa a través de gcloud, reemplaza el marcador de posición PATH_TO_APP_YAML por la ruta de acceso a tu archivo
app.yamly ejecuta el comando desde el directorio del código fuente de la aplicación.Haz clic en Ver versiones implementadas para ver tus servicios de App Engine implementados en Cloud Run.
gcloud
Para implementar tu servicio de Cloud Run con el archivo app.yaml local
de una configuración de App Engine existente, sigue estos pasos:
En la terminal, cambia al directorio del código fuente en el que se encuentra el archivo
app.yaml.Ejecuta el siguiente comando para implementar tu servicio en Cloud Run:
gcloud beta app migrate-to-runEste comando genera la configuración del archivo
service.yamlpara Cloud Run y la guarda de forma local en el mismo directorio que el archivoapp.yaml. Para obtener más información, consultagcloud beta app migrate-to-run.- Cuando se te solicite
Proceed with the deployment?, ingresaYpara compilar una imagen de contenedor a partir de tu código fuente y, luego, implementar el servicio en Cloud Run.
- Cuando se te solicite
Probar el servicio de Cloud Run implementado Debido a que tu servicio de Cloud Run es privado de forma predeterminada, abrir la URL del servicio directamente en un navegador web devuelve un error
403 Forbidden. Para ver tu servicio, realiza una de las siguientes acciones:- Para probar el servicio de forma privada (recomendado), ejecuta el comando
gcloud run services proxyy, luego, abre la URL del proxy local en un navegador web. - Si quieres que tu servicio esté disponible de forma pública, habilita el acceso público y, luego, abre la URL del servicio en un navegador web.
Opcional:
Si tu archivo
app.yamlestá en un directorio diferente, especifica su ruta de acceso con la marca--appyaml:gcloud beta app migrate-to-run --appyaml=PATHReemplaza PATH por la ruta de acceso a tu archivo
app.yaml.Para generar y exportar la configuración de
service.yamlde Cloud Run sin implementar el servicio, usa la marca--export-only:gcloud beta app migrate-to-run --export-only=EXPORT_PATHReemplaza EXPORT_PATH por el directorio o la ruta de acceso en la que deseas guardar el archivo
service.yaml.
- Para probar el servicio de forma privada (recomendado), ejecuta el comando
Funciones incompatibles
El comando de migración falla o muestra una advertencia si el archivo app.yaml
contiene alguna de las siguientes opciones de configuración no admitidas:
Servicios de entrada:
inbound_services: - warmupSolución: Borra la sección
inbound_servicesde tu archivoapp.yaml. Cloud Run prepara las instancias con el punto de entrada del contenedor, por lo que no necesitas configurar solicitudes de preparación. Si necesitas ejecutar código de inicialización antes de entregar tráfico, configura tu servicio para que se ejecute en el inicio, antes de escuchar las solicitudes o usar sondeos de inicio. También puedes configurar instancias mínimas para mantener las instancias preparadas.Páginas de error personalizadas:
error_handlers: - file: default_error.html - error_code: over_quota file: over_quota.htmlSolución: Borra la sección
error_handlersde tu archivoapp.yamly sigue una o ambas de estas estrategias:- Implementa el manejo de errores directamente en el código de tu aplicación. Detecta
los códigos de error de HTTP estándar, como
404o500, y entrega tus páginas de error de HTML personalizadas desde la lógica de tu aplicación. - Si usas Cloud Load Balancing con Cloud Run, configura respuestas de error personalizadas a nivel del balanceador de cargas. Esto te permite entregar páginas de error personalizadas desde Cloud Storage según el código de respuesta de tu servicio de Cloud Run.
- Implementa el manejo de errores directamente en el código de tu aplicación. Detecta
los códigos de error de HTTP estándar, como
Controladores de URL y archivos estáticos:
handlers: - url: /stylesheets static_dir: stylesheetsSolución: Borra la sección
handlersde tu archivoapp.yaml. Cloud Run no admite el enrutamiento de solicitudes deapp.yamlni los controladores de archivos estáticos. En su lugar, entrega archivos estáticos directamente desde tu servicio de Cloud Run o desde Cloud Storage, y controla el enrutamiento de URLs dentro del código de tu aplicación o con Cloud Load Balancing.Variables de entorno de compilación:
build_env_variables: BUILD_MODE: "production"La verificación de compatibilidad en el centro de migración informa esta configuración como una incompatibilidad de bloqueo. El comando
gcloud beta app migrate-to-runno lo informa y aplica las variables a la compilación cuando implementas desde la fuente.Solución: Borra la sección
build_env_variablesde tu archivoapp.yaml. Si tu compilación aún requiere estos valores, establece variables de entorno de compilación cuando implementes tu servicio de Cloud Run desde la fuente. Si tu app necesita estos valores en el entorno de ejecución, configúralos como variables de entorno en el servicio.Escalamiento básico:
basic_scaling: max_instances: 10 idle_timeout: 10mSolución: Reemplaza la sección
basic_scalingde tu archivoapp.yamlporautomatic_scalingomanual_scaling. La verificación de compatibilidad en el centro de migración bloquea las versiones que usan el escalamiento básico.Valores de recursos y escalamiento fuera de los límites de Cloud Run:
manual_scaling: instances: 1500La migración muestra una advertencia si tu configuración está fuera de cualquiera de los siguientes límites de Cloud Run:
- CPU: 8 CPUs virtuales
- Memoria: De 512 MiB a 32 GiB
- Instancias de escalamiento mínimo, máximo o manual: 1,000
- Solicitudes simultáneas por instancia: 1,000
Solución: Actualiza el archivo
app.yamlpara usar valores dentro de estos límites. Para obtener más información, consulta Límites de CPU, límites de memoria y simultaneidad. Si necesitas más de 1,000 instancias, solicita un aumento de cuota.
Puertos reenviados con asignaciones de puertos de host, protocolos o varios puertos:
network: forwarded_ports: - 8080:8000 - 2222/udpSolución: Actualiza
network.forwarded_portsen tu archivoapp.yamlpara especificar solo un puerto de contenedor numérico, como8080, o borraforwarded_portsy configura el puerto del contenedor en Cloud Run. Cloud Run solo acepta tráfico TCP entrante en un único puerto de contenedor y no admite asignaciones de puertos de host a contenedor ni tráfico UDP. La herramienta de migración solo acepta números de puerto sin formato, por lo que las asignaciones de puertos de host y los sufijos de protocolo/tcpo/udp, como8080/tcp, hacen que la migración falle. Si especificas varios puertos numéricos, la herramienta de migración registra una advertencia y configura solo el primer puerto.Tamaño del disco:
resources: disk_size_gb: 20Solución: Borra
disk_size_gbde la secciónresourcesde tu archivoapp.yaml. La herramienta de migración muestra una advertencia y, luego, ignora este parámetro de configuración, ya que Cloud Run usa de forma predeterminada un sistema de archivos en memoria, en el que la escritura de archivos consume memoria de la instancia. Si tu aplicación necesita escribir archivos sin consumir memoria, configura una activación de volumen de disco efímero o una activación de volumen de Cloud Storage en Cloud Run para evitar errores de falta de memoria (OOM).
¿Qué sigue?
- Obtén información sobre cómo administrar tus servicios de Cloud Run.
- Consulta el contrato del entorno de ejecución de contenedores de Cloud Run para comprender los requisitos y el comportamiento de los contenedores en Cloud Run.
- Obtén información para almacenar las dependencias de tu servicio que requieren claves de API, contraseñas o cualquier otra información sensible con Secret Manager.