Jira를 Mattermost에 연결

• 사용자가 Mattermost에서 Jira 이슈를 첨부하고 생성할 수 있도록 허용: Mattermost에서 사용자가 Jira 이슈를 첨부하고 생성하는 기능을 활성화하거나 비활성화합니다. 활성화하면 Jira 인스턴스에 이 Jira 통합도 설치해야 합니다.
• Jira 구독을 편집할 수 있는 Mattermost 역할: 어떤 Mattermost 사용자가 Jira 티켓에 채널을 구독할 수 있는지 제어하기 위해 Jira 구독을 편집할 수 있는 Mattermost 역할을 지정합니다.
• Jira 구독을 편집할 수 있는 Jira 그룹: (이전 Jira v2.4 이하 배포에만 적용) 쉼표로 구분된 사용자 그룹 이름 목록으로 Jira 구독을 편집할 수 있는 Jira 그룹을 지정합니다. 비워 두면 모든 Jira 사용자가 구독을 만들 수 있습니다. 구독을 편집하는 사용자는 나열된 그룹 중 하나의 구성원이기만 하면 됩니다.
• 기본 구독 보안 수준을 비어 있음으로 설정: 기본 구독 보안 수준을 활성화하거나 비활성화합니다. 활성화하면 구독에는 보안 수준이 필터로 포함된 경우 보안 수준이 할당된 이슈만 포함됩니다.
• Jira 도움말과 함께 표시할 추가 도움말 텍스트: 사용자가 /jira help 슬래시 명령어를 실행할 때 표시할 추가 도움말 텍스트를 정의합니다.
• 이슈 설명 및 댓글 숨기기: 구독 및 웹훅 메시지에서 이슈 설명과 댓글을 표시하거나 숨깁니다.
• 슬래시 명령어 활성화: 사용자가 사용 가능한 /jira 슬래시 명령어를 안내받을 수 있도록 슬래시 명령어 자동 완성을 활성화하거나 비활성화합니다.
• 알림에 구독 이름 표시: 채널에 게시된 알림 메시지에서 구독 이름을 표시하거나 숨깁니다.
• 관리자 API 토큰: 이벤트를 트리거하는 사용자가 Jira에 연결되어 있지 않더라도 댓글 및 이슈 생성 이벤트에 대한 알림을 받고 자동링크를 설정하기 위한 API 토큰을 설정합니다. API 토큰은 관리자 Jira 계정을 사용하여 생성해야 합니다. 그렇지 않으면 사용자가 접근할 수 없는 프로젝트에 대한 알림이 전달되지 않고 자동링크가 작동하지 않습니다.
• 관리자 이메일: 이벤트를 트리거하는 사용자가 Jira에 연결되어 있지 않더라도 댓글 및 이슈 생성 이벤트에 대한 알림을 받고 Jira 플러그인의 자동링크를 설정하기 위한 관리자 이메일을 설정합니다.

2. /jira setup을 실행하여 플러그인 구성 마법사를 시작합니다. 플러그인을 수동으로 설정하려면 아래 단계를 따르세요.

Jira 인스턴스에 Jira 통합 설치#

사용자가 Mattermost 채널 전반에서 Jira 이슈를 생성하고 관리할 수 있도록 하려면 이 Jira 통합을 애플리케이션으로 Jira 인스턴스에 설치해야 합니다.

• Jira 서버 또는 데이터 센터 인스턴스의 경우, Mattermost 시스템 관리자로 Mattermost 채널에서 /jira instance install server 슬래시 명령어를 실행한 다음 채널에 게시된 단계를 따르고 YOUR-JIRA-URL을 Jira URL로 바꿉니다. 이 값은 로그인에 사용하는 Jira 서버 URL과 일치해야 합니다. Mattermost 인스턴스에서 Jira 서버 또는 데이터 센터 인스턴스를 제거하려면 /jira instance uninstall server 슬래시 명령어를 실행합니다.
• Jira 클라우드의 경우, Mattermost 시스템 관리자로 Mattermost 채널에서 /jira instance install cloud-oauth 슬래시 명령어를 실행한 다음 마법사에 따라 설정을 완료합니다. Mattermost에서 Jira 클라우드 인스턴스를 제거하려면 /jira instance uninstall cloud-oauth 슬래시 명령어를 실행합니다.

