envoyproxy/envoy

Native multi-file YAML config support like Nginx `include` directive

Open

#43 511 ouverte le 16 févr. 2026

Voir sur GitHub
 (2 commentaires) (0 réactions) (0 assignés)C++ (5 373 forks)batch import
enhancementhelp wanted

Métriques du dépôt

Stars
 (27 997 stars)
Métriques de merge PR
 (Merge moyen 7j 21h) (260 PRs mergées en 30 j)

Description

Feature Request Summary

Add native support for splitting Envoy bootstrap configuration across multiple YAML files, similar to Nginx's include directive and /etc/nginx/conf.d/*.conf directory scanning.

Motivation

Unlike Nginx, which seamlessly loads multiple config files from a directory into a unified config tree, Envoy requires a single bootstrap YAML file. Current workarounds like !ignore YAML fragments with anchors/aliases work but have limitations:

  • Still requires a "main" bootstrap file
  • Manual anchor management across files
  • No automatic directory scanning
  • Full reload needed for fragment changes
  • Not as intuitive for teams familiar with Nginx/HAProxy

This is especially painful for complex deployments (Kubernetes sidecars, Docker Compose with multiple services) where configs grow large and need modularization.

Guide contributeur

Direction de recherche
Étudiez le mécanisme de chargement de la configuration YAML d'Envoy et implémentez un balayage de répertoire similaire à la directive include de Nginx.
Stack technique
cpp
Domaine
infrastructuredevops
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Plus d'une semaine
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
C++EnvoyYAML
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
30