Repositories

Adding a repository

Create your first repository and add the git url in order for tasks to be able to clone that repo.

Configuring repository branches

Once you have a repository created, you can create Repository Branch objects. A repository branch maps a particular branch, configured by either regex or name. When a repository event is triggered (by webhook) this will look at which branch the event was triggered on. If a match is found, the branch configuration will indicate one of two things: which Environment/Job to run OR which Build to trigger. This will let the job that runs know what commit will be checked out by any Git tasks.

Once you have a branch configured, a webhook that is dispatched to the repo url will create a Run based on what Environment/Job or Build is attached to the Repository Branch configuration. The webhook url is derived from the id of the created repository. You can configure your git provider with the url /api/custom/{repository_id}/webhook Currently only Gitea is supported, though with community involvement, we could easily support more in the future.

You can get the URL to the webhook endpoint by copying the link that is presented in the table on the Repository creation screen.

Configuring webhooks

Once you've got the link to the repository webhook endpoint, configure that endpoint on your git system of choice.

Repository Events

When events are encountered that hit the webhook endpoint, DMT will run the configured Environment/Job or Build against that commit. Note that webhook events can be simulated in order to ease testing webhook configuration.