Shared.Infra.Core — Consul KV com cache (TTL)

Leitura sob demanda do Consul KV com cache em memória.
Sem updater, sem setters: ao chamar GetKeyAsync, lê do cache; se ausente/expirado, busca no Consul, salva com TTL e retorna.

---

Registro (DI)

// Startup/Program services.AddConsulConfiguration( consulUrl: "http://consul:8500/v1/kv", // precisa incluir /v1/kv consulToken: Environment.GetEnvironmentVariable("CONSUL_TOKEN"), cacheDuration: TimeSpan.FromMinutes(5) // TTL do cache );

Uso

var consul = provider.GetRequiredService<IConsulService>(); // Retorna string ou null (se chave não existir) var valor = await consul.GetKeyAsync("meu/sistema/base-url", ct); // Em chamadas subsequentes dentro do TTL, retorna do cache. // Após expirar, reconsulta o Consul e renova o TTL.

Comportamento

• TTL (Time To Live): define por quanto tempo o valor fica válido no cache (configurado via cacheDuration).
• Erros:
  • Chave inexistente → null.
  • Falhas HTTP/transientes → tentativas com backoff; ao final, loga erro e retorna null.
• Thread-safe: usa IMemoryCache (concorrente) para armazenar as chaves.

O que foi removido

• Atualizações em background (Hosted Service / updater).
• “Setters”/normalizers e métodos auxiliares (JSON, invalidate, TTL dinâmico).

Requisitos

• .NET com Microsoft.Extensions.Caching.Memory e IHttpClientFactory.
• consulUrl apontando para o endpoint KV (ex.: http://host:8500/v1/kv).
• (Opcional) CONSUL_TOKEN para Consul protegido por ACL.