Como funcionam os conectores

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

Os conectores podem ser usados para se conectar a outras APIs Google Cloud em um fluxo de trabalho e integrar seus fluxos de trabalho a esses produtos 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 doGoogle 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 Conceder uma permissão de fluxo de trabalho para acessar Google Cloud recursos.

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