Easily create Jira releases from the comfort zone of your CLI! :)
ydemetriades/jira-release
docker image enables the creation of Release Versions in Jira.
You can find it at DockerHub.
ydemetriades/jira-release
is available both for Linux and Windows.
Tag | Version | Pull |
---|---|---|
v1.0 | v1.0 | ydemetriades/jira-release:v1.0 |
v2.0 | v2.0 | ydemetriades/jira-release:v2.0 |
Note: latest
tag points to v2.0
ydemetriades/jira-release
on Windows is available only for 1809
Tag | Version | Pull |
---|---|---|
v1.0-win1809 | v1.0 | ydemetriades/jira-release:v1.0-win1809 |
v2.0-win1809 | v2.0 | ydemetriades/jira-release:v2.0-win1809 |
Note: latest-win1809
tag points to v2.0-win1809
From v2.0.0
all parameters are passed as executable arguments or by environment variables.
Parameter | Environment Variable | Required | Description | Default Value | Available Options | Example |
---|---|---|---|---|---|---|
--version , -v |
JIRA_VERSION_NAME |
Yes | The unique name of the version | - | - | -v v1.0 |
--project , -p |
JIRA_PROJ |
Yes | The ID of the project to which this version is attached | - | - | -p 10000 |
--user , -u |
JIRA_AUTH_USER |
Yes | The Jira authentication user [email] | - | - | -u user |
--password |
JIRA_AUTH_PASSWORD |
Yes | Jira API Authorization Password / API Token | - | - | --password 12345 |
--description , -d |
JIRA_VERSION_DESCRIPTION |
No | The description of the version. Default value is an empty string. | - | - | -d "My awesome version description!" |
--update |
JIRA_VERSION_UPDATE |
No | Indicates whether to update/create the version. Avoidance/False indicates creation where definition/True indicated update |
- | - | - |
--released |
JIRA_VERSION_RELEASED |
No | Indicates that the version is released. | - | - | --released |
--archived |
JIRA_VERSION_ARCHIVED |
No | Indicates that the version is archived. | - | - | --archived |
--url |
JIRA_URL |
No | Jira Url | https://jira.org | - | --url https://jira.mydomain.com |
--api-version |
JIRA_API_VERSION |
No | Jira API Version | 3 | [2, 3] | --api-version 3 |
-
Enable Jira Api from Administration Settings
-
User JIRA_AUTH_USER must be an Administrator for JIRA_PROJ project
jira-release.py -v v1.0.0 -p 10000 -u youremail@example.com --password 'YOUR_API_TOKEN'
docker run -d --rm \
-e JIRA_VERSION_NAME=v1.0 \
-e JIRA_PROJ=TES \
-e JIRA_AUTH_USER=user \
-e JIRA_AUTH_PASSWORD=password \
ydemetriades/jira-release
docker run -d --rm \
-e JIRA_VERSION_NAME=v1.0 \
-e JIRA_PROJ=TES \
-e JIRA_AUTH_USER=user \
-e JIRA_AUTH_PASSWORD=password \
-e JIRA_URL=http://jira.mydomain.com \
-e JIRA_VERSION_RELEASED=false \
-e JIRA_VERSION_DESCRIPTION=Fixed issue TES-101 \
ydemetriades/jira-release