Repository navigation
feature flags
Home > Plugins > Feature flags 🚧
Important
Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.
Vale para a 2.0 · Delphi XE em diante e Lazarus/FPC 3.2 em diante · Nível: intermediário
Em uma frase: o TRALFeatureFlags liga e desliga recursos sem gerar um executável
novo: para todos, para uma parte dos usuários (sempre os mesmos), para uma lista de
usuários ou papéis, ou entre duas datas; rotas de um recurso desligado respondem 404.
Você vai precisar: o pacote RALPluginFeatureFlagsPackage (requer o
RALHostingPackage, da configuração externa).
- Solte um
TRALFeatureFlagsno form e ligueServer(é um plugin; funciona também sem servidor, só comIsEnabled). - Em
Flags, um item por recurso:
| propriedade | o que é |
|---|---|
Name |
o nome que o código e a configuração usam (checkout-novo) |
Enabled |
a chave geral: desligada, ninguém tem |
Percentage |
a parte dos usuários que tem o recurso, de 0 a 100 |
Users, Roles
|
usuários e papéis que sempre têm, um por linha |
StartDate, EndDate
|
de quando até quando vale (0 = sem limite) |
Paths |
rotas que só existem com o recurso ligado (/checkout/novo); desligado, 404 |
Percentage usa um número fixo de cada usuário para aquele recurso (um hash do nome do
recurso e do usuário): o mesmo usuário cai sempre do mesmo lado, e subir de 20 para 50
só acrescenta usuários, ninguém que tinha perde. O usuário de um pedido é o nome da
identidade (quem fez login); sem login, o endereço do cliente.
if FFlags.IsEnabled('checkout-novo', ARequest) then // o usuário do pedido
MontarCheckoutNovo(AResponse)
else
MontarCheckoutAntigo(AResponse);
if FFlags.IsEnabled('relatorio-beta', 'ana') then ... // um usuário qualquerOnEvaluate deixa o código ter a última palavra (um cliente pagante, por exemplo).
Com Config ligado a um TRALConfig, os recursos também vêm do
arquivo, das variáveis de ambiente e da linha de comando, com o prefixo ConfigPrefix
(padrão Flags):
{
"Flags": {
"checkout-novo": { "Enabled": true, "Percentage": 20, "Users": ["ana", "bia"] },
"relatorio-beta": { "Roles": ["beta"], "Percentage": 0, "EndDate": "2026-12-31" }
}
}- O que vem da configuração soma-se aos itens do Object Inspector e, no mesmo nome, vence.
- Uma mudança no arquivo vale sem reiniciar: o plugin olha o arquivo no máximo a cada
ReloadIntervalmilissegundos (padrão 2000) eOnChangeavisa.Reloadforça. - Datas:
aaaa-mm-ddouaaaa-mm-ddThh:nn:ss, na hora local.
| sintoma | causa | o que fazer |
|---|---|---|
| a rota responde 404 para todos |
Enabled desligado, ou fora das datas |
confira o item e a configuração |
| o mesmo usuário vê ora um, ora outro | sem login, o "usuário" é o endereço do cliente | faça o login antes, ou passe o usuário a IsEnabled
|
| a mudança no arquivo não pegou |
ReloadInterval 0, ou o arquivo é outro |
Reload, ou confira Config.FileName
|
Começar
Servidor
- Rotas e parâmetros
- Rotas avançadas: tipos, grupos, versões 🚧
- Ler o pedido e responder
- Objetos no corpo 🚧
- Resposta em fluxo 🚧
- Plugins 🚧
- Serviços (contêiner de dependências) 🚧
- Barramento de eventos 🚧
- Tarefas em segundo plano 🚧
- Recursos com estado 🚧
- Autenticação
- Banco de dados (DBWare)
- Servir site e arquivos
- JSON-RPC 2.0 🚧
- Servidor MCP (IA) 🚧
-
Protocol Buffers 🚧
- gRPC 🚧
- WebSocket 🚧
- Hubs (WebSocket) 🚧
- Swagger e Postman
- Servidor SOAP 🚧
- WS-Security 🚧
- HTTPS
- Criptografia ponto a ponto
- Segurança para produção
- Colocar no ar
- Desempenho
- Testes em memória 🚧
MQTT 🚧
- O que é e quando usar 🚧
- Cliente MQTT 🚧
- Broker MQTT 🚧
- MQTT-SN 🚧
- Ponte REST 🚧
- Segurança 🚧
- Rede ruim 🚧
E-mail 🚧
- Mensagens 🚧
- Enviar 🚧
- Receber 🚧
- Ler a caixa postal 🚧
- Verificar o que chega 🚧
- Servir caixas postais 🚧
- S/MIME 🚧
- OpenPGP 🚧
Chatbot 🚧
- O robô e os canais 🚧
- Telegram 🚧
- Gateways REST (WhatsApp não oficial) 🚧
- Discord 🚧
- Slack 🚧
- Microsoft Teams 🚧
- Conversa em etapas 🚧
Cliente
Motores
- Qual motor escolher?
- Compatibilidade
- Recursos
- QUIC
- Motor NgHttp2 (HTTP/2) 🚧
- Motor XSocket 🚧
- Motor AdvancedHTTP (experimental) 🚧
Avançado
Ajuda
- Problemas comuns
- Atualizar o Indy
- Várias versões do Delphi
- Vídeos e guias
- Módulos de terceiros
- Licenças
- Contribuir
- Roadmap e changelog
🚧 = em desenvolvimento, pode mudar