Deps can run directly in GitLab CI using a pipeline schedule.

If your CI is separated into language-specific containers, you can use the --type option to tell deps which updates to run.

A minimal example of .gitlab-ci.yml would look like this:

# .gitlab-ci.yml
  image: "node:latest"
  only: [schedules]
    - curl -sSL | bash -s -- -b $HOME/bin
    - yarn install
    - $HOME/bin/deps ci --type js

  image: "python:3"
  only: [schedules]
    - curl -sSL | bash -s -- -b $HOME/bin
    - pipenv sync --dev
    - $HOME/bin/deps ci --type python

Pipeline schedule

Configure a pipeline schedule for running deps. It will need two variables:

  1. A DEPS_TOKEN from
  2. A DEPS_GITLAB_TOKEN that is a personal access token.

GitLab pipeline schedule for deps

Personal access token

The standard way to give deps write-access to your repo is with a personal access token. You can use your personal account to do this, or a "bot" account that your team has.

  1. Log in with the account you want deps to use (this will be the author of deps pull requests)
  2. Give it access to the repo you're setting up
  3. Generate a new token with the write_repository and api scopes GitLab personal access token settings for deps
  4. Set the DEPS_GITLAB_TOKEN environment variable in your CI

Merge request settings

When working with a GitLab repo, there are a few settings you can use to determine what your MRs look like.

# deps.yml
version: 3
- type: python
    gitlab_target_branch: "dev"
    gitlab_labels: ["dependencies"]
    gitlab_assignee_id: 1
    gitlab_assignee_ids: [1, 2]
    gitlab_target_project_id: 1
    gitlab_milestone_id: 1
    gitlab_remove_source_branch: true
    gitlab_allow_collaboration: true
    gitlab_allow_maintainer_to_push: true
    gitlab_squash: true

If you don't need a deps.yml then you can also configure these settings via environment variables. This is an easy way to put settings directly in your CI config.

Note that they'll need to be in the format of a JSON-encoded string, with an uppercase name prefixed by DEPS_SETTING_.

$ DEPS_SETTING_GITLAB_LABELS='["dependencies"]' deps ci