Tagbangers Blog

JIRA のプラグイン開発環境をつくってみる (Mac OSX)

基本的に公式ドキュメントに書いているとおりですが、メモとして。

1. まずはプラグイン開発用の SDK をインストール

Homebrew で簡単!

$ brew tap atlassian/tap
$ brew install atlassian/tap/atlassian-plugin-sdk

2. プロジェクトの作成

1 でインストールした SDK のコマンドをつかってプロジェクトの雛形を作成する。

$ atlas-create-jira-plugin
...
Define value for groupId: :jp.co.tagbangers
Define value for artifactId: : jira-sample-plugin
Define value for version:  1.0.0-SNAPSHOT: :
Define value for package:  jp.co.tagbangers: 

Maven ベースの以下のような雛形でできる。

jira-sample-plugin
    ├── LICENSE
    ├── README
    ├── pom.xml
    └── src
        ├── main
        │   ├── java
        │   │   └── jp
        │   │       └── co
        │   │           └── tagbangers
        │   │               ├── api
        │   │               │   └── MyPluginComponent.java
        │   │               └── impl
        │   │                   └── MyPluginComponentImpl.java
        │   └── resources
        │       ├── META-INF
        │       │   └── spring
        │       │       └── plugin-context.xml
        │       ├── atlassian-plugin.xml
        │       ├── css
        │       │   └── jira-sample-plugin.css
        │       ├── images
        │       │   ├── pluginIcon.png
        │       │   └── pluginLogo.png
        │       ├── jira-sample-plugin.properties
        │       └── js
        │           └── jira-sample-plugin.js
        └── test
            ├── java
            │   ├── it
            │   │   └── jp
            │   │       └── co
            │   │           └── tagbangers
            │   │               └── MyComponentWiredTest.java
            │   └── ut
            │       └── jp
            │           └── co
            │               └── tagbangers
            │                   └── MyComponentUnitTest.java
            └── resources
                └── atlassian-plugin.xml

3. プロジェクトの実行

$ atlas-run

以下のようなログが表示され、開発用の JIRA がローカルで起動する。

[INFO] jira started successfully in 77s at http://localhost:2990/jira
[INFO] Type Ctrl-D to shutdown gracefully
[INFO] Type Ctrl-C to exit

起動したら http://localhost:2990/jira にアクセス!

ちなみに開発用の JIRA は Username: admin / Password: admin でログインできます!

これでプラグイン開発の準備は OK。