Skip to content

Latest commit

 

History

History
39 lines (23 loc) · 1.71 KB

CONTRIBUTING.md

File metadata and controls

39 lines (23 loc) · 1.71 KB
Raw

Contributing Guide

Developer Tasks

Setup Environment

First, You will need to install and configure Go on your computer.

Running Refinery Locally

Once you have your local environment setup, clone the Refinery repository. git clone https://github.com/honeycombio/refinery.git

Now that you have the source code, you can build refinery and ensure everything is working by running the command below at the root of the Refinery directory.

go run ./cmd/refinery/main.go -c config_complete.yaml -r rules_complete.yaml

Running Refinery tests locally

Tests require a local installation of redis. See here for how to get it running.

You can run Refinery tests by running the command below at the root of the Refinery directory.

make test

Making changes to configuration code

With the new configuration format redesign in v2.0.0, the workflow for making a configuration requires the following steps:

  • Make changes to the YAML tags for a configuration struct.
  • Update config/metadata/configMeta.yaml or config/metadata/rulesMeta.yaml to reflect such change.
  • Run the command below from inside the ./refinery/tools/convert/ directory to generate the updated config.md, config_complete.md, and rules.md. These two files are used to generate the official Refinery configuration documentation. make all
  • The rules_complete.yaml file is an example file constructed manually. If there are substantive changes to rules, you should manually update rules_complete.yaml.

References

Please see our general guide for OSS lifecycle and practices.