Execute um fluxo de trabalho

A execução de um fluxo de trabalho executa a definição do fluxo de trabalho atual associada ao fluxo de trabalho.

Pode transmitir argumentos de tempo de execução num pedido de execução de fluxo de trabalho e aceder a esses argumentos através de uma variável de fluxo de trabalho. Para mais informações, consulte o artigo Transmita argumentos de tempo de execução num pedido de execução.

Após a conclusão da execução de um fluxo de trabalho, o respetivo histórico e resultados são retidos durante um período limitado. Para mais informações, consulte o artigo Quotas e limites.

Antes de começar

As restrições de segurança definidas pela sua organização podem impedir a conclusão dos seguintes passos. Para informações de resolução de problemas, consulte o artigo Desenvolva aplicações num ambiente Google Cloud restrito.

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Se um fluxo de trabalho aceder a outros Google Cloud recursos, certifique-se de que está associado a uma conta de serviço que tenha as autorizações corretas para o fazer. Para saber que conta de serviço está associada a um fluxo de trabalho existente, consulte Verifique a conta de serviço associada de um fluxo de trabalho.

    Tenha em atenção que, para criar um recurso e anexar uma conta de serviço, precisa de autorizações para criar esse recurso e para usar a identidade da conta de serviço que vai anexar ao recurso. Para mais informações, consulte o artigo Autorizações da conta de serviço.

  7. Implemente um fluxo de trabalho através da Google Cloud consola ou da CLI do Google Cloud.

    8. Execute um fluxo de trabalho

    Pode executar um fluxo de trabalho das seguintes formas:

    • Na Google Cloud consola
    • Usando a Google Cloud CLI no seu terminal ou no Cloud Shell
    • Enviando um pedido direto à API Workflows

    Também pode executar um fluxo de trabalho através das bibliotecas cliente da Google Cloud. Para mais informações, consulte o artigo Execute um fluxo de trabalho com as bibliotecas de cliente da Google Cloud.

    Consola

    1. Para executar um fluxo de trabalho, na Google Cloud consola, aceda à página Fluxos de trabalho:

      Aceder a Fluxos de trabalho

    2. Na página Fluxos de trabalho, selecione um fluxo de trabalho para aceder à respetiva página de detalhes.

    3. Na página Detalhes do fluxo de trabalho, clique em Executar.

    4. Na página Executar fluxo de trabalho, no painel Entrada, pode introduzir argumentos de tempo de execução opcionais para transmitir ao fluxo de trabalho antes da execução. Os argumentos têm de estar no formato JSON. Por exemplo, {"animal":"cat"}. Se o seu fluxo de trabalho não usar argumentos de tempo de execução, deixe este campo em branco.

    5. Opcionalmente, especifique o nível de registo de chamadas que quer aplicar à execução do fluxo de trabalho. Na lista Nível do registo de chamadas, selecione uma das seguintes opções:

      • Não especificado: não é especificado nenhum nível de registo. Esta é a predefinição. Um nível de registo de execução tem precedência sobre qualquer nível de registo de fluxo de trabalho, a menos que o nível de registo de execução não seja especificado (predefinição). Nesse caso, aplica-se o nível de registo de fluxo de trabalho.
      • Apenas erros: registe todas as exceções capturadas ou quando uma chamada é interrompida devido a uma exceção.
      • Todas as chamadas: registe todas as chamadas para subfluxos de trabalho ou funções da biblioteca e os respetivos resultados.
      • Sem registos: sem registo de chamadas.

    6. Opcionalmente, especifique o nível do histórico de execução que quer aplicar à execução do fluxo de trabalho. Na lista Histórico de execução, selecione uma das seguintes opções:

      • Herdar do fluxo de trabalho: aplique a definição do histórico de execução do fluxo de trabalho. Esta é a predefinição.
      • Básico: ative o histórico de execução básico.
      • Detalhado: ative o histórico de execução detalhado, incluindo todos os valores das variáveis no âmbito e o número esperado de iterações.

    7. Clique em Executar.

    8. Na página Detalhes da execução, pode ver os resultados da execução, incluindo qualquer resultado, o ID e o estado da execução, bem como o passo atual ou final da execução do fluxo de trabalho. Para mais informações, consulte Aceda aos resultados da execução do fluxo de trabalho.

    gcloud

    1. Abra um terminal.

    2. Encontre o nome do fluxo de trabalho que quer executar. Se não souber o nome do fluxo de trabalho, pode introduzir o seguinte comando para listar todos os seus fluxos de trabalho:

      gcloud workflows list

    3. Pode executar o fluxo de trabalho através do comando gcloud workflows run ou do comando gcloud workflows execute:

      • Execute o fluxo de trabalho e aguarde pela conclusão da execução:

        gcloud workflows run WORKFLOW_NAME \
    --call-log-level=CALL_LOGGING_LEVEL \
    --execution-history-level="EXECUTION_HISTORY_LEVEL" \
    --data=DATA

      • Execute o fluxo de trabalho sem esperar que a tentativa de execução termine:

        gcloud workflows execute WORKFLOW_NAME \
    --call-log-level=CALL_LOGGING_LEVEL \
    --execution-history-level="EXECUTION_HISTORY_LEVEL" \
    --data=DATA

        Substitua o seguinte:

        • WORKFLOW_NAME: o nome do fluxo de trabalho.

        • CALL_LOGGING_LEVEL (opcional): nível de registo de chamadas a aplicar durante a execução. Pode ser um dos seguintes:

          • none: não é especificado nenhum nível de registo. Esta é a predefinição. Um nível de registo de execução tem precedência sobre qualquer nível de registo do fluxo de trabalho, a menos que o nível de registo de execução não esteja especificado (predefinição). Nesse caso, aplica-se o nível de registo do fluxo de trabalho.
          • log-errors-only: registar todas as exceções capturadas; ou quando uma chamada é parada devido a uma exceção.
          • log-all-calls: registar todas as chamadas para subfluxos de trabalho ou funções da biblioteca e os respetivos resultados.
          • log-none: sem registo de chamadas.

        • EXECUTION_HISTORY_LEVEL (opcional): nível do histórico de execuções a aplicar durante a execução. Pode ser um dos seguintes: