2012年9月9日日曜日

Jenkinsのプラグインを開発するための手順(mavenのインストールからサンプルの実行まで)

■環境
Windows7
Java7

■mavenのインストール
http://www.apache.org/dyn/closer.cgi?path=/maven/binaries/apache-maven-3.0.4-bin.zip
ダウンロードしたzipファイルを解凍し解凍してできたファイルの名称を「maven」に変更する
名称変更したフォルダをC:\直下に配置する
以下のように環境変数を追加します
MAVEN_HOME:C:\maven
PATH:MAVEN_HOME\bin
JAVA_HOMEも必要になるので、JAVA_HOMEも設定します
Javaがまだインストールできていない場合にはインストールしましょう
コマンドプロンプトを開いて「mvn」と入力しエラー文らしきものが出力されることを確認

C:\Users\ユーザ名配下に「.m2」というフォルダがあるので配下にsettings.xmlを作成し以下を記載

<settings>
  <pluginGroups>
    <pluginGroup>org.jenkins-ci.tools</pluginGroup>
  </pluginGroups>

  <profiles>
    <!-- Give access to Jenkins plugins -->
    <profile>
      <id>jenkins</id>
      <activation>
        <activeByDefault>true</activeByDefault> <!-- change this to false, if you don't like to have it on per default -->
      </activation>
      <repositories>
        <repository>
          <id>repo.jenkins-ci.org</id>
          <url>http://repo.jenkins-ci.org/public/</url>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>repo.jenkins-ci.org</id>
          <url>http://repo.jenkins-ci.org/public/</url>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
</settings>

■mavenプロジェクトの作成
事前に作業用のフォルダを作成しておくとよいでしょう
コマンドプロンプトを開いて作業用フォルダに移動します
mvn -cpu hpi:create
いろいろとダウンロードされるのを確認します
途中でmavenプロジェクトの名前とグループ名を入力するようになりますので、適当に入力します
ここではグループ名を「kaka」プロジェクト名を「plugin」とします
cd plugin
mvn package
成功すると「target」「src」「pom.xml」の3つのファイルが作成されます

■サンプルプラグインの作成
mvn install
成功するとtargetフォルダ配下にplugin.hpiというファイルができているのでそれがプラグインになります

■サンプルプログラムの実行
set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,address=8000,suspend=n
mvn hpi:run
ブラウザからローカルホストの8000へアクセスすれば自作プラグインがインストールされたJenkinsがJetty越しに起動します
Jettyは一度起動したら自動で変更を認識してくれるので、上記を実行したターミナルはそのままでよいでしょう

8000番にアクセスした際に

Debugger failed to attach: handshake failed - received >GET / HTTP/1.1< - expected >JDWP-Handshake<

が出た場合には8000ではなく8080にアクセスしてみてください

ブラウザでデバッグモードのJenkinsにアクセスできたらJenkinsの管理からプラグインの管理にを見てみると「plugin」というのが表示されていればインストール完了です
今回のサンプルプラグインは特に何も動作しないです

以上で簡単な流れの説明は終了です
次回は統合開発環境eclipseを使ってサンプルプラグインを作成してみます

0 件のコメント:

コメントを投稿