Como funcionam os conectores

O Workflows publica conectores para facilitar o acesso a outros produtos do Google Cloud em um fluxo de trabalho. Para uma referência detalhada sobre os conectores disponíveis, consulte a Referência de conectores.

Os conectores podem ser usados para se conectar a outras APIs do Google Cloud em um fluxo de trabalho e integrar seus fluxos de trabalho a esses produtos do Google Cloud. Por exemplo, é possível usar conectores para publicar mensagens do Pub/Sub, ler ou gravar dados em um banco de dados do Firestore ou recuperar chaves de autenticação do Secret Manager. Aprenda a usar um conector.

Os conectores simplificam os serviços de chamada porque processam a formatação das solicitações, fornecendo métodos e argumentos para que você não precise conhecer os detalhes de uma API Google Cloud.

Os conectores têm um comportamento integrado para processar novas tentativas e operações de longa duração.

Autenticação

Os conectores usam a autenticação integrada do Identity and Access Management para interagir com outros produtos do Google Cloud. Observe que um fluxo de trabalho que usa um conector ainda precisa ter as permissões apropriadas atribuídas à sua conta de serviço para ser autenticado corretamente em uma determinada API. Por exemplo, para publicar uma mensagem no Pub/Sub, a conta de serviço associada ao fluxo de trabalho precisa ter o papel roles/pubsub.publisher. Para saber mais sobre a autenticação em outros produtos do Google Cloud, consulte Conceda permissão a um fluxo de trabalho para acessar os recursos do Google Cloud.

Novas tentativas

Todos os conectores aplicam as seguintes políticas de repetição e configurações de tratamento de erros:

  • Os fluxos de trabalho usam uma política de repetição idempotente para solicitações GET.

  • Esse produto usa uma política de repetição não idempotente para todos os outros métodos HTTP.

  • Por padrão, as solicitações expiram após 30 minutos. Observe que, para operações de longa duração, isso se aplica a solicitações individuais (por exemplo, iniciar a operação ou verificar o status dela) dentro da operação de longa duração. O campo connector_params pode ser usado para configurar o tempo limite de todas as operações. Consulte a referência dos conectores.

Operações de longa duração

Os seguintes comportamentos se aplicam para chamadas que executam uma operação de longa duração:

  • Os fluxos de trabalho bloqueiam a execução do fluxo até que ela seja concluída ou falhe.

  • Por padrão, as chamadas expiram após 30 minutos. O tempo limite da chamada pode ser alterado usando o campo connector_params (no máximo um ano). Consulte a referência dos conectores.

  • Os conectores pesquisam operações de longa duração periodicamente. Por padrão, os fluxos de trabalho usam uma espera exponencial de 1,25 ao pesquisar, começando com 1 segundo e diminuindo para 60 segundos entre as pesquisas. Cada tentativa de pesquisa conta como uma etapa faturável. É possível alterar os parâmetros de pesquisa usando o campo connector_params. Consulte a referência dos conectores.

  • O mecanismo anterior de novas tentativas é aplicado em caso de falha na tentativa de pesquisa.

  • As respostas da pesquisa são verificadas, e, se o payload da resposta for inválido, um erro ResponseTypeError será retornado.

  • Quando ocorre um erro durante uma operação de longa duração, o Workflows gera um erro OperationError. O erro inclui outro atributo, error, que contém detalhes específicos da operação.

Se uma operação de longa duração falhar, a chamada do conector gerará uma exceção com os seguintes atributos:

  • message: mensagem legível de erro.
  • tags: uma lista de tags. Para uma chamada do conector de operação de longa duração, a lista inclui OperationError.
  • operation: o objeto da operação de longa duração com falha.

Para uma lista detalhada dos tipos de operação de longa duração compatíveis, consulte a referência dos conectores.

A seguir