envoyproxy/envoy

Clarify configuration validation tests and tools

Open

#15.377 geöffnet am 9. März 2021

Auf GitHub ansehen
 (8 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)C++ (5.373 Forks)batch import
area/configurationarea/docshelp wantedtech debt

Repository-Metriken

Stars
 (27.997 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 8T) (378 gemergte PRs in 30 T)

Beschreibung

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

Contributor Guide

Research-Richtung
Überprüfen Sie die vorhandene Dokumentation für Konfigurationsvalidierungsmethoden in Envoy (Validierungsmodus und Python Protobuf Validierung) und identifizieren Sie Lücken oder Inkonsistenzen. Schlagen Sie Dokumentationsverbesserungen oder zusätzliche Testtools vor, um die Unterschiede und Anwendungsfälle zu klären.
Tech Stack
cpp
Domain
backendnetworking
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
GitC++
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
70