Implementa una app de Cloud Run con Cloud Shell

Para comenzar a usar Cloud Run, puedes implementar una aplicación de Hello World de muestra y, luego, inspeccionar los recursos de tu servicio en vivo. En esta guía de inicio rápido, usarás Cloud Shell para configurar un servicio de Cloud Run y ver sus registros.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

Roles obligatorios

Para obtener los permisos que necesitas para implementar una app de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Otorga acceso a la cuenta de servicio de Cloud Build a tu proyecto

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, otorga a la cuenta de servicio de Cloud Build el rol de Compilador de Cloud Run (roles/run.builder) en tu proyecto:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \
    --role=roles/run.builder

Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud y SERVICE_ACCOUNT_EMAIL_ADDRESS por la dirección de correo electrónico de la cuenta de servicio de Cloud Build. Si usas la cuenta de servicio predeterminada de Compute Engine como la cuenta de servicio de Cloud Build, usa el siguiente formato para la dirección de correo electrónico de la cuenta de servicio:

PROJECT_NUMBER-compute@developer.gserviceaccount.com

Reemplaza PROJECT_NUMBER por el número 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 tarda un par de minutos en propagarse.

Crea una aplicación

  1. Inicia el editor de Cloud Shell
  2. En la barra de estado de Cloud Code, selecciona New Application (Nueva aplicación).
  3. Selecciona Cloud Run application (Aplicación de Cloud Run) como tu tipo de aplicación preferido.

  4. Elige una app de Hello World de la lista de aplicaciones de ejemplo (Node.js, Python con frameworks de Flask y Django, Java y Go).

    Por ejemplo, si eliges Python (Flask): Hello World, se crea una app de Hello World de Python (Flask) inicial.

  5. Selecciona una carpeta como tu ubicación de aplicación y haz clic en Create New Application.

    El editor de Cloud Shell carga la aplicación en un lugar de trabajo nuevo. Después de que se cargue el lugar de trabajo, se podrá acceder a la app en la vista del explorador.

Implementa en Cloud Run

Para implementar tu aplicación en Cloud Run, sigue estos pasos:

  1. Abre la paleta de comandos (presiona Ctrl/Cmd+Shift+P o haz clic en Ver > Paleta de comandos) y, luego, ejecuta el comando Implementar en Cloud Run. Esto abrirá la IU de implementación de Cloud Run.
  2. Si se te solicita, autoriza a Cloud Code para que realice llamadas a la API de Google Cloud .
  3. Configura tu proyecto de Google Cloud .
  4. Si se te solicita, haz clic en Habilitar las APIs para habilitar la API de Cloud Run.
  5. En el cuadro de diálogo Implementar en Cloud Run, selecciona un servicio preexistente o crea uno nuevo.
  6. Si creas un servicio nuevo, elige Cloud Run (fully managed) (Cloud Run (completamente administrado)) en “'Deployment Platform” (Plataforma de implementación).
  7. Elige una región para realizar la implementación.
  8. En Autenticación, selecciona Permitir invocaciones no autenticadas para que sea un servicio público.

  9. Después de definir los parámetros de configuración que desees, puedes hacer clic en Deploy (Implementar).

    Luego, Cloud Code compila tu imagen, la envía al registro y, por último, implementa la app en Cloud Run. El servicio ya está activo.

  10. Para ver el servicio en ejecución, sigue la URL que se muestra en el diálogo Cloud Run: Deploy.

Edita el servicio

Para implementar la aplicación, sigue estos pasos:

  1. Con la vista Explorer, busca el archivo app.py que implementa el comportamiento del servicio.
  2. Cambia el mensaje "It's running!" por uno de tu elección.
  3. Después de realizar este cambio, elige el comando Implementar en Cloud Run con la paleta de comandos.
  4. Verifica que el servicio que acabas de crear esté seleccionado en Configuración del servicio.
  5. Haga clic en Implementar.
  6. Una vez que se complete la compilación y la implementación de la aplicación, puedes actualizar el servicio para ver el mensaje actualizado.

Ver registros

También puedes ver los registros de tu aplicación implementada con el visor de registros que incluye Cloud Code.

Para ver los registros, sigue estos pasos:

  1. Haz clic en Ícono de Cloud Code Cloud Code y, luego, expande la sección Cloud Run.

  2. Haz clic con el botón derecho en el servicio de Cloud Run y, luego, en Ver registros.

  3. Para actualizar la app en el navegador y ver los registros nuevos generados, haz clic en el botón Logs refresh.

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Para borrar tu clúster, realiza los siguientes pasos:

  1. Ve a la página Proyectos en la consola de Google Cloud :

    Ir a la página Proyectos

  2. Selecciona el proyecto que creaste para esta guía de inicio rápido y haz clic en Borrar.

    Esta acción cierra el proyecto y programa su eliminación.

Si usas un proyecto preexistente y deseas borrar los recursos que creaste para esta guía de inicio rápido, haz lo siguiente:

¿Qué sigue?