Jira에서 웹훅 구성#

Mattermost 시스템 관리자와 Jira 시스템 관리자는 다음 단계를 수행하여 Mattermost에 푸시할 모든 가능한 이벤트 트리거(파이어호스)에 대한 단일 웹훅을 구성해야 합니다. Mattermost는 구성된 웹훅을 통해 Jira 서버에서 이벤트 스트림을 수신하고 이벤트를 특정 채널로 라우팅합니다. 채널 구독은 데이터의 파이어호스를 처리하고 구독을 기반으로 채널에 이벤트를 라우팅합니다.

1. Mattermost에서 Mattermost 채널에서 /jira webhook 슬래시 명령어를 실행하여 적절한 웹훅 URL을 가져오고 YOUR-JIRA-URL을 Jira URL로 바꿉니다.
2. Jira에서 Jira 설정 > 시스템 > 웹훅으로 이동합니다. (이전 버전의 Jira에서는 왼쪽 하단 모서리에 있는 기어 아이콘을 선택한 다음 고급 > 웹훅으로 이동합니다.)
3. 웹훅 만들기를 선택합니다.
4. 웹훅의 이름을 입력하고 위에서 Mattermost에서 검색한 Jira 웹훅 URL을 URL로 추가합니다.
5. Mattermost 채널로 전송될 이슈 이벤트를 다음을 모두 선택하여 지정합니다.

• 댓글: 생성, 업데이트, 삭제.
• 이슈: 생성, 업데이트, 삭제.

6. 저장을 선택합니다.

Mattermost에서 채널 구독 관리#

Mattermost 채널 관리자는 Jira 프로젝트, 이벤트 유형, 이슈 유형을 기반으로 채널당 받고 싶은 알림을 구독 규칙으로 설정할 수 있습니다. 이슈의 값을 기반으로 이슈를 필터링할 수도 있습니다.

구독을 수정하려면 사용자는 Mattermost 사용자 설정과 Jira 그룹 설정 모두의 기준을 충족해야 합니다. 채널을 Jira 이벤트에 구독할 수 있다면 규칙도 설정할 수 있습니다. 그러나 Jira 내에서 접근 가능한 프로젝트와 이슈 유형만 볼 수 있습니다. Jira에서 프로젝트를 볼 수 없으면 옵션으로 사용할 수 없습니다.

조직의 인프라가 Mattermost 인스턴스가 Jira 인스턴스에 연결할 수 없도록 설정된 경우 채널 구독을 사용할 수 없습니다. 대신 레거시 웹훅을 사용하여 Jira 웹훅이 특정 채널에 게시할 수 있도록 합니다.

모든 채널에서 /jira subscribe 슬래시 명령어를 실행하여 다음 옵션을 구성합니다.

• 현재 채널로 전송되는 Jira 알림을 구성합니다.
• 영향받는 버전, 에픽 링크, 수정 버전, 레이블, 우선순위 등의 필터를 지정합니다.
• 체크박스, 레이블, 라디오 버튼, 선택 목록(단일 또는 다중 선택)을 포함한 사용자 정의 필드를 지정합니다.
• 생성된 대략적인 JQL 출력을 검토합니다. 이것은 유효한 JQL이 보장되지 않으며 JQL로 변환될 경우 쿼리가 어떻게 보일지에 대한 참조로만 표시됩니다.

/jira subscribe list 슬래시 명령어를 실행하여 Mattermost 인스턴스의 모든 채널과 팀에서 설정된 모든 구독 규칙을 표시합니다.

레거시 Jira 웹훅#

