Guía de inicio rápido: Implementa una app de Cloud Run con Cloud Code

En esta página, se muestra cómo comenzar a usar Cloud Code.

Configurarás una aplicación de Hello World que se ejecute en Cloud Run mediante una plantilla de inicio, implementarás tu app en Cloud Run y verás el estado de los recursos de la aplicación activa.

Antes de comenzar

Para usar Cloud Run, debes crear un proyecto de GCP y habilitar la facturación.

Además, deberás habilitar la compatibilidad con Cloud Run en tu proyecto. En Console, usa el menú de navegación para acceder a las API y a los servicios. Haz clic en “API de Cloud Run” en la lista de las API disponibles y, luego, en “Habilitar API”.

Instala Cloud Code

Para instalar el complemento de Cloud Code, haz lo siguiente:

1. Si aún no lo hiciste, instala el IDE de JetBrains versión 2019.3+ (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand).
2. Instala las dependencias:
   • Para todas las plataformas de Cloud, asegúrate de que el cliente Docker (autenticado con tu registro de Docker) esté instalado en el PATH de tu máquina. (La carpeta respectiva debería estar visible en un directorio dentro de tu PATH). Para verificar si ya tienes Docker instalado, ejecuta docker -v.
   • Cloud Code instala de forma automática otras dependencias necesarias.
3. Abre IntelliJ IDEA (o cualquier IDE de JetBrains admitido).
4. Busca el complemento “Cloud Code” en el mercado de complementos (Archivo > Parámetros de configuración > Complementos o, para macOS, IntelliJ IDEA > Preferencias > Complementos) y, luego, instálalo. Es posible que debas reiniciar tu IDE para activar el complemento.

Crea una aplicación

Para crear una aplicación nueva mediante una muestra existente sigue estos pasos:

1. En tu IDE, abre File (Archivo) > New Project (Proyecto nuevo) y selecciona Cloud Code: Cloud Run (Cloud Code: Cloud Run).
2. Selecciona una plantilla “Hello World” de la lista de aplicaciones de inicio.

3. Elige un nombre para tu proyecto.

   Cuando hagas clic en Finalizar, Cloud Code clonará la plantilla que elegiste y abrirá el proyecto que recién creaste para usarlo. Además, creará los parámetros de configuración de ejecución de Cloud Run necesarios.

   • En el caso de las plantillas de Java, se te solicitará que importes proyectos de Maven para sincronizar tu pom.xml. Haz clic en “Add as Maven project” (Agregar como proyecto de Maven).

     

     Además, si deseas importar los proyectos de Maven necesarios, haz clic en “Import Changes” (Importar cambios).

     

Implementa tu app en Cloud Run

Para implementar la aplicación, sigue estos pasos:

1. Elige la configuración de ejecución que se creó de forma automática, Cloud Run: Implementar, en el cuadro de diálogo Configuración de ejecución y depuración que se encuentra en la barra de tareas superior.
2. Haz clic en “Ejecutar” . Con esta acción, se abre la ventana “Editar configuración”.
3. Configura el ID del proyecto de Google Cloud.
4. Elige una región para tu plataforma de implementación. En esta guía de inicio rápido, se usa la opción de plataforma predeterminada “Cloud Run (completamente administrada)” como "Plataforma de implementación".
5. Haz clic en “Ejecutar”.
6. Para visualizar tu app en ejecución, sigue la URL que se muestra en la ventana de salida.

7. También puedes ver el estado de tu aplicación (métricas, detalles de revisión y mucho más) si sigues la URL de registros que se muestra en la ventana de salida.

   

Visualiza el estado de los recursos

Para ver el estado de los recursos de tu aplicación en ejecución, sigue estos pasos:

1. Navega hacia el explorador de Cloud Run. Se puede acceder desde el panel lateral ubicado a la derecha.

   

2. Haz clic en un servicio o una revisión en el explorador a fin de mostrar sus propiedades.

   

3. Haz clic con el botón derecho en una revisión para ver sus registros.

   

Realiza una limpieza

Si creaste un proyecto para esta guía de inicio rápido, asegúrate de borrarlo a fin de evitar cargos innecesarios:

• Ve a la página Proyectos en Cloud Console:

  Ir a la página Proyectos

• Selecciona el proyecto que creaste destinado a esta guía de inicio rápido y bórralo. Para ello, debes hacer clic en el ícono de la papelera que se encuentra al lado.

  Con esta acción, se cierra el proyecto y se 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:

• Imagen de contenedor: Si bien no se generan costos por Cloud Run cuando el servicio no se usa, es posible que se te cobre por el almacenamiento de la imagen del contenedor en Container Registry. Para borrar tu imagen, sigue esta guía.
• Servicio de Cloud Run: Para borrar un servicio de Cloud Run, navega hacia Cloud Run en Console mediante el menú de navegación. Selecciona el servicio que deseas borrar y haz clic en el ícono de la papelera “Borrar”.

Próximos pasos

• Agrega la API de Google Cloud y las bibliotecas cliente a tu proyecto.
• Personaliza los parámetros de configuración de ejecución con los parámetros de configuración avanzada.
• Intenta crear y ejecutar una aplicación de Kubernetes con Cloud Code.

Obtén asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.