Hojas de cálculo de Google es una herramienta de solución de hojas de cálculo que permite la colaboración en tiempo real y proporciona herramientas para visualizar, procesar y comunicar datos.
En este instructivo, se muestra cómo activar Workflows desde Hojas de cálculo.
Objetivos
En este instructivo, podrás:
- Usa Formularios de Google, una herramienta de cuestionarios y encuestas, para crear un formulario que permita enviar solicitudes a crear instancias de máquina virtual (VM).
- Vincula un archivo de Hojas de cálculo de Google al formulario para recopilar y guardar de respuestas ante incidentes.
- Usa Google Apps Script, una plataforma de JavaScript basada en la nube que te permite crear, leer y editar productos de Google Workspace de forma programática para activar un flujo de trabajo cada vez que se aprueba una solicitud a través de una actualización de la hoja de cálculo.
- Implementar un flujo de trabajo que llame al Conector de la API de Compute Engine y crea una instancia de VM de Compute Engine basada en las especificaciones recopiladas a través del formulario. Los conectores simplifican las llamadas de otros servicios de Google Cloud APIs Obtén más información sobre los conectores de Workflows.
- Prueba todo el proceso y confirma que la instancia de VM se creó como se espera.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
En el instructivo, también se usa Google Workspace. Servicios de nivel empresarial que no se incluyen en las aplicaciones gratuitas de Google para consumidores son facturables.
Antes de comenzar
Puedes ejecutar algunos de los siguientes comandos en la consola de Google Cloud con Google Cloud CLI en tu terminal o en Cloud Shell.
Es posible que las restricciones de seguridad que define tu organización no te permitan completar los siguientes pasos. Para obtener información sobre la solución de problemas, consulta Desarrolla aplicaciones en un entorno de Google Cloud restringido.
Console
En la página del selector de proyectos de la consola de Google Cloud, elige o crea un proyecto de Google Cloud.
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.
Habilitar las APIs de Compute Engine y Workflows
Toma nota de las Cuenta de servicio predeterminada de Compute Engine ya que la asociarás con el flujo de trabajo de este instructivo para probar comerciales. Proyectos nuevos que habilitaron la API de Compute Engine crear esta cuenta de servicio con la política de IAM editor y con el siguiente formato de correo electrónico:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Puedes encontrar el número de proyecto en la página de bienvenida de la consola de Google Cloud.
Para entornos de producción, recomendamos crear una cuenta de servicio nueva y otorgarle uno o más roles de IAM que contengan los permisos mínimos requeridos y seguir el principio de privilegio mínimo.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.
Habilita las APIs de Compute Engine y Workflows.
gcloud services enable \ compute.googleapis.com \ workflows.googleapis.com
Toma nota de las Cuenta de servicio predeterminada de Compute Engine ya que la asociarás con el flujo de trabajo de este instructivo para probar comerciales. Proyectos nuevos que habilitaron la API de Compute Engine crear esta cuenta de servicio con la política de IAM editor y con el siguiente formato de correo electrónico:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Puedes recuperar el número de tu proyecto de las siguientes maneras:
gcloud projects describe PROJECT_ID
Para entornos de producción, recomendamos crear una cuenta de servicio nueva y lo que le otorga uno o más roles de IAM que contengan el permisos mínimos necesarios y siguen el principio de privilegio mínimo.
Crea un formulario para solicitar instancias de VM
Crea un formulario que se pueda usar para enviar una solicitud para crear una Instancia de máquina virtual (VM) de Compute Engine. De forma predeterminada, cuando crear un formulario con Formularios de Google, se guarda Google Drive
- Ve a forms.google.com.
- Haz clic en En blanco
.
Se abrirá un nuevo formulario.
- Crea un formulario con cinco secciones obligatorias. El formulario debería ser similar al siguiente:
Ver formulario de muestra
Nombre de la máquina Texto de respuesta breve
Zona Menú desplegable:
- us-central1-a
- us-central1-b
- us-central1-c
- us-central1-f
Tipo Menú desplegable:
- e2-micro
- e2-small
- e2-medium
- e2-standard-2
- e2-standard-4
Tamaño del disco (GB) Texto de respuesta breve
Sistema operativo Menú desplegable:
- debian-10
- centos-stream-9
- cos-93-lts
- cos-97-lts
- Habilitar la recopilación de correos electrónicos para registrar las direcciones de correo electrónico de las personas que completan el formulario
en tu formulario:
- Haz clic en Configuración.
- Expande la sección Respuestas.
- Haz clic en el botón de activación Recopilar las direcciones de correo electrónico.
Vincula una hoja de cálculo a tu formulario
Después de crear un formulario, vincula una hoja de cálculo a él para poder guardarlo las respuestas del formulario en esa hoja de cálculo. La hoja de cálculo se guarda en Drive
- Abre el formulario en Formularios.
- Haz clic en Respuestas.
- Haz clic en Vínculo a Hojas de cálculo.
- En el diálogo Selecciona el destino de las respuestas, elige Crear un nuevo en una hoja de cálculo.
Haz clic en Crear.
Se abrirá la hoja de cálculo vinculada.
En la columna H, agrega un encabezado Approved?.
Coloca el cursor en la primera fila de la columna H y selecciona Casilla de verificación Insertar >.
La hoja de cálculo debería tener un aspecto similar al siguiente:
Cada vez que se actualice la hoja con una respuesta, también aparecerá la casilla de verificación en la fila correspondiente a esa respuesta.
Amplía Hojas de cálculo de Google con Apps Script
Apps Script te permite crear, leer y editar Hojas de cálculo de forma programática. La mayoría de las secuencias de comandos diseñadas para Hojas de cálculo para interactuar con las celdas, filas y columnas de una hoja de cálculo. Para obtener una introducción al uso de Apps Script con Hojas de cálculo, consulta la Guía de inicio rápido de funciones personalizadas.
Crea un proyecto de Apps Script a partir de Hojas de cálculo:
- Abre tu hoja de cálculo de Hojas de cálculo.
- Selecciona Extensiones > Apps Script.
- En el editor de secuencias de comandos, haz clic en Proyecto sin título.
- Asígnale un nombre al proyecto y haz clic en Cambiar nombre.
Ahora la secuencia de comandos está vinculada a la hoja de cálculo lo que permite que las secuencias de comandos modifiquen la interfaz de usuario. responder cuando se abra la hoja de cálculo.
Un proyecto de secuencia de comandos representa una colección de Apps Script archivos y recursos. Los archivos de código en un proyecto de secuencia de comandos tienen un
.gs
. .Puedes usar Apps Script para escribir funciones personalizadas que que puedes usar en Hojas de cálculo como una función integrada. Las funciones personalizadas se crean con JavaScript estándar. Crea una función:
- Abre tu proyecto de Apps Script.
- Haz clic en Editor .
- Un archivo de secuencia de comandos aparece como un archivo de proyecto llamado
Code.gs
. Para editar el archivo, seleccionarla. Reemplaza cualquier código en el editor de secuencia de comandos por el siguiente código, que lee los datos de tu hoja de cálculo y los pasa como entrada a una ejecución de flujo de trabajo:
Reemplaza
your-project-id
por el ID del proyecto de Google Cloud.Puedes buscar el ID del proyecto en la página de bienvenida de la consola de Google Cloud.
Haz clic en Guardar
.
Apps Script activadores instalables permiten que un proyecto de secuencia de comandos ejecute una función específica cuando se cumplen ciertas condiciones se cumplen, como cuando se abre o se edita una hoja de cálculo. Crea un activador:
- Abre tu proyecto de Apps Script.
- Haz clic en Activadores .
- Haz clic en Agregar activador.
- En el diálogo Agregar activador para YOUR_PROJECT_NAME, configura la
activador:
- En la lista Elige qué función ejecutar, selecciona handleEdit.
- En la lista Elige qué implementación se debe ejecutar, selecciona Head.
- En la lista Seleccionar la fuente del evento, elige Desde una hoja de cálculo.
- En la lista Seleccionar tipo de evento, elige Al editar.
- En la lista Configuración de notificaciones de errores, selecciona Notificarme diariamente.
- Haz clic en Guardar.
Si recibes un mensaje para elegir una Cuenta de Google, selecciona la cuenta y haz clic en Permitir.
Esto permite que tu proyecto de Apps Script vea, edite crear y borrar tus Hojas de cálculo y conectarse a un servicio externo.
Un archivo de manifiesto de un proyecto de Apps Script es un archivo JSON que especifica la información básica del proyecto Apps Script necesita ejecutar una secuencia de comandos correctamente. Ten en cuenta que El editor de Apps Script oculta los archivos de manifiesto de forma predeterminada para proteger tu secuencia de comandos configuración del proyecto. Edita el archivo de manifiesto:
- Abre tu proyecto de Apps Script.
- Haz clic en Configuración del proyecto .
- Selecciona la casilla de verificación Mostrar el archivo de manifiesto "appsscript.json" en el editor.
- Haz clic en Editor .
- El archivo de manifiesto aparece como un archivo de proyecto llamado
appsscript.json
. Para editar el archivo, selecciónalo. El campo
oauthScopes
especifica un array de cadenas. Para establecer la permisos de autorización usa tu proyecto, agrega un array con los alcances que desees compatibles. Por ejemplo:{ "timeZone": "America/Toronto", "dependencies": { }, "exceptionLogging": "STACKDRIVER", "runtimeVersion": "V8", "oauthScopes": [ "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/spreadsheets" ] }
Esto establece los alcances explícitos en:
- Se conecta a un servicio externo.
- Ver, editar, configurar y borrar tus datos de Google Cloud y ver la dirección de correo electrónico de tu Cuenta de Google
- Consultar, editar, crear y borrar todas tus hojas de cálculo de Hojas de cálculo
Haz clic en Guardar
.
Implementa un flujo de trabajo que cree una instancia de VM
Implementa un flujo de trabajo que se active cuando se apruebe una solicitud para crear una instancia de VM. El flujo de trabajo llama a Conector de la API de Compute Engine para crear una instancia de VM de Compute Engine basada en las especificaciones recopiladas a través del formulario.
Console
En la consola de Google Cloud, ve a la página Flujos de trabajo:
Haz clic en
Crear.Ingresa un nombre para el flujo de trabajo nuevo:
create-vm-from-form
.En la lista Región, selecciona us-central1 (Iowa).
En Cuenta de servicio, selecciona la cuenta de servicio predeterminada de Compute Engine (
PROJECT_NUMBER-compute@developer.gserviceaccount.com
).Haz clic en Siguiente.
En el editor de flujos de trabajo, ingresa la siguiente definición para tu flujo de trabajo:
Haz clic en Implementar.
gcloud
Crea un archivo de código fuente para tu flujo de trabajo:
touch create-vm-from-form.yaml
En un editor de texto, copia el siguiente flujo de trabajo en tu archivo de código fuente:
Para implementar el flujo de trabajo, ingresa el siguiente comando:
gcloud workflows deploy create-vm-from-form \ --source=create-vm-from-form.yaml \ --location=us-central1 \ --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
Reemplaza
PROJECT_NUMBER
por el número de proyecto de Google Cloud. Puedes recuperar el número de tu proyecto de la siguiente manera:gcloud projects describe PROJECT_ID
Prueba el flujo de extremo a extremo
Para confirmar que todo funciona como se esperaba, intenta revisar todo el proceso de administración de recursos.
Envíate el formulario y responde las preguntas de forma adecuada.
Asegúrate de que las especificaciones que usas para crear una instancia de VM sean válidas. De lo contrario, la ejecución de tu flujo de trabajo fallará. Para obtener más información, consulta Familia de máquinas de uso general de Compute Engine.
Para enviar tu respuesta, haz clic en Enviar.
Abre el formulario en Formularios.
Haz clic en Respuestas.
Haz clic en Ver en Hojas de cálculo.
Se abrirá tu hoja de cálculo vinculada.
En la fila de tu respuesta, selecciona la casilla de verificación ¿Aprobado?.
Abre tu proyecto de Apps Script.
Haz clic en Ejecuciones
.El activador debería estar ejecutado y debe mostrarse con un estado
Completed
.Confirma que el flujo de trabajo de
create-vm-from-form
se haya completado correctamente:Console
En la consola de Google Cloud, ve a la página Flujos de trabajo.
En la página Flujos de trabajo, haz clic en el create-vm-from-form para ir a su página de detalles.
En la página Detalles del flujo de trabajo, para recuperar los detalles de un ejecución específica, haz clic en el ID de ejecución correspondiente.
El Estado de ejecución debe ser Sin errores y, en el campo Entrada deberías ver las especificaciones de la VM que solicitaste.
gcloud
Recupera una lista de los intentos de ejecución de tu flujo de trabajo:
gcloud workflows executions list create-vm-from-form
El resultado debería ser similar al siguiente:
NAME: projects/918619793306/locations/us-central1/workflows/create-vm-from-form/executions/d8947ecb-9ccb-4ea1-ba10-e5c10414e3be STATE: SUCCEEDED START_TIME: 2023-01-24T15:07:40.404741791Z END_TIME: 2023-01-24T15:07:55.649373625Z
Confirma que se creó una VM nueva como se esperaba:
Console
En la consola de Google Cloud, ve a la página Instancias de VM.
Tu instancia de VM debería aparecer con un estado que indique en ejecución.
gcloud
Recupera una lista agregada de todas las VMs en todas las zonas de un proyecto:
gcloud compute instances list
Tu instancia de VM debería aparecer en la lista con un estado que indique que está en ejecución.
Para obtener más información sobre el comando
gcloud compute instances list
, consulta su página de referencia.
Limpia
Si creaste un proyecto nuevo para este instructivo, bórralo. Si usaste un proyecto existente y deseas conservarlo sin los cambios que se agregaron en este instructivo, borra los recursos creados para el instructivo.
Borra el proyecto
La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.
Para borrar el proyecto, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.