jira – создание и изменение задач в экземпляре JIRA

Обзор
Параметры
Примечания
Примеры
Статус

Обзор

Создание и изменение задач в экземпляре JIRA.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
assignee -		Устанавливает назначенного исполнителя при создании или переходе на новый этап. Обратите внимание, что не все переходы позволяют это сделать.
comment -		Текст комментария для добавления.
description -		Описание задачи, где это применимо.
fields -		Это структура данных с произвольной формой, которая может содержать произвольные данные. Она передается напрямую в REST API JIRA (возможно, после объединения с другими необходимыми данными, например, при создании). Более подробная информация приведена в примерах, а также в документации REST API JIRA для структуры, необходимой для различных полей.
inwardissue - добавлено в 2.3		Указывает задачу, из которой будет создана ссылка.
issue -		Ключ существующей задачи для обработки.
issuetype -		Тип задачи для создания задачи.
linktype - добавлено в 2.3		Указывает тип ссылки, когда выбран «связь»
operation - / обязательно	Варианты: create comment edit fetch transition link	Операция для выполнения. псевдонимы: команда
outwardissue - добавлено в 2.3		Указывает задачу, с которой будет создана ссылка.
password - / обязательно		Пароль для входа.
project -		Проект для этой операции. Требуется для создания задач.
status -		Желаемый статус; актуально только для операции перехода на новый этап.
summary -		Краткое описание задачи, где это применимо.
timeout - добавлено в 2.3	Значение по умолчанию: 10	Устанавливает таймаут в секундах для запросов к API JIRA.
uri - / обязательно		Базовый URI для экземпляра JIRA.
username - / обязательно		Имя пользователя для входа.
validate_certs boolean добавлено в 2.5	Варианты: no да ←	Требовать действительные сертификаты SSL (установите `false`, если хотите использовать самозаверенные сертификаты)

Примечания

Примечание

В настоящее время это работает только с базовой аутентификацией.

Примеры

# Create a new issue and add a comment to it:
- name: Create an issue
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    project: ANS
    operation: create
    summary: Example Issue
    description: Created using Ansible
    issuetype: Task
  register: issue

- name: Comment on issue
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    issue: '{{ issue.meta.key }}'
    operation: comment
    comment: A comment added by Ansible

# Assign an existing issue using edit
- name: Assign an issue using free-form fields
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    issue: '{{ issue.meta.key}}'
    operation: edit
    assignee: ssmith

# Create an issue with an existing assignee
- name: Create an assigned issue
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    project: ANS
    operation: create
    summary: Assigned issue
    description: Created and assigned using Ansible
    issuetype: Task
    assignee: ssmith

# Edit an issue
- name: Set the labels on an issue using free-form fields
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    issue: '{{ issue.meta.key }}'
    operation: edit
  args:
    fields:
        labels:
          - autocreated
          - ansible

# Retrieve metadata for an issue and use it to create an account
- name: Get an issue
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    project: ANS
    operation: fetch
    issue: ANS-63
  register: issue

- name: Create a unix account for the reporter
  become: true
  user:
    name: '{{ issue.meta.fields.creator.name }}'
    comment: '{{ issue.meta.fields.creator.displayName }}'

# You can get list of valid linktypes at /rest/api/2/issueLinkType
# url of your jira installation.
- name: Create link from HSP-1 to MKY-1
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    operation: link
    linktype: Relates
    inwardissue: HSP-1
    outwardissue: MKY-1

# Transition an issue by target status
- name: Close the issue
  jira:
    uri: '{{ server }}'
    username: '{{ user }}'
    password: '{{ pass }}'
    issue: '{{ issue.meta.key }}'
    operation: transition
    status: Done

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Steve Smith (@tarka)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/jira_module.html