Activa un flujo de trabajo desde Hojas de cálculo de Google

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

1. Ve a forms.google.com.
2. Haz clic en En blanco.

   Se abrirá un nuevo formulario.

3. Crea un formulario con cinco secciones obligatorias. El formulario debe ser similar por lo 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

4. 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:
   1. Haz clic en Configuración.
   2. Expande la sección Respuestas.
   3. Haz clic en el botón de activación Recopilar las direcciones de correo electrónico.

Vincular 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

1. Abre el formulario en Formularios.
2. Haz clic en Respuestas.
3. Haz clic en Vínculo a Hojas de cálculo.
4. En el diálogo Selecciona el destino de las respuestas, elige Crear un nuevo en una hoja de cálculo.

5. Haz clic en Crear.

   Se abrirá la hoja de cálculo vinculada.

6. En la columna H, agrega un encabezado Approved?.

7. 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 de esa respuesta.

Amplía Hojas de cálculo de Google con Apps Script

Apps Script te permite crear, leer y editar de manera programática Hojas de cálculo. 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 un introducción al uso de Apps Script con Hojas de cálculo, consulta la guía de inicio rápido sobre funciones personalizadas.

1. Crea un proyecto de Apps Script a partir de Hojas de cálculo:

   1. Abre tu archivo de Hojas de cálculo.
   2. Selecciona Extensiones > Apps Script.
   3. En el editor de secuencias de comandos, haz clic en Proyecto sin título.
   4. 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. .

2. 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 crea con JavaScript estándar. Crea una función:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Editor code.
   3. Aparecerá un archivo de secuencia de comandos como un archivo de proyecto llamado Code.gs. Para editar el archivo, seleccionarla.

   4. Reemplaza cualquier código en el editor de secuencia de comandos con el siguiente código que dice lo siguiente: los datos de tu hoja de cálculo y los pasa como entrada a un flujo de trabajo ejecución:

      const PROJECT_ID = "your-project-id";
      const REGION = "us-central1";
      const WORKFLOW = "create-vm-from-form";
      
      function handleEdit(e) {
        var range = e.range.getA1Notation();
        var sheet = e.source;
      
        if (range.length > 1 && range[0] === 'H') {
          if (e.value == "TRUE") {
            Logger.log("Approved checkbox: true");
      
            var row = range.slice(1)
            var email = sheet.getRange('B' + row).getCell(1, 1).getValue()
            var vmName = sheet.getRange('c' + row).getCell(1, 1).getValue()
            var zone = sheet.getRange('D' + row).getCell(1, 1).getValue()
            var machineType = sheet.getRange('E' + row).getCell(1, 1).getValue()
            var diskSize = sheet.getRange('F' + row).getCell(1, 1).getValue()
            var imageFamily = sheet.getRange('G' + row).getCell(1, 1).getValue()
            var imageProject = imageFamily.substring(0, imageFamily.indexOf('-')) + "-cloud"
      
            const executionPayload = {
              "argument": "{\"diskSize\": \"" + diskSize + "\", \"email\": \"" + email + "\", \"imageFamily\": \"" + imageFamily + "\", \"imageProject\": \"" + imageProject + "\", \"machineType\": \"" + machineType + "\", \"vmName\": \"" + vmName + "\", \"zone\": \"" + zone +  "\"}"
            };
      
            approve(executionPayload);
          }
          else {
            Logger.log("Approved checkbox: false");
          }
        }
      }
      
      function approve(executionPayload) {
        const headers = {
          "Authorization": "Bearer " + ScriptApp.getOAuthToken()
        };
      
        const params = {
          "method": 'post',
          "contentType": 'application/json',
          "headers": headers,
          "payload": JSON.stringify(executionPayload)
        };
      
        const url = "https://workflowexecutions.googleapis.com/v1/projects/" + PROJECT_ID + "/locations/" + REGION + "/workflows/" + WORKFLOW + "/executions";
      
        Logger.log("Workflow execution request to " + url);
        var response = UrlFetchApp.fetch(url, params);
        Logger.log(response);
      }

   5. 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.

   6. Haz clic en Guardar save.

3. 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:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Activadores alarm.
   3. Haz clic en Agregar activador.
   4. En el diálogo Agregar activador para YOUR_PROJECT_NAME, configura la activador:
      1. En la lista Elige qué función ejecutar, selecciona handleEdit.
      2. En la lista Choose what deployment should run, selecciona Head.
      3. En la lista Seleccionar la fuente del evento, elige Desde una hoja de cálculo.
      4. En la lista Seleccionar tipo de evento, elige Al editar.
      5. En la lista Configuración de notificaciones de errores, selecciona Notificarme diariamente.
   5. Haz clic en Guardar.

   6. 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.

4. 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:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Configuración del proyecto settings.
   3. Selecciona la casilla de verificación Mostrar el archivo de manifiesto "appsscript.json" en el editor.
   4. Haz clic en Editor code.
   5. El archivo de manifiesto aparece como un archivo de proyecto llamado appsscript.json. Para editar el archivo, seleccionarlo.

   6. 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
      • Ver, editar, crear y borrar todos tus archivos de Hojas de cálculo

   7. Haz clic en Guardar save.

Implementa un flujo de trabajo que cree una instancia de VM

Implementar un flujo de trabajo que se active cuando se solicite crear una instancia de VM aprobado. 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.

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.

1. 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.

2. Para enviar tu respuesta, haz clic en Enviar.

3. Abre el formulario en Formularios.

4. Haz clic en Respuestas.

5. Haz clic en Ver en Hojas de cálculo.

   Se abrirá la hoja de cálculo vinculada.

6. En la fila de tu respuesta, selecciona la casilla de verificación ¿Aprobado?

7. Abre tu proyecto de Apps Script.

8. Haz clic en Ejecuciones playlist_play.

   El activador debería estar ejecutado y debe mostrarse con un estado Completed.

9. Confirma que el flujo de trabajo de create-vm-from-form se haya completado correctamente:

   Console

   1. En la consola de Google Cloud, ve a la página Flujos de trabajo.

      Ir a Workflows

   2. En la página Flujos de trabajo, haz clic en el create-vm-from-form para ir a su página de detalles.

   3. 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

10. 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.

    Ir a 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 con un estado que indique en ejecución.

    Para obtener más información sobre el comando gcloud compute instances list, consulta su página de referencia.