Mattermost 인스턴스가 Jira 인스턴스에 연결할 수 없는 경우 Mattermost 채널을 구독할 수 없습니다. 대신 레거시 웹훅을 사용해야 합니다.

1. 특정 채널의 웹훅 URL을 생성하려면 /jira webhook 슬래시 명령어를 실행하고 출력의 레거시 웹훅 섹션에 있는 URL을 사용합니다.
2. Jira 시스템 관리자로서 Jira 설정 > 시스템 > 웹훅으로 이동합니다. (이전 버전의 Jira에서는 왼쪽 하단 모서리에 있는 기어 아이콘을 선택한 다음 고급 > 웹훅으로 이동합니다.)
3. 웹훅 만들기를 선택하여 새 웹훅을 만듭니다. 웹훅의 이름을 입력하고 Jira 웹훅 URL https://MATTERMOST-SITE-URL/plugins/jira/webhook?secret=MATTERMOST-WEBHOOK-SECRET&team=MATTERMOST-TEAM-URL&channel=MATTERMOST-CHANNEL-URL (Jira 2.1용)을 URL로 추가합니다.

• MATTERMOST-TEAM-URL과 MATTERMOST-CHANNEL-URL을 소문자를 사용하여 Jira 이벤트를 게시할 Mattermost 팀 URL과 채널 URL로 바꿉니다.
• MATTERMOST-SITE-URL을 Mattermost 인스턴스의 사이트 URL로 바꿉니다.
• MATTERMOST-WEBHOOK-SECRET을 System Console > Plugins > Jira로 이동하여 Mattermost에서 생성된 시크릿으로 바꿉니다.

예를 들어, 팀 URL이 contributors, 채널 URL이 town-square, 사이트 URL이 https://community.mattermost.com, 생성된 웹훅 시크릿이 MYSECRET인 경우 최종 웹훅 URL은 https://community.mattermost.com/plugins/jira/webhook?secret=MYSECRET&team=contributors&channel=town-square가 됩니다.

4. (선택 사항) 설명과 사용자 정의 JQL 쿼리를 설정하여 어떤 티켓이 이벤트를 트리거할지 결정합니다. JQL 쿼리에 대한 정보는 Atlassian 도움말 문서를 참조하세요.
5. Mattermost 채널로 메시지를 전송할 이슈 이벤트를 설정한 다음 저장을 선택합니다. 지원되는 이슈 이벤트는 이슈 생성, 이슈 삭제, 이슈 업데이트(담당자가 변경될 때 재오픈 또는 해결 포함)입니다.

기본적으로 레거시 웹훅 통합은 이슈 생성, 해결, 비해결, 재오픈, 할당 이벤트에 대한 알림을 게시합니다. 더 많은 이벤트를 게시하려면 다음 &로 구분되는 추가 파라미터를 사용합니다.

• updated_all=1: 모든 이벤트
• updated_comments=1: 모든 댓글 이벤트
• updated_description=1: 업데이트된 이슈 설명
• updated_labels=1: 업데이트된 이슈 레이블
• updated_priority=1: 업데이트된 이슈 우선순위
• updated_rank=1: 이슈를 더 높거나 낮게 순위 지정
• updated_sprint=1: 이슈를 다른 스프린트에 할당
• updated_status=1: 이슈를 Done 또는 In Progress와 같은 다른 상태로 전환
• updated_summary=1: 이슈 이름 변경

다음은 댓글 이벤트에 대한 게시물을 생성하도록 구성된 웹훅의 예시입니다. https://community.mattermost.com/plugins/jira/webhook?secret=MYSECRET&team=contributors&channel=town-square&updated_comments=1

Jira에서 특정 채널을 가리키도록 이전에 구성된 웹훅은 지원되며 계속 작동합니다.

알림 관리#

