How many deployments have you done that needed to be rolled back due to a missing character in a configuration file in your repo? If you're like most teams that number is greater than zero. The config file validator was created to solve this problem by searching through your project and validating the syntax of all configuation files.
- In a CI/CD pipeline as a quality gate
- On your desktop to validate configuration files as you write them
- As a library in your existing go tools
- XML
- JSON
- YAML
Binaries and a container on Dockerhub will eventually be available but for now the project must be built on an environment that has golang 1.17+ installed.
CGO_ENABLED=0 \
GOOS=linux \
GOARCH=amd64 \
go build \
-ldflags='-w -s -extldflags "-static"' \
-tags netgo \
-o validator \
cmd/validator/validator.go
cp ./validator /usr/local/bin/
chmod +x /usr/local/bin/validator
CGO_ENABLED=0 \
GOOS=windows \
GOARCH=amd64 \
go build \
-ldflags='-w -s -extldflags "-static"' \
-tags netgo \
-o validator.exe \
cmd/validator/validator.go
mkdir -p 'C:\Program Files\validator'
cp .\validator.exe 'C:\Program Files\validator'
[Environment]::SetEnvironmentVariable("C:\Program Files\validator", $env:Path, [System.EnvironmentVariableTarget]::Machine)
The config file validator can be built as a docker container
docker build . -t config-file-validator
Usage of /validator:
-exclude-dirs string
Subdirectories to exclude when searching for configuration files
-search-path string
The search path for configuration files
validator -search-path /path/to/search
Exclude subdirectories in the search path
validator -search-path /path/to/search -exclude-dirs=/path/to/search/tests
docker run -it --rm -v /path/to/config/file/location:/test -search-path=/test
We welcome contributions! Please refer to our contributing guide
The Config File Validator is released under the Apache 2.0 License