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 configuration files.
- In a CI/CD pipeline as a quality gate
- On your desktop to validate configuration files as you write them
- As a library within your existing go code
- XML
- JSON
- YAML
- TOML
There are several ways to install the config file validator tool
If you have a go environment on your desktop you can use go install to install the validator executable. The validator executable will be installed to the directory named by the GOBIN environment variable, which defaults to $GOPATH/bin or $HOME/go/bin if the GOPATH environment variable is not set.
go install github.com/Boeing/config-file-validator/cmd/validator
Executables are available for Linux and Windows (macOS coming soon!). Navigate to the releases page to download the latest version. Once the executable has been downloaded it needs to be installed by moving the downloaded file to a location on your OS PATH.
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
The project can be downloaded and built from source using an environment with golang 1.17+ installed. After successful build, the statically-linked binary can be moved to a location on your operating system PATH.
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)You can also use the provided Dockerfile to build the config file validator tool in a container
docker build . -t config-file-validator
We welcome contributions! Please refer to our contributing guide
The Config File Validator is released under the Apache 2.0 License