Migrar una aplicación del entorno flexible de App Engine a Cloud Run

Desplegar imágenes de contenedor

Si tus servicios de App Engine se han desplegado con un contenedor creado manualmente, puedes usar la misma imagen de contenedor para desplegar tu servicio en Cloud Run. Para desplegar la imagen de contenedor de App Engine en Cloud Run, sigue estos pasos:

1. Anota la URL del registro en el que se encuentra la imagen de tu contenedor. Es la misma URL que proporciona en la marca --image-url al implementar en App Engine.

2. Despliega tu imagen de contenedor:

   consola

   1. En la Google Cloud consola, ve a la página Cloud Run.

      Ir a Cloud Run

   2. Haz clic en Crear servicio.

   3. Haz clic en el botón Seleccionar del campo URL de la imagen del contenedor y elige la imagen del contenedor que has desplegado en App Engine.

   4. Escribe un nombre para el servicio. Elige un nombre único que represente la aplicación que vas a implementar.

   5. En la sección Autenticación, selecciona Permitir las invocaciones sin autenticar.

   6. Debes crear las mismas variables de entorno para Cloud Run que definiste en el archivo app.yaml de tu aplicación App Engine. Despliega la sección Contenedor, Redes y Seguridad y crea las siguientes variables de entorno haciendo clic en Añadir variable en Variables de entorno:

      • Para los sockets Unix, añade lo siguiente:

          INSTANCE_UNIX_SOCKET: /cloudsql/INSTANCE_CONNECTION_NAME
        

      • En el caso de los conectores de Cloud SQL, añade lo siguiente:

          INSTANCE_CONNECTION_NAME:INSTANCE_CONNECTION_NAME
        

        Sustituye INSTANCE_CONNECTION_NAME por el ID del proyecto, la región y la instancia, siguiendo el formato de project:region:instance-id. Puedes encontrarlo en la página Resumen de tu instancia en la Google Cloud consola.

        Estas conexiones se cifran automáticamente sin necesidad de configuración adicional.

      • DB_NAME: nombre de la base de datos.

      • DB_USER: nombre de usuario de tu base de datos.

      • DB_PASS: contraseña que especificaste al crear la base de datos.

   7. En la sección Conexiones de Cloud SQL, haz clic en el botón Añadir conexión y selecciona la instancia que has creado anteriormente para App Engine.

   8. Haz clic en Desplegar. Una vez que se haya desplegado el servicio de Cloud Run, en la parte superior de la página Detalles del servicio se mostrará una URL. Haz clic en el enlace URL para ver la aplicación desplegada en Cloud Run conectada a Cloud SQL.

   gcloud

   Ejecuta el siguiente comando para crear un servicio en Cloud Run.Debes definir las marcas de configuración para incluir las mismas variables de entorno de conexión SQL definidas en el archivo app.yaml de tu aplicación de App Engine:

   gcloud run deploy run-sql --image IMAGE \
     --allow-unauthenticated \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
     --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
     --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
     --set-env-vars DB_NAME="DB_NAME" \
     --set-env-vars DB_USER="DB_USER" \
     --set-env-vars DB_PASS="DB_PASS"
   

   Sustituye:

   • IMAGE con la imagen que vas a implementar

   • INSTANCE_CONNECTION_NAME con el nombre de conexión de la instancia de Cloud SQL o una lista de nombres de conexión separados por comas. Puedes encontrar el INSTANCE_CONNECTION_NAME ejecutando el siguiente comando:

       gcloud instances describe INSTANCE_NAME
     

   • DB_NAME con el nombre de tu base de datos.

   • DB_USER con el nombre de usuario de tu base de datos.

   • DB_PASS con la contraseña de tu usuario de base de datos.

Desplegar código fuente

Cloud Run usa internamente paquetes de compilación y Cloud Build para compilar automáticamente imágenes de contenedor a partir de tu código fuente, por lo que no es necesario que compiles manualmente un contenedor ni que especifiques un Dockerfile. Sin embargo, si hay un Dockerfile, se usará.

Para desplegar un servicio de Cloud Run desde el código fuente, se usa Artifact Registry, por lo que esta función solo está disponible en las regiones admitidas por Artifact Registry.

Para desplegar el mismo código fuente que desplegaste anteriormente en App Engine, sigue estos pasos:

1. Cambia al directorio de origen donde se encuentra el código fuente de tu aplicación.

     cd YOUR_APPENGINE_CODE_DIR
   

2. Despliega en Cloud Run.

   Para compilar el código fuente y desplegar la aplicación, ejecuta el comando deploy con la marca --source. Debes definir marcas de configuración para incluir las mismas variables de entorno de conexión SQL que se definen en el archivo app.yaml de tu aplicación de App Engine:

     gcloud run deploy run-sql --source SOURCE \
       --allow-unauthenticated \
       --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
       --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
       --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
       --set-env-vars DB_NAME="DB_NAME" \
       --set-env-vars DB_USER="DB_USER" \
       --set-env-vars DB_PASS="DB_PASS"
   

   Sustituye:

   • SOURCE con la ruta al directorio de origen de App Engine
   • INSTANCE_CONNECTION_NAME con el nombre de conexión de la instancia de Cloud SQL o una lista de nombres de conexión separados por comas. Puedes encontrar el INSTANCE_CONNECTION_NAME ejecutando el siguiente comando:

       gcloud instances describe INSTANCE_NAME
   

   • DB_NAME con el nombre de tu base de datos.
   • DB_USER con el nombre de usuario de tu base de datos.
   • DB_PASS con la contraseña de tu usuario de base de datos.

3. Introduce el nombre del SERVICIO cuando se te pida.

4. Responde y cuando se te pida que instales las APIs necesarias. Solo tienes que hacerlo una vez por proyecto. Espera a que se complete la compilación y la implementación. Cuando termine, se mostrará un mensaje similar a este:

   Service [my-app] revision [my-app-00000-xxx] has been deployed and is serving 100 percent of traffic. Service URL: https://sample.run.app
   

   Para obtener más información sobre cómo desplegar código fuente en Cloud Run, consulta Desplegar desde código fuente.