envoyproxy/envoy

Clarify configuration validation tests and tools

Open

#15.377 aberto em 9 de mar. de 2021

Ver no GitHub
 (8 comments) (0 reactions) (0 assignees)C++ (5.373 forks)batch import
area/configurationarea/docshelp wantedtech debt

Métricas do repositório

Stars
 (27.997 stars)
Métricas de merge de PR
 (Mesclagem média 8d) (378 fundiu PRs em 30d)

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

Guia do colaborador

Direção de pesquisa
Revise a documentação existente para os métodos de validação de configuração no Envoy (modo de validação e validação protobuf Python) e identifique lacunas ou inconsistências. Proponha melhorias na documentação ou ferramentas de teste adicionais para esclarecer as diferenças e casos de uso.
Pilha de tecnologia
cpp
Domain
backendnetworking
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GitC++
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
70