Jira 알림은 Jira에서 특정 이벤트가 발생할 때 Mattermost 채널로 전송되는 메시지입니다. Mattermost에서 채널 구독으로 관리하거나 Jira에서 웹훅으로 관리할 수 있습니다. 채널에 표시된 알림 및 메타데이터는 Jira 권한으로 보호되지 않습니다. 채널의 모든 사람이 채널에 게시된 내용을 볼 수 있습니다. 그러나 사용자에게 적절한 권한이 없으면 Jira에서 이슈에 접근하려고 할 때 이슈의 세부 사항을 볼 수 없습니다.

Jira에서 웹훅 이벤트를 수신하고 알림 규칙과 일치하면 채널에 알림을 게시합니다. 구독 일치가 없으면 웹훅 이벤트는 삭제됩니다.

활성화#

팀에게 Jira 계정을 Mattermost에 연결할 수 있다고 알립니다.

Mattermost 시스템 관리자로서 다음 슬래시 명령어를 사용하여 Jira 상호 운용성으로 더 많은 작업을 수행합니다.

• /jira instance alias [URL] [ALIAS-NAME] - 인스턴스에 별칭 할당.
• /jira instance unalias [ALIAS-NAME] - 인스턴스에서 별칭 제거.
• /jira instance list - 설치된 모든 Jira 인스턴스 나열.
• /jira instance v2 - 레거시 "v2" 웹훅 및 구독(인스턴스 ID가 접두사로 붙지 않는)을 처리하도록 Jira 인스턴스 설정.
• /jira stats - 사용 통계 표시.
• /jira webhook [--instance=] - JQL 쿼리를 수신하는 Mattermost 웹훅 표시.
• /jira v2revert - 레거시 V2 jira 통합 데이터 모델로 되돌리기.

사용#

Jira 상호 연결성을 사용하려는 사용자는 Jira 계정을 Mattermost에 연결해야 합니다.

연결되면 Jira 활동에 대한 Jira 봇의 다이렉트 메시지를 Mattermost에서 받게 됩니다.

Jira 계정을 Mattermost에 연결#

1. Mattermost에서 아무 Mattermost 채널에서 /jira connect 슬래시 명령어를 실행하여 Mattermost 계정을 Jira 계정과 연결합니다. 링크를 따라 Jira 인스턴스로 이동하여 허용을 선택합니다.

여러 Jira 인스턴스가 있는 경우 대신 /jira instance connect 슬래시 명령어를 실행하여 특정 Jira 인스턴스에 연결합니다.

2. 연결되면 /jira help 슬래시 명령어를 실행하여 사용 가능한 기능을 확인합니다.
3. Mattermost에서 Jira 계정 연결을 끊으려면 아무 Mattermost 채널에서 /jira disconnect 슬래시 명령어를 실행합니다.

시작하기#

시작하는 데 사용할 수 있는 일반적인 슬래시 명령어는 다음과 같습니다.

• /jira info - 현재 사용자 및 Jira 통합 정보 표시
• /jira connect [jiraURL] - Mattermost 계정을 Jira 계정에 연결
• /jira disconnect [jiraURL] - Mattermost 계정과 Jira 계정 연결 해제
• /jira issue assign [issue-key] [assignee] - Jira 이슈의 담당자 변경
• /jira issue create [text] - 설명 필드에 'text'가 삽입된 새 이슈 생성
• /jira issue transition [issue-key] [state] - Jira 이슈의 상태 변경
• /jira issue unassign [issue-key] - Jira 이슈 담당자 제거
• /jira issue view [issue-key] - 특정 Jira 이슈의 세부 정보 보기
• /jira instance settings - 사용자 설정 보기
• /jira instance settings [setting] [value] - 사용자 설정 업데이트. [setting]은 notifications이고 [value]는 on 또는 off가 될 수 있습니다

Jira 이슈 만들기#

/jira issue create 슬래시 명령어를 사용하여 Mattermost를 떠나지 않고 Jira 이슈를 만듭니다. /jira issue create This is my issue's summary를 실행하여 이슈의 요약을 미리 채울 수 있습니다. 이슈 세부 정보를 입력하라는 메시지가 표시됩니다.

Jira 이슈 전환#

