This package provides the secure downloader used by the Datadog Agent to download Agent-based Integrations (also known as Checks). Internally, it uses The Update Framework (TUF) and in-toto in order to provide end-to-end verification of integrations between our developers and end-users. There is a blog post forthcoming shortly that will explain in more detail the security guarantees. Interested readers may also wish to consult our KubeCon 2018 talk for more details.
Presently, the downloader is limited to downloading packages of integrations-core, but not integrations-extras.
This package is expected to be built and included with the DataDog Agent beginning with version 6.10.0. There is a blog post forthcoming shortly that will explain in more detail how to use the Datadog Agent to transparently download and install new or updated integrations.
Create a dedicated virtualenv and follow the instructions in this paragraph to work with the check.
To install the check in dev mode:
pip install -e .[dev]To download a new or updated integration, you may specify a precise version:
datadog-checks-downloader -vvvv datadog-$INTEGRATION --version X.Y.ZOr you may leave the version unspecified to download the latest version:
datadog-checks-downloader -vvvv datadog-$INTEGRATIONTo run the tests, install tox and just run:
toxNeed help? Contact Datadog support.