Skip to content

Latest commit

 

History

History
77 lines (56 loc) · 2.16 KB

CONTRIBUTING.md

File metadata and controls

77 lines (56 loc) · 2.16 KB

Contributing

  1. Sign the CLA.
  2. Open a new issue to discuss the changes you would like to make. This is not strictly required but it may help reduce the amount of rework you need to do later.
  3. Make changes or write plugin using the guidelines in the following documents:
  4. Ensure you have added proper unit tests and documentation.
  5. Open a new pull request.

Security Vulnerability Reporting

InfluxData takes security and our users' trust very seriously. If you believe you have found a security issue in any of our open source projects, please responsibly disclose it by contacting security@influxdata.com. More details about security vulnerability reporting, including our GPG key, can be found here.

GoDoc

Public interfaces for inputs, outputs, processors, aggregators, metrics, and the accumulator can be found in the GoDoc:

GoDoc

Common development tasks

Adding a dependency:

Assuming you can already build the project, run these in the telegraf directory:

  1. dep ensure -vendor-only
  2. dep ensure -add github.com/[dependency]/[new-package]

Unit Tests:

Before opening a pull request you should run the linter checks and the short tests.

Run static analysis:

make check

Run short tests:

make test

Execute integration tests:

Running the integration tests requires several docker containers to be running. You can start the containers with:

docker-compose up

And run the full test suite with:

make test-all

Use make docker-kill to stop the containers.