/jira transition <issue-key> <state> 슬래시 명령어를 사용하여 Mattermost를 떠나지 않고 이슈를 전환할 수 있습니다. 상태와 이슈 전환은 Jira 프로젝트 워크플로 구성을 기반으로 합니다. 예를 들어, /jira transition EXT-20 done은 이슈 키 EXT-20을 done 상태로 전환합니다. 부분 일치가 지원됩니다. 예를 들어, /jira transition EXT-20 in 슬래시 명령어를 실행하면 이슈가 in progress 상태로 전환됩니다. 그러나 Jira 인스턴스에 in review와 in progress 상태가 모두 포함된 경우 Jira 통합 봇이 원하는 상태를 명확히 하라는 메시지를 표시합니다.

Jira 이슈 할당#

/jira assign 명령어를 사용하여 Mattermost를 떠나지 않고 다른 Jira 사용자에게 이슈를 할당합니다. 사용자 이름, 이름, 성에 대한 부분 일치가 지원됩니다. 예를 들어, /jira assign EXT-20 john 슬래시 명령어를 실행하면 이슈 EXT-20이 John에게 전환됩니다.

업그레이드#

새 버전이 출시될 때 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리즈, 이전 릴리즈 및 호환성 고려 사항은 릴리즈 페이지를 방문하세요.

자주 묻는 질문#

Jira 상호 운용성을 어떻게 비활성화합니까?#

언제든지 Mattermost에서 System Console > Plugins > Jira로 이동하여 Jira 통합을 비활성화할 수 있습니다. 비활성화되면 Jira에서 들어오는 웹훅 요청이 무시되고, 사용자는 Mattermost에서 Jira 이슈를 만들 수 없습니다.

Jira 통합이 Mattermost에 메시지를 게시하지 않는 이유는 무엇입니까?#

다음 문제 해결 단계를 시도해 보세요.

1. Mattermost 사이트 URL이 구성되어 있는지 확인하고, Jira에서 만든 웹훅이 이 URL을 가리키는지 확인합니다. URL이 올바른지 확인하려면 /jira webhook 슬래시 명령어를 실행한 다음 출력을 복사하여 Jira의 웹훅 설정 페이지에 붙여넣습니다.
2. Jira 웹훅 설정에서 JQL 쿼리를 지정했다면 JQL을 Jira 이슈 검색에 붙여넣고 결과를 반환하는지 확인합니다. 그렇지 않으면 쿼리가 잘못된 것일 수 있습니다. 도움은 Atlassian 문서를 참조하세요. 웹훅 설정 시 JQL 쿼리가 필요하지 않습니다.

레거시 웹훅을 사용하는 경우 다음을 확인합니다.

• Jira 웹훅 URL에서 지정한 팀 URL과 채널 URL이 채널 방문 시 브라우저에 표시되는 경로와 일치하는지 확인합니다.
• 레거시 웹훅 문서에 설명된 이벤트만 지원됩니다.
• curl 명령어를 사용하여 웹훅 URL에 POST 요청을 합니다. curl 명령어가 200 OK 응답으로 완료되면 통합이 올바르게 구성된 것입니다. 예를 들어 다음 명령어를 실행할 수 있습니다.

curl -X POST -v "https:///plugins/jira/webhook?secret=&team=&channel=&user_id=admin&user_key=admin" --data '{"event":"some_jira_event"}'

Jira 통합을 구성할 때 , , , 을 설정값으로 바꿉니다. curl 명령어는 Mattermost 채널에 메시지를 게시하지 않습니다.

관리자가 Mattermost 메시지를 Jira 이슈에 생성하거나 첨부할 수 있는 사람을 제한할 수 있습니까?#

예, Mattermost 시스템 관리자는 System Console > Plugins > Jira로 이동하여 사용자가 Mattermost에서 Jira 이슈를 첨부하고 생성할 수 있도록 허용 옵션을 비활성화하여 이 기능을 비활성화할 수 있습니다.

Mattermost는 사용자가 접근할 수 있는 Jira 이슈를 어떻게 알 수 있습니까?#

