Implementa un servicio de Cloud Run con Cloud Code para VS Code

Implementa un servicio de Cloud Run con Cloud Code para VS Code

En este documento, se muestra cómo comenzar a usar Cloud Code.

Crearás un servicio a partir de una aplicación de muestra de "Hello, world", implementarás tu servicio de forma pública con Cloud Code y verás el estado de los recursos del servicio en ejecución.

Antes de comenzar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Run API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Run API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Instala Git. Se requiere Git para copiar muestras en tu máquina.
2. Instala Docker. Se requiere Docker para compilar el código de muestra. Asegúrate de que tu cuenta de usuario local pueda compilar contenedores.
3. Instala el complemento de Cloud Code si aún no lo hiciste.

Roles obligatorios

Si quieres obtener los permisos que necesitas para completar esta guía de inicio rápido, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

• Administrador de Cloud Run (roles/run.admin)
• Compilador de Cloud Run (roles/run.builder)
• Visor de registro (roles/logging.viewer)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

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.

Crear un servicio

Para crear una aplicación de servicio de muestra, sigue estos pasos:

1. En la barra de estado de Cloud Code, haz clic en el nombre del proyecto activo.

   

2. En el menú Selección rápida que aparece, selecciona Nueva aplicación.

3. Selecciona Cloud Run application como el tipo de aplicación.

4. En la lista de aplicaciones de ejemplo, selecciona una para el idioma que prefieras.

   Por ejemplo, si eliges Node.js: Cloud Run, se crea una aplicación de servicio "Hello, world" en Node.js.

5. Confirma la ubicación del sistema de archivos del código fuente de tu servicio (o modifícala si es necesario) y haz clic en Create New Application.

   Se abrirá una vista previa del archivo README.md para el servicio seleccionado en VS Code.

Implementa en Cloud Run

Para implementar tu servicio 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 Deploy to Cloud Run.

2. En el panel Deploy to Cloud Run, configura tu proyecto Google Cloud .

3. Acepta el resto de la configuración predeterminada y haz clic en Implementar.

   Cloud Code compila tu imagen, la envía al registro y, por último, implementa el servicio en Cloud Run.

4. Para ver el servicio en ejecución, abre la URL que se muestra en la parte superior del cuadro de diálogo Implementar en Cloud Run.

Cómo ver el estado de los recursos

Puedes ver el estado de tus servicios de Cloud Run mediante el navegador de servicios de Cloud Run:

1. Haz clic en Cloud Code en la barra de actividades de VS Code.
2. Expande la sección Cloud Run para ver tu servicio de Cloud Run.
3. Haz clic en el servicio para ver sus propiedades.

Ver registros

También puedes ver los registros del servicio implementada con el visor de registros que incluye Cloud Code.

Para ver los registros, sigue estos pasos:

1. Haz clic en Cloud Code en la barra de actividades de VS Code.
2. Expande la sección Cloud Run para ver tu servicio de Cloud Run.
3. Haz clic con el botón derecho en tu servicio de Cloud Run y, luego, en Ver registros.

Realiza una limpieza

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

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

   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.

3. Escribe el ID del proyecto para confirmar y, luego, haz clic en Cerrar.

   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:

• Imagen de contenedor: Si bien Cloud Run no cobra cuando el servicio no se usa, es posible que se te cobre por almacenar la imagen de contenedor en Artifact Registry. Si quieres conocer los pasos para borrar tu imagen, consulta Cómo borrar imágenes.

• Servicio de Cloud Run: Para borrar un servicio de Cloud Run, navega a Cloud Run en laGoogle Cloud consola con el menú de navegación. Selecciona el servicio que deseas borrar y, luego, haz clic en Borrar.

¿Qué sigue?

• Descubre la asistencia para la depuración específica del lenguaje que proporciona Cloud Code.
• Para personalizar tu experiencia en Cloud Code, establece los parámetros de la configuración relevante.
• Intenta crear y ejecutar una aplicación de Kubernetes con Cloud Code.