지라 플러그인 atlassian sdk plugin 설치 및 개발

공식문서 - sdk 설치 방법 참고

https://developer.atlassian.com/server/framework/atlassian-sdk/downloads/
https://developer.atlassian.com/server/framework/atlassian-sdk/create-a-helloworld-plugin-project/

순서

1. sdk 설치 및 프로젝트 생성
2. 클래스 작성
3. atlassian-plugin.xml에 클래스 등록:
   (ex.servlet-filter 항목을 추가)
4. 빌드 - atlas-mvn package 명령어로 플러그인 패키징.
5. JAR 파일 설치 - target 디렉토리에서 빌드된 플러그인 JAR 파일을 가져와서 Jira 관리자 콘솔에서 설치.

사전작업

아틀라시안 sdk은 자바8 사용해야함

• 애플칩셋 m2면 openjdk 설치 어려움

zulu설치

brew install --cask zulu@8

자바 8 위치 확인 및 버전확인

/usr/libexec/java_home -v 1.8
java -version

아틀라시안 sdk 설치

(https://marketplace.atlassian.com/apps/1210951/atlassian-plugin-sdk-mac-os-x?hosting=server&tab=overview)
경로가 오류나서 그냥 brew로 설치
brew tap atlassian/tap
brew install atlassian/tap/atlassian-plugin-sdk827
atlas-version
9.1.1.버전 설치했다가 오류나서 8.2.7버전으로 다시 설치함. (8.2.7버전만 오류안남)

*삭제할땐
brew uninstall atlassian/tap/atlassian-plugin-sdk

지라플러그인 프로젝트 생성

workspace 폴더에서 터미널명령어
atlas-create-jira-plugin

옵션 명령

Confirm properties configuration:
groupId: 입력
artifactId: 입력
version: 1.0.0-SNAPSHOT
package: 엔터
use OSGi Java Config: N
 Y: : Y

N으로 하시면 빌드성공해도 프로젝트 생성안됨.

프로젝트 생성되면 인텔리제이에서 프로젝트 오픈가능함.
다운로드 받는데 되게 오래걸린다.

인텔리제이 build maven 설정

maven home path 경로 확인 및 설정

/opt/homebrew/Cellar/atlassian-plugin-sdk/9.1.1/libexec/apache-maven-3.9.8/ 경로로 설정

user settrings file도 오버라이드 해줘야 싱크됨.

전부 다운로드 받고 나면 server start되고 접속가능한 경로를 던져줌

개발이 끝나면
atlas-mvn package 으로 jar 파일 생성. target 폴더에 생성되는 jar로 플러그인 설치가능.

---

필터 개발

서블릿 필터 관련 https://developer.atlassian.com/server/jira/platform/servlet-filter/ 페이지 참고

location 속성값

• after-encoding - 애플리케이션의 필터 체인의 맨 위에 위치하지만 요청의 무결성을 보장하는 모든 필터 뒤에 위치합니다.
• before-login - 요청에 포함된 모든 인증 정보를 사용하여 사용자를 로그인시키는 필터 이전입니다.
• before-decoration - 일반적으로 Sitemesh를 사용하여 응답을 장식하는 필터 앞부분입니다.
• before-dispatch - 필터 체인의 끝, 기본적으로 요청을 처리하는 모든 서블릿이나 필터 앞.