monitor-gitlab-jobs 0.2.0

monitor Gitlab job statuses on the CLI

monitor-gitlab-jobs

Script to observe the status of all jobs in your latest Gitlab pipeline

Installation

pip install monitor-gitlab-jobs

Usage

usage: monitor-gitlab-jobs [-h] [--token TOKEN] [--ref REF] [--gitlab_url GITLAB_URL] project_id

monitor Gitlab job statuses on the CLI

positional arguments:
  project_id

options:
  -h, --help            show this help message and exit
  --token TOKEN
  --ref REF
  --gitlab_url GITLAB_URL

Features

• print a pretty table of all jobs of the latest pipeline (optionally given a ref) and their statuses
• groups jobs by stage
• update the table until all jobs are finished
• returns 0 if all jobs are either successful or skipped, 1 otherwise

Example outputs

$ monitor-gitlab-jobs 1234 --token $GITLAB_ACCESS_TOKEN --gitlab_url $GITLAB_URL --ref 0.6.4
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Stage ┃ Job                      ┃ Status     ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ test  │ run_tests                │ ✅ success │
├───────┼──────────────────────────┼────────────┤
│ build │ build_docker             │ ✅ success │
└───────┴──────────────────────────┴────────────┘
No jobs failed

$ monitor-gitlab-jobs 5678 --token $GITLAB_ACCESS_TOKEN --gitlab_url $GITLAB_URL
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Stage ┃ Job                       ┃ Status     ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ test  │ unit_test                 │ 🏃 running │
│       │ integration_test          │ 🕓 pending │
├───────┼───────────────────────────┼────────────┤
│ lint  │ lint                      │ ✅ success │
├───────┼───────────────────────────┼────────────┤
│ build │ build                     │ ✅ success │
└───────┴───────────────────────────┴────────────┘
⠹ waiting for jobs to finish...