Entender 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 dos 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.

Os conectores simplificam os serviços de chamada porque processam a formatação de solicitações para você, fornecendo métodos e argumentos para que você não precise saber os detalhes de uma API do 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 de gerenciamento de identidade e acesso 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 autenticar 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 receber 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 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 seu status) na operação de longa duração. O tempo limite de toda a operação pode ser configurado usando o campo connector_params. Consulte a referência dos conectores.

Operações de longa duração

Para chamadas que executam uma operação de longa duração, os seguintes comportamentos se aplicam:

  • 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 verificam 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 enquetes. Cada tentativa de votação 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 se aplica a uma tentativa de pesquisa com falha.

  • 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 de erro legível.
  • 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.

Próximas etapas