Acione um fluxo de trabalho no Planilhas Google

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Crie um formulário para solicitar instâncias de VM

Crie um formulário que possa ser usado para enviar uma solicitação para criar uma instância de máquina virtual (VM) do Compute Engine. Por padrão, quando você cria um formulário por meio do Formulários Google, ele é salvo no Google Drive .

1. Acesse formulários.google.com .
2. Clique em Branco .

   Um novo formulário é aberto.

3. Crie um formulário com cinco seções obrigatórias. O formulário deve ser semelhante ao seguinte:

   Ver modelo de formulário

   

   Nome da máquina	Texto de resposta curta
   Zona	Suspenso: us-central1-a us-central1-b us-central1-c us-central1-f
   Tipo	Suspenso: e2-micro e2-pequeno e2-médio e2-padrão-2 e2-padrão-4
   Tamanho do disco (GB)	Texto de resposta curta
   Sistema operacional	Suspenso: debian-10 centos-stream-9 cos-93-lts cos-97-lts

4. Ative a coleta de e-mail para registrar os endereços de e-mail das pessoas que preenchem seu formulário:
   1. Clique em Configurações .
   2. Expanda a seção Respostas .
   3. Clique no botão Coletar endereços de e-mail .

Vincule uma planilha ao seu formulário

Depois de criar um formulário, vincule uma planilha a ele para poder salvar as respostas do formulário nessa planilha. A planilha é salva no Drive .

1. Abra seu formulário em Formulários .
2. Clique em Respostas .
3. Clique em Link para planilhas .
4. Na caixa de diálogo Selecionar destino para respostas , selecione Criar uma nova planilha .

5. Clique em Criar .

   A planilha vinculada é aberta.

6. Na coluna H , adicione um Aprovado? cabeçalho.

7. Coloque o cursor na primeira linha da coluna H e selecione Inserir > Caixa de seleção .

   A planilha deverá ser semelhante à seguinte:

   

   Cada vez que a planilha for atualizada com uma resposta, a caixa de seleção também aparecerá na linha dessa resposta.

Estenda o Planilhas Google usando o Apps Script

O Apps Script permite criar, ler e editar planilhas de maneira programática. A maioria dos scripts projetados para o Planilhas manipula matrizes para interagir com células, linhas e colunas em uma planilha. Para obter uma introdução ao uso do Apps Script com Planilhas, consulte o início rápido da função personalizada .

1. Crie um projeto do Apps Script no Planilhas:

   1. Abra sua planilha do Planilhas.
   2. Selecione Extensões > Apps Script .
   3. No editor de script, clique em Projeto sem título .
   4. Dê um nome ao seu projeto e clique em Renomear .

   Seu script agora está vinculado à sua planilha, o que dá ao script a capacidade de alterar a interface do usuário ou responder quando a planilha for aberta.

   Um projeto de script representa uma coleção de arquivos e recursos do Apps Script. Os arquivos de código em um projeto de script possuem uma extensão .gs .

2. Você pode usar o Apps Script para escrever funções personalizadas que podem ser usadas no Planilhas como uma função integrada. Funções personalizadas são criadas usando JavaScript padrão. Crie uma função:

   1. Abra seu projeto do Apps Script.
   2. Clique em code do editor .
   3. Um arquivo de script aparece como um arquivo de projeto denominado Code.gs . Para editar o arquivo, selecione-o.

   4. Substitua qualquer código no editor de script pelo código a seguir, que lê os dados da sua planilha e os transmite como entrada para uma execução de fluxo de trabalho:

      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. Substitua your-project-id pelo seu Google Cloud ID do projeto.

      Você pode encontrar o ID do seu projeto na página de boas-vindas do Google Cloud console.

   6. Clique em Salvar save .

3. Os acionadores instaláveis ​​do Apps Script permitem que um projeto de script execute uma função específica quando determinadas condições são atendidas, como quando uma planilha é aberta ou editada. Crie um gatilho:

   1. Abra seu projeto do Apps Script.
   2. Clique em Aciona alarm .
   3. Clique em Adicionar gatilho .
   4. Na caixa de diálogo Adicionar acionador para YOUR_PROJECT_NAME , configure o acionador:
      1. Na lista Escolha qual função executar , selecione handleEdit .
      2. Na lista Escolha qual implantação deve ser executada , selecione Head .
      3. Na lista Selecionar origem do evento , selecione Da planilha .
      4. Na lista Selecionar tipo de evento , selecione Na edição .
      5. Na lista Configurações de notificação de falha , selecione Notificar-me diariamente .
   5. Clique em Salvar .

   6. Se você receber uma solicitação para escolher uma Conta do Google, selecione a conta apropriada e clique em Permitir .

      Isso permite que seu projeto do Apps Script veja, edite, crie e exclua suas planilhas do Planilhas; e para se conectar a um serviço externo.

