Cómo activar un flujo de trabajo desde Hojas de cálculo de Google

Crea un formulario para solicitar instancias de VM

Crear 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 creas un formulario a través de Formularios de Google, este se guarda en 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 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

4. Habilita la recopilación de correos electrónicos para registrar las direcciones de correo electrónico de las personas que completen tu formulario:
   1. Haz clic en Configuración.
   2. Expande la sección Responses.
   3. Haz clic en el botón de activación Recopilar direcciones de correo electrónico.

Vincula una hoja de cálculo a tu formulario

Después de crear un formulario, vincúlalo a una hoja de cálculo para que puedas guardar las respuestas en ella. La hoja de cálculo se guarda en Drive.

1. Abre el formulario en Formularios.
2. Haz clic en Respuestas.
3. Haz clic en Vincular a Hojas de cálculo.
4. En el diálogo Seleccionar el destino de las respuestas, selecciona Crear una hoja de cálculo nueva.

5. Haz clic en Crear.

   Se abrirá la hoja de cálculo vinculada.

6. En la columna H, agrega un encabezado ¿Aprobado?.

7. Coloca el cursor en la primera fila de la columna H y selecciona Insertar > Checkbox.

   La hoja de cálculo debería ser similar a la siguiente:

   

   Cada vez que se actualice la hoja con una respuesta, la casilla de verificación también aparecerá en la fila de esa respuesta.

Cómo extender 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 manipulan آرایه‌ها 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.

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

   1. Abre tu hoja de cálculo de Hojas de cálculo.
   2. Selecciona Extensiones > Apps Script.
   3. En el editor de secuencia de comandos, haz clic en Proyecto sin título.
   4. Asigna un nombre al proyecto y haz clic en Cambiar nombre.

   La secuencia de comandos ahora está vinculada a la hoja de cálculo, lo que le permite alterar la interfaz de usuario o responder cuando se abre la hoja de cálculo.

   Un proyecto de secuencia de comandos representa una colección de archivos y recursos de Apps Script. Los archivos de código de un proyecto de secuencia de comandos tienen una extensión .gs.

2. Puedes usar Apps Script para escribir funciones personalizadas 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:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Editor code.
   3. Un archivo de secuencia de comandos aparece como un archivo de proyecto llamado Code.gs. Para editar el archivo, selecciónalo.

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

      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. Los activadores instalables de Apps Script permiten que un proyecto de secuencia de comandos ejecute una función especificada cuando se cumplan ciertas condiciones, como cuando se abre o 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 el activador:
      1. En la lista Elige qué función ejecutar, selecciona handleEdit.
      2. En la lista Elige qué implementación se debe ejecutar, selecciona Head.
      3. En la lista Seleccionar fuente de eventos, selecciona Desde una hoja de cálculo.
      4. En la lista Seleccionar tipo de evento, selecciona En edición.
      5. En la lista Failure notification settings, selecciona Notify me daily.
   5. Haz clic en Guardar.

   6. Si recibes un mensaje para elegir una Cuenta de Google, selecciona la cuenta adecuada y, luego, haz clic en Permitir.

      Esto permite que tu proyecto de Apps Script vea, edite, creé y borre tus hojas de cálculo de Hojas de cálculo, y se conecte a un servicio externo.

4. El archivo de manifiesto de un proyecto de Apps Script es un archivo JSON que especifica la información básica del proyecto que Apps Script necesita para 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 la configuración de tu proyecto de Apps Script. 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, selecciónalo.

   6. El campo oauthScopes especifica un array de cadenas. Para establecer los permisos de autorización que usa tu proyecto, agrega un array con los permisos que deseas admitir. 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 permisos explícitos para lo siguiente:

      • 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

   7. Haz clic en Guardar save.

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 al conector de la API de Compute Engine para crear una instancia de VM de Compute Engine según las especificaciones recopiladas a través del formulario.

Prueba el flujo de extremo a extremo

Para confirmar que todo funciona según lo esperado, intenta ejecutar todo el proceso.

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, fallará la ejecución de tu flujo de trabajo. 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á tu 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 ejecutarse y aparecer con el 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 flujo de trabajo 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 una ejecución en particular, haz clic en el ID de ejecución correspondiente.

      El Estado de ejecución debería ser Correcto y, en el panel de 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 en la lista con un estado que indique que está 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.