Esta página foi traduzida pela API Cloud Translation.
Switch to English

Guia de início rápido sobre como usar a ferramenta gcloud

Neste guia de início rápido, mostramos como criar, implantar e executar seu primeiro fluxo de trabalho usando a ferramenta de linha de comando do gcloud. O fluxo de trabalho de amostra envia uma solicitação para uma API de amostra e usa a resposta para criar e enviar uma solicitação a uma API pública. O fluxo de trabalho retorna a segunda resposta da API.

Para ver uma lista de todos os comandos da ferramenta gcloud dos fluxos de trabalho, consulte a página de referência da ferramenta gcloud.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Instale e inicialize o SDK do Cloud..
  5. Ative a API Workflows.

    gcloud services enable workflows.googleapis.com
  6. Crie a conta de serviço. Substitua [NAME] por um nome para a conta de serviço.

    gcloud iam service-accounts create [NAME]
  7. Conceda o papel roles/logging.logWriter à conta de serviço.

    gcloud projects add-iam-policy-binding [PROJECT_ID] --member "serviceAccount:[NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role "roles/logging.logWriter"

    Substitua o seguinte:
    • [PROJECT_ID]: o ID do projeto;
    • [NAME]: o nome da conta de serviço que você acabou de criar.
    Observação: o campo Papel autoriza a conta de serviço a acessar recursos. Para enviar registros ao Cloud Logging, atribua o papel roles/logging.logWriter. Se você estiver desenvolvendo um aplicativo de produção, sempre conceda os papéis menos permissivos possíveis. Para mais informações, consulte Como atribuir papéis a contas de serviço. Para uma lista de papéis de fluxos de trabalho, consulte a Referência do controle de acesso.

Criar, implantar e executar um fluxo de trabalho

  1. Crie um novo arquivo chamado myFirstWorkflow.yaml ou myFirstWorkflow.json.

  2. Copie e cole uma das seguintes opções no novo arquivo e salve-a:

    YAML

    - getCurrentTime:
        call: http.get
        args:
          url: https://us-central1-workflowsample.cloudfunctions.net/datetime
        result: currentTime
    - readWikipedia:
        call: http.get
        args:
          url: https://en.wikipedia.org/w/api.php
          query:
            action: opensearch
            search: ${currentTime.body.dayOfTheWeek}
        result: wikiResult
    - returnResult:
        return: ${wikiResult.body[1]}

    JSON

    [
      {
        "getCurrentTime": {
          "call": "http.get",
          "args": {
            "url": "https://us-central1-workflowsample.cloudfunctions.net/datetime"
          },
          "result": "currentTime"
        }
      },
      {
        "readWikipedia": {
          "call": "http.get",
          "args": {
            "url": "https://en.wikipedia.org/w/api.php",
            "query": {
              "action": "opensearch",
              "search": "${currentTime.body.dayOfTheWeek}"
            }
          },
          "result": "wikiResult"
        }
      },
      {
        "returnResult": {
          "return": "${wikiResult.body[1]}"
        }
      }
    ]

    Esse fluxo de trabalho faz uma chamada para uma API de amostra com o objetivo de obter a data atual. Ele usa o dia da semana nessa resposta e a transmite para a API Wikipédia, onde ela procura artigos relevantes na Wikipédia sobre o dia atual da {101. }semana.

  3. Abra um terminal.

  4. Para implantar o fluxo de trabalho, insira o seguinte comando:

    gcloud workflows deploy myFirstWorkflow --source=myFirstWorkflow.yaml \
    --service-account=[NAME]@[PROJECT_ID].iam.gserviceaccount.com

    Substitua:

    • .yaml: substitua por .json se você copiou a versão JSON do fluxo de trabalho de exemplo.

    • [NAME]: o nome da conta de serviço que você criou anteriormente.

    • [PROJECT_ID]: o ID do projeto

    Esse comando implanta o fluxo de trabalho e o associa à conta de serviço especificada.

  5. Execute o fluxo de trabalho inserindo o seguinte comando:

    gcloud workflows execute myFirstWorkflow
    

    Isso retorna um comando workflows executions describe com o código exclusivo da tentativa de execução do fluxo de trabalho. A resposta será semelhante a:

    Created [cf1b1883-e271-4371-916a-10337bc1b87a].
    To view the workflow status, you can use following command:
    
    gcloud workflows executions describe cf1b1883-e271-4371-916a-10337bc1b87a --workflow myFirstWorkflow
    
  6. Para ver o status da execução, insira o comando retornado pela etapa anterior. Isso retorna dados sobre a execução do fluxo de trabalho, incluindo o resultado:

    argument: 'null'
    endTime: '2020-06-23T16:21:35.266171131Z'
    name: projects/123456789012/locations/us-central1/workflows/myFirstWorkflow/executions/f72bc6d4-5ea0-4dfb-bb14-2dae82303120
    result: '["Tuesday","Tuesday Weld","Tuesday Night Music Club","Tuesday (ILoveMakonnen
      song)","Tuesdays with Morrie","Tuesday Group","Tuesday Knight","Tuesday (Burak Yeter
      song)","Tuesday Morning Quarterback","Tuesday Maybe"]'
    startTime: '2020-06-23T16:21:34.826993288Z'
    state: SUCCEEDED
    workflowVersionId: '1'
    

Você implantou e executou seu primeiro fluxo de trabalho.

Limpeza

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

  1. Exclua o fluxo de trabalho criado inserindo o seguinte comando:

    gcloud workflows delete myFirstWorkflow
    
  2. Quando for perguntado se você quer continuar, digite y:

O fluxo de trabalho será excluído.

A seguir