Skip to content

Gitlab CI Dashboard will provide you a global overview of all pipelines, schedules and their status within a single group

License

Notifications You must be signed in to change notification settings

larscom/gitlab-ci-dashboard

Repository files navigation

Gitlab CI Dashboard

Docker Image Version workflow License MIT

Preview


Gitlab CI Dashboard will provide you with a global overview of all pipelines, schedules, and their statuses within a single group. The default functionality of Gitlab is limited at the project level. This can become problematic when you have a lot of projects to manage, potentially resulting in undetected failed pipelines.

Demo may contain functionality that has not been released yet.


🚀 Highlights

  • View all pipeline statuses per group (e.g: failed/canceled/success)
  • View all pipeline schedules per group
  • You won't get rate limited by the Gitlab API, due to server-side caching
  • Communication to the Gitlab API happens only server side
  • Only 1 read only token is needed to serve a whole team

📒 Checklist

  • Overview of all latest pipeline statuses within a group
  • Overview of all pipeline statuses within a group
  • Overview of all schedules within a group
  • Overview of all artifacts within a group
  • ...

⚡️ Requirements

  • Gitlab server (v4 API)
  • Readonly API token
  • Docker

💡 Getting started

  1. Generate a read_api access token in Gitlab (e.g: https://gitlab.com/-/profile/personal_access_tokens)

Access Token

  1. Run docker with the required environment variables (GITLAB_BASE_URL, GITLAB_API_TOKEN)
docker run -p 8080:8080 -e GITLAB_BASE_URL=https://gitlab.com -e GITLAB_API_TOKEN=my_token larscom/gitlab-ci-dashboard:latest
  1. Dashboard should be available at: http://localhost:8080/ showing (by default) all available groups and their projects

⏰ Prometheus

Prometheus metrics are exposed on the following endpoint

http://localhost:8080/metrics/prometheus

🔌 Environment variables

Variable Type Description Required Default
GITLAB_BASE_URL string The base url to the Gitlab server (e.g: https://gitlab.com) yes
GITLAB_API_TOKEN string A readonly access token generated in Gitlab (see: https://gitlab.com/-/profile/personal_access_tokens) yes
GITLAB_GROUP_ONLY_IDS string Provide a comma seperated string of group ids which will only be displayed (e.g: 123,789,888) no
GITLAB_GROUP_SKIP_IDS string Provide a comma seperated string of group ids which will be ignored (e.g: 123,789,888) no
GITLAB_GROUP_ONLY_TOP_LEVEL bool Show only top level groups no false
GITLAB_GROUP_CACHE_TTL_SECONDS int Expire after write time in seconds for groups (cache) no 300
GITLAB_PROJECT_SKIP_IDS string Provide a comma seperated string of project ids which will be ignored (e.g: 123,789,888) no
GITLAB_PROJECT_CACHE_TTL_SECONDS int Expire after write time in seconds for projects (cache) no 300
GITLAB_PIPELINE_CACHE_TTL_SECONDS int Expire after write time in seconds for pipelines (cache) no 10
GITLAB_PIPELINE_HISTORY_DAYS int How far back in time (days), it should fetch pipelines from gitlab (pipelines tab only) no 5
GITLAB_BRANCH_CACHE_TTL_SECONDS int Expire after write time in seconds for branches (cache) no 60
GITLAB_SCHEDULE_CACHE_TTL_SECONDS int Expire after write time in seconds for schedules (cache) no 300
GITLAB_JOB_CACHE_TTL_SECONDS int Expire after write time in seconds for jobs (cache) no 10
SERVER_LISTEN_IP string The IP address where the web server should listen on no 0.0.0.0
SERVER_LISTEN_PORT int The port where the web server should listen on no 8080
SERVER_WORKER_COUNT int The amount of worker threads the web server should have no CPU specific
RUST_LOG string The log level of the application, set to "debug" to enable debug logging no info