-
Notifications
You must be signed in to change notification settings - Fork 3.5k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add DroneCI pipeline stage to validate loki example configs; create example configuration files #4358
Add DroneCI pipeline stage to validate loki example configs; create example configuration files #4358
Conversation
333e7d3
to
833ae9d
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is looking good! I'd really like to see us template these configs themselves into the documentation to ensure they're continually up to date in the docs and that we're testing the correct configs.
cdab508
to
ed2d53f
Compare
ed2d53f
to
0338028
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've made quite a few suggestions on the comments in the YAML files. The files are all missing newlines at the end. It is good to have them in YAML files.
docs/sources/configuration/examples/almost-zero-dependency.yaml
Outdated
Show resolved
Hide resolved
docs/sources/configuration/examples/aws-basic-config-no-creds.yaml
Outdated
Show resolved
Hide resolved
docs/sources/configuration/examples/google-cloud-storage-config.yaml
Outdated
Show resolved
Hide resolved
docs/sources/configuration/examples/google-cloud-storage-config.yaml
Outdated
Show resolved
Hide resolved
…xample configuration files
… target for CI to verify doc is re-generated upon changes to example configs
…onal for config example doc checking
Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>
d874f02
to
f0954df
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, @JordanRushing. LGTM.
We can work out the generation check in CI with more idiomatic make targets, but happy to do that in a followup PR. Nice work! |
What this PR does / why we need it:
We want to provide some form of basic validation for example configurations that we provide to users to lower potential friction when experimenting with Loki.
This PR introduces:
make
targetsvalidate-example-configs
,generate-example-config-doc
,check-example-config-doc
check
to validate example configsdocs/sources/configuration/examples.md
is now dynamically generated based on the file contents of./docs/sources/configuation/examples/*.yaml
Which issue(s) this PR fixes:
N/A
Special notes for your reviewer:
N/A
Checklist