Configuration¶
All configuration can be managed entirely by the ddev config
command group. To locate the TOML config file, run:
ddev config find
Repository¶
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 nginx
in /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.
By default, repo
is set to core
.
Agent¶
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"
would make it so environments that define the type as docker
will use the Docker image that was built with the latest commit to the datadog-agent repo.
Organization¶
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:
GitHub¶
To avoid GitHub's public API rate limits, you need to set github.user
/github.token
in your config file or use the DD_GITHUB_USER
/DD_GITHUB_TOKEN
environment variables.
Run ddev config show
to see if your GitHub user and token is set.
If not:
- Run
ddev config set github.user <YOUR_GITHUB_USERNAME>
- Create a personal access token with
public_repo
andread:org
permissions - Run
ddev config set github.token
then paste the token - Enable single sign-on for the token
Trello¶
To participate as an Agent release manager, you need to set trello.key
/trello.token
in your config file.
Run ddev config show
to see if your Trello key and token is set.
If not:
- Go to
https://trello.com/app-key
and copy your API key - Run
ddev config set trello.key
then paste your API key - Go to
https://trello.com/1/authorize?key=<KEY>&name=<NAME>&scope=read,write&expiration=never&response_type=token
, where<KEY>
is your API key and<NAME>
is the name to give your token, e.g.ReleaseTestingYourName
. Authorize access and copy your token. - Run
ddev config set trello.token
and paste your token
Card Assignment¶
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.