Mattermost는 채널에 정적 메시지만 표시하며, 채널 뷰어에게 Jira 권한을 적용하지 않습니다.

채널의 모든 메시지는 해당 채널의 모든 사용자가 볼 수 있습니다. Jira 이슈에 대한 구독은 예를 들어 공개 채널에서 민감한 Jira 이슈를 의도치 않게 노출하지 않도록 주의하여 이루어져야 합니다. 노출은 채널에 게시된 정보로 제한됩니다. 이슈를 전환하거나 재할당하려면 사용자가 Jira에서 적절한 권한을 가져야 합니다.

모든 사용자가 Jira로 인증해야 하는 이유는 무엇입니까?#

Jira 인증을 통해 JiraBot은 각 Mattermost/Jira 사용자가 이슈에 언급되거나, 이슈에 댓글을 달거나, 이슈가 할당될 때마다 개인 알림을 제공할 수 있습니다. 또한 통합은 인증 정보를 사용하여 사용자를 대신하여 작업을 수행합니다. 검색, 보기, 생성, 할당 및 이슈 전환과 같은 작업은 모두 Jira에서 사용자에게 부여된 권한을 준수합니다.

사용자는 Jira 인증 과정 중에 브라우저에서 서드파티 쿠키를 일시적으로 활성화해야 합니다.

오류 메시지 '/(name)' not found는 무슨 의미입니까?#

Mattermost에서 '/(name)' not found 오류가 표시되면 Jira 통합을 비활성화하고, ExecuteCommand와 같은 플러그인 및 상태 확인 실패를 참조하는 메시지를 찾아 로그 파일을 확인합니다. 그리고 Mattermost 시스템 로그에 더 자세한 오류 이벤트를 기록하기 위해 디버그 로깅 활성화를 고려합니다. 그런 다음 Jira 상호 운용성을 다시 활성화하고 단서를 찾아 로그 파일을 검토합니다.

디버그 로깅은 로그 파일이 상당히 커질 수 있으며 서버 성능에 악영향을 줄 수 있습니다. 서버 로그를 주시하거나 개발 환경에서만 일시적으로 활성화하고 프로덕션 환경에서는 활성화하지 마세요.

웹훅 오류가 발생하는 이유는 무엇입니까?#

WebHooks can only use standard http and https ports (80 or 443) 오류가 표시되면 비표준 포트를 사용하고 있다는 것을 나타냅니다. Jira는 웹훅이 표준 포트 80 및 443에만 연결할 수 있도록 허용합니다. Jira가 포트 443을 통해 통신할 수 있도록 Jira와 Mattermost 인스턴스 사이에 프록시를 설정해야 합니다.

Jira 웹훅에 대한 자격 증명 교체는 어떻게 처리합니까?#

System Console > Plugins > Jira로 이동하여 새 시크릿을 생성합니다. Jira 웹훅 구성에 새 웹훅 URL을 붙여넣습니다.

사용자 정의#

이 통합에는 서버와 웹 앱 부분이 모두 포함됩니다. Mattermost 기능 개발, 사용자 정의 및 확장에 대한 정보는 Mattermost 개발자 워크플로와 Mattermost 개발자 환경 설정을 방문하세요.

도움 받기#

Mattermost 구독 고객은 Mattermost 지원 케이스를 열 수 있습니다. 커뮤니티 배포에서는 Mattermost Jira 플러그인 리포지터리에서 GitHub 이슈를 열어 버그를 보고하거나, Mattermost 피어 투 피어 문제 해결 포럼을 방문하여 글로벌 Mattermost 커뮤니티의 도움을 받을 수 있습니다.

질문, 피드백 및 지원을 위해 Mattermost 커뮤니티 서버의 공개 통합 및 앱 채널에 참여하세요.

curl -X POST -v "https:///plugins/jira/webhook?secret=&team=&channel=&user_id=admin&user_key=admin" --data '{"event":"some_jira_event"}'