En esta página, se muestra cómo comenzar a usar Cloud Code.
Configurarás un servicio de Hello World que se ejecuta en Cloud Run mediante una plantilla de inicio, implementa tu servicio en Cloud Run y visualiza el estado de los recursos de tu servicio en vivo.
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:
- Si aún no lo hiciste, instala el IDE de JetBrains versión 2019.3+ (como IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand).
- 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 tuPATH
). Para verificar si ya tienes Docker instalado, ejecutadocker -v
. - Cloud Code instala de forma automática otras dependencias necesarias.
- Para todas las plataformas de Cloud, asegúrate de que el cliente Docker (autenticado con tu registro de Docker) esté instalado en el
- Abre IntelliJ IDEA (o cualquier IDE de JetBrains admitido).
- 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 el IDE para activar el complemento.
Crear un servicio
Para crear un servicio nuevo con una muestra existente, sigue estos pasos:
- En tu IDE, abre File (Archivo) > New Project (Proyecto nuevo) y selecciona Cloud Code: Cloud Run (Cloud Code: Cloud Run).
- Selecciona una plantilla “Hello World” de la lista de aplicaciones de inicio.
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 servicio en Cloud Run
Para implementar tu servicio, sigue estos pasos:
- 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.
- Haz clic en “Ejecutar”
. Con esta acción, se abre la ventana “Editar configuración”.
- Configura el ID del proyecto de Google Cloud.
- 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".
- Haz clic en “Ejecutar”.
- Para ver tu servicio en ejecución, sigue la URL que se muestra en la ventana de salida.
También puedes ver el estado de tu servicio (métricas, detalles de revisión y más) si sigues la URL de los registros que se muestra en la ventana de resultados.
Visualiza el estado de los recursos
Para ver el estado de los recursos de tu servicio en ejecución, sigue estos pasos:
Navega hacia el explorador de Cloud Run. Se puede acceder desde el panel lateral ubicado a la derecha.
Haz clic en un servicio o una revisión en el explorador a fin de mostrar sus propiedades.
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:
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”.
¿Qué sigue?
- 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.