4. Um arquivo de manifesto do projeto do Apps Script é um arquivo JSON que especifica informações básicas do projeto que o Apps Script precisa para executar um script com êxito. Observe que o editor do Apps Script oculta arquivos de manifesto por padrão para proteger as configurações do projeto do Apps Script. Edite o arquivo de manifesto:

   1. Abra seu projeto do Apps Script.
   2. Clique em settings do projeto .
   3. Marque a caixa de seleção Mostrar arquivo de manifesto "appsscript.json" no editor .
   4. Clique em code do editor .
   5. O arquivo de manifesto aparece como um arquivo de projeto chamado appsscript.json . Para editar o arquivo, selecione-o.

   6. O campo oauthScopes especifica uma matriz de strings. Para definir os escopos de autorização que seu projeto usa, adicione uma matriz com os escopos que você deseja ter suporte. Por exemplo:

      {
        "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"
        ]
      }

      Isso define escopos explícitos para:

      • Conecte-se a um serviço externo
      • Veja, edite, configure e exclua seu Google Cloud dados e veja o endereço de e-mail da sua Conta do Google
      • Veja, edite, crie e exclua todas as suas planilhas do Planilhas

   7. Clique em Salvar save .

Implantar um fluxo de trabalho que crie uma instância de VM

Implante um fluxo de trabalho que seja acionado quando uma solicitação para criar uma instância de VM for aprovada. O fluxo de trabalho chama o conector da API do Compute Engine para criar uma instância de VM do Compute Engine com base nas especificações coletadas por meio do formulário.

Teste o fluxo de ponta a ponta

Para confirmar se tudo está funcionando conforme o esperado, tente executar todo o processo.

1. Envie seu formulário para você mesmo e responda às perguntas adequadamente.

   Certifique-se de que as especificações usadas para criar uma instância de VM sejam válidas; caso contrário, a execução do fluxo de trabalho falhará. Para mais informações, consulte Família de máquinas de uso geral do Compute Engine .

2. Para enviar sua resposta, clique em Enviar .

3. Abra seu formulário em Formulários .

4. Clique em Respostas .

5. Clique em Exibir no Planilhas .

   Sua planilha vinculada é aberta.

6. Na linha da sua resposta, selecione Aprovado? caixa de seleção.

7. Abra seu projeto do Apps Script.

8. Clique em Execuções playlist_play .

   Seu gatilho deve ser executado e listado com o status Completed .

9. Confirme se o fluxo de trabalho create-vm-from-form foi concluído com êxito:

   Console

   1. No Google Cloud console, acesse a página Fluxos de trabalho .

      Vá para Fluxos de Trabalho

   2. Na página Fluxos de trabalho , clique no fluxo de trabalho create-vm-from-form para acessar sua página de detalhes.

   3. Na página Detalhes do fluxo de trabalho , para recuperar os detalhes de uma execução específica, clique no ID de execução apropriado.

      O estado de Execução deve ser Bem-sucedido e, no painel Entrada, você deverá ver as especificações da VM solicitadas.

   gcloud

   Recupere uma lista das tentativas de execução do seu fluxo de trabalho:

   gcloud workflows executions list create-vm-from-form

   O resultado deve ser semelhante ao seguinte:

   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. Confirme se uma nova VM foi criada conforme esperado:

    Console

    No Google Cloud console, acesse a página de instâncias de VM .

    Acesse as instâncias de VM

    Sua instância de VM deve ser listada com um status indicando que está em execução.

    gcloud

    Recupere uma lista agregada de todas as VMs em todas as zonas de um projeto:

    gcloud compute instances list

    Sua instância de VM deve ser listada com um status indicando que está em execução.

    Para obter mais informações sobre o comando gcloud compute instances list , consulte sua página de referência .