Jira Release

Description:

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.

Runtime & Tags

ydemetriades/jira-release is available both for Linux and Windows.

Linux

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

Windows

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

Parameters

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

Notes

1. Enable Jira Api from Administration Settings

2. User JIRA_AUTH_USER must be an Administrator for JIRA_PROJ project

Examples

CLI Examples

jira-release.py -v v1.0.0 -p 10000 -u [email protected] --password 'YOUR_API_TOKEN'

Docker Examples

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

Maintainers

Yiannis Demetriades