Ambientes e Publicação

Para que uma versão de fluxo possa receber requisições e ser executada pelos runners, ela precisa ser implantada em um Ambiente através do processo de Publicação. Essa arquitetura garante o isolamento entre contextos de execução (ex: desenvolvimento, homologação e produção) e a injeção dinâmica de configurações de infraestrutura sem a necessidade de modificar o modelo visual do fluxo.

Conceito de Ambiente

Um Ambiente representa um contexto de execução isolado que possui suas próprias URLs de serviço, repositórios de cache e políticas de acesso.

URLs de Serviço: Cada ambiente define suas rotas privadas (utilizadas por componentes internos como a Engine) e públicas (utilizadas por clientes externos).
Status do Ambiente: Os ambientes possuem monitoramento de conectividade contínuo no Console, indicando o estado de disponibilidade dos serviços associados.
Independência de Dados: Configurações de segurança, variáveis de ambiente e agendamentos configurados para um ambiente não interferem em outros ambientes onde a mesma versão do fluxo esteja publicada.

O Ciclo de Publicação

A publicação é o ato de disponibilizar uma Versão (nos estados DESENVOLVIMENTO ou PRONTO) para execução em um Ambiente específico.

┌─────────────────┐       Publicação       ┌─────────────────┐
│ Versão (Fluxo)  │ ─────────────────────► │    Ambiente     │
└────────┬────────┘                        └────────┬────────┘
         │                                          │
         ├── ► Escopos de Origem Permitidos         │ Sincronização
         ├── ► Variáveis Chave/Valor Local/Global   │ de Cache
         └── ► Regras de Segurança (API Key/CORS)   ▼
                                           ┌─────────────────┐
                                           │  Engine (Cache) │
                                           └─────────────────┘

1. Escopos de Origem da Publicação

Ao publicar uma versão em um ambiente, o desenvolvedor determina quais Escopos de Origem estão autorizados a disparar a execução do fluxo naquele ambiente:

PUBLICO

Permite chamadas externas autenticadas vindas da internet através da rota resolvida por slugs (/public/{slugProjeto}/{slugPacote}/{slugFluxo}).

INTERNO

Restringe o acionamento a chamadas internas da plataforma (como subfluxos acionados por autorreferência) através do código do fluxo (/internal/{coFluxo}).

AGENDADOR

Habilita o acionamento automático disparado pelo componente Agendador nos horários programados (/scheduler/{coFluxo}).

2. Sincronização de Cache em Tempo Real

Quando uma publicação é criada, atualizada ou removida, o Console dispara uma notificação de sincronização de cache para a Engine do ambiente alvo. Isso assegura que a Engine atualize suas definições em memória imediatamente, sem necessidade de reinicializar serviços ou interromper o tráfego de requisições.

Governança de Segurança por Ambiente

A segurança do fluxo é aplicada individualmente para cada ambiente publicado, permitindo isolar credenciais de teste e de produção:

Chaves de API (API Keys): As chaves de API são geradas por ambiente publicado, utilizando um sufixo aleatório associado a um hash criptográfico SHA-256. A Engine valida a API Key recebida no cabeçalho contra o índice de chaves ativas do ambiente antes de autorizar a execução.

Regras de CORS: Permitem definir explicitamente a lista de origens web (web_origin) autorizadas a realizar requisições para fluxos publicados no escopo público daquele ambiente específico.