All configuration can be managed entirely by the
ddev config command group. To locate the TOML config file, run:
ddev config find
All CLI commands are aware of the current repository context, defined by the option
repo. This option should be a reference to a key in
repos which is set to the path of a supported repository. For example, this configuration:
repo = "core" [repos] core = "/path/to/integrations-core" extras = "/path/to/integrations-extras" agent = "/path/to/datadog-agent"
would make it so running e.g.
ddev test nginx will look for an integration named
/path/to/integrations-core no matter what directory you are in. If the selected path does not exist, then the current directory will be used.
repo is set to
For running environments with a live Agent, you can select a specific build version to use with the option
agent. This option should be a reference to a key in
agents which is a mapping of environment types to Agent versions. For example, this configuration:
agent = "master" [agents.master] docker = "datadog/agent-dev:master" local = "latest" [agents."7.18.1"] docker = "datadog/agent:7.18.1" local = "7.18.1"
You can switch to using a particular organization with the option
org. This option should be a reference to a key in
orgs which is a mapping containing data specific to the organization. For example, this configuration:
org = "staging" [orgs.staging] api_key = "<API_KEY>" app_key = "<APP_KEY>" site = "datadoghq.eu"
would use the access keys for the organization named
staging and would submit data to the EU region.
The supported fields are:
To avoid GitHub's public API rate limits, you need to set
github.token in your config file or use the
DD_GITHUB_TOKEN environment variables.
ddev config show to see if your GitHub user and token is set.
ddev config set github.user <YOUR_GITHUB_USERNAME>
- Create a personal access token with
ddev config set github.tokenthen paste the token
- Enable single sign-on for the token
To participate as an Agent release manager, you need to set
trello.token in your config file.
ddev config show to see if your Trello key and token is set.
- Go to
https://trello.com/app-keyand copy your API key
ddev config set trello.keythen paste your API key
- Go to
<KEY>is your API key and
<NAME>is the name to give your token, e.g.
ReleaseTestingYourName. Authorize access and copy your token.
ddev config set trello.tokenand paste your token
When automatically assigning QA cards, the Trello users which are members of the
Agent Release Sprint Trello board will be fetched and cards will be assigned at random to them. Make sure people in your team are all members of the
Agent Release Sprint board.