Visão Geral e Arquitetura de Plugins

Os Runners Plugin são conectores especializados da plataforma projetados para interagir diretamente com recursos e serviços externos de infraestrutura.

Diferente dos Runners Core (que tratam do fluxo e da mecânica interna da Engine), os Plugins abstraem os protocolos de comunicação, gerenciamento de conectividade, pools de conexões e validação de segurança de provedores externos.

O Modelo de Abstração e Instâncias de Conexão

Os Runners Plugin são projetados sob o princípio de descolamento de tecnologia: a etapa do fluxo declara o que deseja realizar através de um contrato padronizado, enquanto os detalhes do provedor real (host, porta, credenciais, timeouts) são encapsulados em Instâncias de Conexão gerenciadas no nível do ambiente.

┌────────────────────────────────────────────────────────────────────────┐
│                        ETAPA DO FLUXO (DESENHO)                        │
│   - Motor: DATASOURCE_JDBC, CACHE_REDIS ou AUTH_JWT                    │
│   - Configuração de Operação (Query SQL, Chave de Cache, Algoritmo)    │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │ Referência de Instância
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                        INSTÂNCIA DO PLUGIN / PROVEDOR                  │
│   - Credenciais e Pool de Conexões                                     │
│   - Endpoints, Hosts e Portas do Provedor Externo                      │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
            ┌───────────────────────┼───────────────────────┐
            ▼                       ▼                       ▼
┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
│ Banco de Dados JDBC   │ │ Servidor Cache Redis  │ │ Provedor de Identidade│
│ (PostgreSQL, Oracle,  │ │ (Redis Standalone,    │ │ (Keycloak, Auth0,     │
│  SQL Server, MySQL)   │ │  Cluster, Sentinel)   │ │  Okta, OIDC Custom)   │
└───────────────────────┘ └───────────────────────┘ └───────────────────────┘

Banco de Dados JDBC

PostgreSQL, Oracle, SQL Server, MySQL e demais bancos relacionais suportados pelo driver JDBC.

Servidor Cache Redis

Redis nas arquiteturas Standalone, Cluster ou Sentinel.

Provedor de Identidade

Keycloak, Auth0, Okta e servidores OIDC customizados.

Benefícios da Arquitetura por Instâncias

Isolamento de Segurança e Credenciais: O desenvolvedor do fluxo não insere senhas, chaves privadas ou URLs de banco de dados diretamente nos nós do diagrama visual. A etapa apenas aponta para o nome da instância de conexão configurada para aquele ambiente.
Portabilidade entre Ambientes: Um mesmo fluxo pode rodar em Desenvolvimento apontando para um banco de dados local e em Produção apontando para um cluster de alta disponibilidade, alterando apenas a resolução da instância sem modificar a definição do fluxo.
Reutilização de Pools de Conexão: A plataforma gerencia o ciclo de vida das conexões físicas em memória, reutilizando pools de alta performance para reduzir a latência de abertura e fechamento de sessões com os provedores externos.