@mozaik/ext-gitlab
v2.0.0-alpha.9
Published
Mozaik GitLab widgets
Downloads
13
Readme
Mozaïk GitLab widgets
This repository contains some widgets to use with Mozaïk.
You can see a live demo of this extension here
This branch contains code for the version compatible with Mozaïk v2, if you're looking for v1, please use mozaik-1 branch.
- client configuration
- widgets
Client Configuration
In order to use the Mozaïk gitlab extension, you must configure its client. Configuration is loaded from environment variables.
| env key | required | default | description
|------------------|----------|---------|----------------------------
| GITLAB_BASE_URL | yes | | gitlab API base url, eg. 'https://gitlab.com/api/v4
| GITLAB_API_TOKEN | yes | | gitlab API token
Project
Show GitLab project info.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: Project
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
Project Members
Show GitLab project members.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: ProjectMembers
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
GitLab Branches
Show GitLab project branches.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: Branches
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
LatestProjectPipeline
Show details about latest project pipeline.
parameters
key | type | required | default | description
--------------------|-------------|----------|---------|-------------
project
| {string}
| yes | | ID or NAMESPACE/PROJECT_NAME of a project
gitRef
| {string}
| no | | Get latest pipeline for a specific ref (branch, tag…)
hideCommitMessage
| {boolean}
| no | false
| Hide pipeline commit info
usage
- extension: gitlab
widget: LatestProjectPipeline
project: gitlab-org/gitlab-runner
gitRef: master
hideCommitMessage: false
columns: 2
rows: 1
x: 0
y: 0
GitLab Job Histogram
Show GitLab project job histogram.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: JobHistogram
project: gitlab-org/gitlab-ce
columns: 2
rows: 1
x: 0
y: 0
GitLab Job History
Show GitLab project job history.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: JobHistory
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
GitLab Project Contributors
Show GitLab project contributors.
parameters
key | required | description
----------|----------|--------------------------
project
| yes | ID or NAMESPACE/PROJECT_NAME of a project
usage
- extension: gitlab
widget: ProjectContributors
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
GitLab labels bubble chart
Show GitLab project's labels stats using a bubble chart.
parameters
key | required | default | description
----------|----------|-----------------------|----------------
project
| yes | n/a | ID or NAMESPACE/PROJECT_NAME of a project
countBy
| yes | 'open_issues_count'
| Defines which count to use, must be one of: 'open_issues_count'
, 'closed_issues_count'
, 'open_merge_requests_count'
title
| no | n/a | Overrides widget title
usage
- extension: gitlab
widget: LabelsBubble
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
GitLab labels pie
Show GitLab project's labels stats using a pie chart.
parameters
key | required | default | description
----------|----------|-----------------------|----------------
project
| yes | n/a | ID or NAMESPACE/PROJECT_NAME of a project
countBy
| yes | 'open_issues_count'
| Defines which count to use, must be one of: 'open_issues_count'
, 'closed_issues_count'
, 'open_merge_requests_count'
title
| no | n/a | Overrides widget title
usage
- extension: gitlab
widget: LabelsPie
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0
GitLab labels tree map
Show GitLab project's labels stats using a tree map chart.
parameters
key | required | default | description
----------|----------|-----------------------|----------------
project
| yes | n/a | ID or NAMESPACE/PROJECT_NAME of a project
countBy
| yes | 'open_issues_count'
| Defines which count to use, must be one of: 'open_issues_count'
, 'closed_issues_count'
, 'open_merge_requests_count'
title
| no | n/a | Overrides widget title
usage
- extension: gitlab
widget: LabelsTreemap
project: gitlab-org/gitlab-ce
columns: 1
rows: 1
x: 0
y: 0