envoyproxy/envoy

Clarify configuration validation tests and tools

Open

#15.377 aperta il 9 mar 2021

Vedi su GitHub
 (8 commenti) (0 reazioni) (0 assegnatari)C++ (5373 fork)batch import
area/configurationarea/docshelp wantedtech debt

Metriche repository

Star
 (27.997 star)
Metriche merge PR
 (Merge medio 8g) (378 PR mergiate in 30 g)

Descrizione

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

Guida contributor

Direzione di ricerca
Rivedi la documentazione esistente per i metodi di validazione della configurazione in Envoy (modalità di validazione e validazione protobuf Python) e identifica lacune o incongruenze. Proponi miglioramenti alla documentazione o strumenti di test aggiuntivi per chiarire le differenze e i casi d'uso.
Tech stack
cpp
Dominio
backendnetworking
Tipo issue
Documentazione
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
GitC++
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
70