envoyproxy/envoy

Clarify configuration validation tests and tools

Open

#15 377 ouverte le 9 mars 2021

Voir sur GitHub
 (8 commentaires) (0 réactions) (0 assignés)C++ (5 373 forks)batch import
area/configurationarea/docshelp wantedtech debt

Métriques du dépôt

Stars
 (27 997 stars)
Métriques de merge PR
 (Merge moyen 8j) (378 PRs mergées en 30 j)

Description

description

there is more than one path to validation of envoy config:

  • starting daemon in "validate" mode
  • (python) protobuf validation

what these type of validation actually do, how best to validate, and what each tool validates is an ongoing source of confusion.

at very least we need to improve docs around dev/ci, and perhaps also clarify in main docs for end users

Guide contributeur

Direction de recherche
Examinez la documentation existante sur les méthodes de validation de configuration dans Envoy (mode de validation et validation protobuf Python) et identifiez les lacunes ou incohérences. Proposez des améliorations de documentation ou des outils de test supplémentaires pour clarifier les différences et les cas d'utilisation.
Stack technique
cpp
Domaine
backendnetworking
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
GitC++
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
70