v0.15.0

La version v0.15.0, datée du 5 octobre 2026, est une version de sécurité et de résilience qui regroupe les corrections d’une revue de code menée avec deux modèles. Elle contient un changement incompatible : les surcharges par en-têtes d’Anthropic et d’Ollama exigent désormais allowHeaderOverride=true. Lisez les notes de mise à niveau avant de mettre à jour.

Mise à niveau

Mettez à niveau le cœur et chaque module optionnel que vous utilisez, ensemble :

go get gitlab.com/tranchida/gocamel@v0.15.0
go get gitlab.com/tranchida/gocamel/components/anthropic@v0.15.0

Chaque composant et module d’observabilité en v0.15.0 requiert le cœur v0.15.0.

Notes de mise à niveau

  • Surcharges par en-têtes d’Anthropic et d’Ollama (incompatible) : les en-têtes AnthropicSystem, AnthropicModel, AnthropicMaxTokens et AnthropicTemperature, ainsi que OllamaModel et OllamaSystem, sont désormais ignorés sauf si l’endpoint définit allowHeaderOverride=true. Pour conserver l’ancien comportement, ajoutez l’option à l’URI de l’endpoint, uniquement là où les en-têtes ne peuvent pas être influencés par une entrée non fiable :

    To("anthropic:messages?model=claude-sonnet-4-5&allowHeaderOverride=true")
    To("ollama:chat?model=llama3.1&allowHeaderOverride=true")
  • find MongoDB : un find sans limite renvoie au plus 10000 documents. Augmentez maxResults (0 = illimité) ou paginez avec CamelMongoDbLimit/CamelMongoDbSkip.

  • exec : stdout et stderr sont chacun plafonnés à 32 Mio ; vérifiez CamelExecOutputTruncated ou augmentez maxOutputSize.

  • Consommateur file : au plus 100000 fichiers ingérés sont mémorisés pour ignorer les événements en double. Un fichier évincé depuis longtemps puis modifié peut être ingéré de nouveau ; augmentez maxSeenEntries si nécessaire.

Sécurité

  • Anthropic et Ollama : les surcharges par en-têtes passent par allowHeaderOverride, comme dans tous les autres composants. Sur une route alimentée par une entrée non fiable, elles permettaient à un émetteur de remplacer le prompt système (injection de prompt) ou de choisir le modèle et le budget de tokens (coût).

Corrections

Résilience des consommateurs

  • NATS : une erreur d’abonnement autre qu’un timeout ne termine plus le consommateur alors que la route semble toujours démarrée. Le consommateur attend (backoff), se reconnecte ou se réabonne, et ne s’arrête qu’à l’annulation de son contexte.
  • STOMP : une erreur de lecture ou une frame ERROR du broker ne termine plus le consommateur : il se reconnecte et se réabonne avec un backoff exponentiel borné (de 100 ms à 5 s). Un ack qui échoue sur une connexion fermée n’est plus réessayé indéfiniment.
  • Kafka : un commit d’offset qui échoue est réessayé avec un backoff exponentiel (de 100 ms à 5 s) au lieu de toutes les 100 ms.

Timeouts réseau

  • STOMP : la connexion au broker et les handshakes TLS et STOMP sont bornés par connectTimeout (30 s par défaut), si bien qu’un broker injoignable ne bloque plus Start, Stop ni l’arrêt du CamelContext.
  • Mail : chaque chemin SMTP (simple, SMTPS, requireStartTLS) se connecte avec connectionTimeout et fixe une échéance avant chaque phase du protocole ; l’attente entre deux tentatives s’arrête dès la fin du contexte de l’échange.
  • Mail : les tentatives SMTP sont classées selon le code de réponse (5xx permanent, 4xx transitoire) et non plus selon des mots du message d’erreur.

Bornes mémoire

  • Consommateur file : la table des fichiers ingérés est plafonnée par maxSeenEntries.
  • exec : stdout et stderr sont plafonnés par maxOutputSize.
  • MongoDB : les résultats d’un find sont plafonnés par maxResults.

Cœur et autres composants

  • Choice : une expression When est analysée une seule fois, ce qui supprime une data race lorsqu’une analyse en échec était retentée à chaque échange.
  • SFTP : un déplacement ne tente plus le renommage quand la création du répertoire de destination a échoué (une erreur file does not exist était prise pour un répertoire existant).

Consultez le CHANGELOG pour la liste complète.

Nouvelles options

ComposantOptionDéfautDescription
stompconnectTimeout30sDélai maximal de la connexion TCP et des handshakes TLS et STOMP
filemaxSeenEntries100000Fichiers ingérés mémorisés pour ignorer les événements en double (0 = illimité)
execmaxOutputSize33554432 (32 Mio)Octets conservés de stdout et de stderr (0 = illimité) ; positionne CamelExecOutputTruncated en cas de dépassement
mongodbmaxResults10000Documents renvoyés par un find (0 = illimité) ; positionne CamelMongoDbResultsTruncated en cas de dépassement
anthropic, ollamaallowHeaderOverridefalseAutorise les en-têtes de surcharge à remplacer les paramètres de l’URI

Pour les changements de comportement par défaut de la v0.14.0, lisez les notes de version v0.14.0.