Monoプラットフォームでの「正しい」開発プロセスの構築

サイクルの基本的な例は、.NETプラットフォームでの「正しい」開発プロセスの構築に基づいた、Jenkins CIを使用したプリミティブASP.NET（Mono）アプリケーションの開発です 。



提示された例は、次のように、幅広い視聴者にとって興味深いものです 他のプラットフォームの開発に簡単に適合させることができます。

エントリー

この記事は、元の記事のためでなければ書かれたことはなかったでしょう。元の記事は、かつては開発プロセスに対する私の理解を形成する上で重要な役割を果たしました。 そして、彼らが言うように、「私はこの機会を利用したい」。 Eugeneの素晴らしい記事に感謝したいと思います。これは初心者にとって素晴らしいスタートです！ どうもありがとう！



この記事は、概して、根本的に新しいものではありません。 同じC＃プロジェクト、NUnitでの同じテスト、NAntでの同じ自動化。 しかし、微妙な違いがあります。 第一に、Jenkins CIはCIサーバーとして使用され、第二に、アセンブリ中のさまざまなプロジェクトメトリックの分析と表示にかなりの注意が払われます。



この記事では、作業環境をセットアップし、ソースコードの変更を自動的に追跡し、プロジェクトをコンパイルし、ユニットテストと機能テストを実行し、コード行数、重複の有無、技術的負債のソースコード（TODO、FIXMEなど）でプロジェクトの中心はNAntスクリプトになります。NAntスクリプトは、材料が考慮されるにつれて大きくなります。 プロジェクトはどの段階でも機能し、完了できます。これは、一度にプロジェクト全体を作成できない場合や、提示されたすべての機能を必要としない場合に非常に便利です（率直に言って、一部の問題では冗長です）。

ワークスペース

ワークスペースを構成するには、次のものが必要です。

OS	GNU / Linux （ openSUSE 12.1、 LXDE ）	継続的インテグレーションサーバーが展開されるオペレーティングシステム。
CIS	ジェンキンスCI 1.450	継続的統合サーバー。
Vcs	Subversion 1.6.17	集中型バージョン管理システム（Subversionの代わりに、他のVCSを使用できます）
CLR	モノラル 2.6.10	開発が実行されるプラットフォーム。
テスト中	NUnit 2.4.8	テストを作成および実行するためのツール（ユニット、非ユニット-誰がテストを作成するかに既に依存しています）。
	セレンRC 2.18.0	機能テストを実行するためのツール。
静的コード分析	ジェンダーム2.10.0.0	静的コードアナライザー。
	クローン分析装置 2005-05-30	重複コードを見つけるためのユーティリティ。
	StyleCopCmd 0.2.1	静的コードアナライザー。
その他のツール	NAnt 0.90	プロジェクトの自動アセンブリ用ユーティリティ。
	Firefox 7.0.1	機能テストを作成して実行するWebブラウザー（テストは他のブラウザーを使用して実行することもできます）
	Selenium IDE 1.6.0	機能テストを作成するためのIDE。

作業環境を構成するには、次の手順を実行する必要があります。

1. DVDイメージをダウンロードし 、OSをインストールします（デスクトップ環境を選択するときは、LXDEを指定します）。 厳密に言えば、別のデスクトップ環境を使用することも、まったく使用しないこともできます。 この例ではLXDEを使用して、セットアッププロセスをより簡単にします。

2.リポジトリを設定します。

sudo zypper ar http://download.opensuse.org/repositories/Mono/openSUSE_11.4/ Mono sudo zypper ar http://pkg.jenkins-ci.org/opensuse/ Jenkins
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

3.必要なパッケージをインストールします。

 sudo zypper in jenkins mono-complete mono-nunit mono-tools nant subversion-server apache2 http://www.dwheeler.com/sloccount/sloccount-2.26-1.i386.rpm
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

4. rpmパッケージとして提供されていない必要なユーティリティ（StyleCopCmdおよびCloneAnalyzer）をダウンロードしてインストールします。 いくつかのニュアンスがあります。

まず、Linuxですぐに使用できるバイナリを使用することはできません。 アプリケーションは全体として機能しますが、ReportBuilder.csファイルの460行目にハードパスで設定されたパス区切り記号があるため、レポートファイルは予期した場所にはありません。

  private static string GetViolationsFile(string outputXmlFile) { var offp = Path.GetFullPath(outputXmlFile); var f = string.Format( CultureInfo.CurrentCulture, "{0}\\{1}.violations.xml", // String No 460, wrong separator here! Path.GetFullPath(Path.GetDirectoryName(offp)), Path.GetFileNameWithoutExtension(outputXmlFile)); return f; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

修正されたバージョンと構成ファイルは、 ここからダウンロードできます 。

第二に、DRYプラグインはCloneAnalyzeユーティリティのレポートを認識しないため、CloneAnalyzeレポートを明確なJenkins'yのいずれかに変換する必要があります（私はCPDを選択しました）。 レポートの例、およびソースコードを使用したホイップアップコンバーターは、 ここから入手できます 。

追加のユーティリティ用のディレクトリを作成します。

 sudo mkdir -p /var/lib/jenkins/tools/{StyleCop,CloneAnalyzer,SeleniumRC} # 1.   SlyleCop    StyleCopCmd. # ... # 2.  CloneAnalyzer cd /var/lib/jenkins/tools/CloneAnalyzer sudo wget http://sourceforge.net/projects/cloneanalyzer/files/latest/download?source=files sudo unzip CloneAnalyzerPluginInstall_20050530.zip sudo mv eclipse/plugins/CloneAnalyzer . rm -rf eclipse # 3.     CloneAnalyzer   . # ... # 4.  Selenium Remoute Control. cd /var/lib/jenkins/tools/SeleniumRC sudo wget http://selenium.googlecode.com/files/selenium-server-standalone-2.19.0.jar
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

5. Jenkinsのプラグインをインストールします（Jenkins-> Manage Jenkins-> Manage Plugins-> Available）：

必須
転覆	svnリポジトリからソースコードを取得する操作を自動化できます（デフォルトでインストールされます）
ユニット	NUnitの結果に関するレポートを作成できます。
Nnt	Jntkinsプロジェクトのアセンブリ目標としてNAntスクリプトを設定できます。
静的コード分析	DRYプラグインに必要です。
タスクスキャナー	コードで見つかったタグに関するレポートを作成できます（TODOなど）。
SLOCCount	ユーティリティSLOCCountの結果に関するレポートを作成できます（控えめなコードメトリックを表示します）。
Doclinks	プロジェクトのメインページに、プロジェクトのドキュメントへのリンクを配置できます。
違反	さまざまなユーティリティの結果に関するレポートを作成できます。 この例は、GendarmeとStyleCopCmdの結果を表示するために使用されます。
ドライ	見つかった重複コードに関するレポートを作成できます。
セレニウム	Seleniumレポートへのリンクを投稿します。
警告	コンパイラの警告を表示してレポートを作成できます。
推奨：
Jobconfighistory	プロジェクト設定への変更の履歴を保持します。
バックアップ	サーバーバックアップの作成プロセスを簡素化できます。
オプションで：
緑色のボール	青いボールを緑に置き換えます。
次のビルド番号	任意のアセンブリ番号を設定できます。
サイドバーリンク	サーバーのメインページとプロジェクトのページにリンクを作成できます。

デモプロジェクトの説明

残念ながら、私は単純なものを思い付くことができませんでしたが、同時に主題領域のロジックで過負荷にならず、プロジェクトのテストに便利です。 提示されたプロジェクトは単純です-2つの入力フィールド、2つのボタン（「合計」および「連結」）および結果。
アプリケーションを作成するために、3つのプロジェクトを含むソリューションが作成されました。

• ExampleCore-すべてのアプリケーションロジックが集中している（これを1秒間、2つのメソッドまで）！
• ExampleGUI-アプリケーションインターフェイス（1つですが、このより重要なaspxページから）。
• ExampleUTest-テスト付きのプロジェクト（NUnit）。
• ExampleFTest-ソリューションに含まれていない機能テスト（Selenium）のあるExampleFTestフォルダーもルートディレクトリにあります。

アセンブリスクリプトを作成し、ツールを構成する

まず、Jenkinsプロジェクトを作成する必要があります。これは、http：// localhost：8080（Jenkinsがローカルコンピューターにインストールされている場合）で利用可能なWebインターフェイスから必要です。NewJobリンクをクリックし、プロジェクトタイプBuild a free-スタイルソフトウェアプロジェクト、プロジェクトの名前を入力して作成します。 プロジェクトが作成されます。

前述のように、アセンブリプロジェクトのコアはNAntスクリプトになります。そのため、スクリプトを呼び出すビルドセクションで目標を作成する必要があります。 一般に、長所と短所があるプロジェクト組織へのアプローチがいくつかあります。 この例では、すべてのアクションが1つのNAntスクリプトに配置され、Jenkinsプロジェクトの単一のコマンドによって呼び出されます。 これは、Jenkinsなしでアセンブリを実行するのが非常に簡単で、NAntスクリプトを実行するだけであるという点で便利です。 ただし、アセンブリプロセスを変更することは必ずしも便利ではありません（最初にNAntスクリプトを変更してからコミットする必要があり、その後でのみビルドプロセスが更新されます）。 このアプローチとは対照的に、Jenkinsプロジェクトでbashスクリプトを実行するための多くの目標を作成し、それらにすべてのアセンブリロジックを配置できます。 この場合、ビルドプロセスを編集すると便利ですが、Jenkins以外ではビルドできません。

次の形式のNant-scriptの作成を始めましょう。

 <?xml version="1.0"?> <project name="Example" default="cis" basedir="."> <!-- Property --> <!--Targets --> <target name="cis" description="Execute all targets in CIS."> <call target="clean" /> <call target="build" /> <call target="documentation" /> <call target="utest" /> <call target="gendarme" /> <call target="stylecop" /> <call target="sloccount" /> <call target="cloneanalyze" /> <call target="ftest" /> </target> </project>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

つまり 最初のプロパティ（Property）が宣言され、次にターゲット（Target）が宣言され、最終的に主な目標が宣言され（その名前はスクリプトのデフォルトプロパティで示されます）、それが以前に宣言されたものを呼び出します。 説明した方法が唯一ではなく、他の人を呼び出す目標を作成する代わりに、他の人へのいくつかの目標の依存関係を登録するだけで、目標が自動的に呼び出されます。

次に、cisターゲットが呼び出すすべての目標が実装されます。 どの段階でもスクリプトを実行できますが、そのためには、未達成の目標とメインの目標（cis）の未使用のプロパティについてコメントする必要があります。



簡単にするために、コードをさらに削減するプロパティを宣言します。

Jenkins環境変数：

  <property name="work.d" value="${environment::get-variable('WORKSPACE')}" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ツールが収集されるディレクトリ：

  <property name="tools.d" value="/var/lib/jenkins/tools" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

名前から明らかなように、さまざまなディレクトリのエイリアス：

  <property name="bin.d" value="${build.conf}/bin"/> <property name="deploy.d" value="/home/vm/public_html" /> <property name="test.res.d" value="test-results" /> <property name="report.d" value="${work.d}/reports" /> <property name="doc.d" value="${work.d}/doc" /> <property name="core.d" value="${work.d}/ExampleCore" /> <property name="gui.d" value="${work.d}/ExampleGUI" /> <property name="utest.d" value="${work.d}/ExampleUTest" /> <property name="ftest.d" value="${work.d}/ExampleFTest" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

バイナリファイルとStyleCopCmd設定ファイルのエイリアス：

  <property name="style.exe" value="${tools.d}/StyleCop/Net.SF.StyleCopCmd.Console.exe" /> <property name="style.conf" value="${tools.d}/StyleCop/Settings.StyleCop" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

実行可能ファイル、コンバーター、および構成ファイルCloneAnalyzerのエイリアス：

  <property name="clone.jar" value="${tools.d}/CloneAnalyzer/CloneAnalyzer.jar" /> <property name="clone.conf" value="${tools.d}/CloneAnalyzer/comments.conf" /> <property name="clone.conv" value="${tools.d}/CloneAnalyzer/ca2cpd.exe" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

実行可能ファイル、ラッパースクリプト、およびテストスイートとSeleniumRCのアプリケーションがデプロイされているホスト名を含むファイルのエイリアス：

  <property name="selen.jar" value="${tools.d}/SeleniumRC/selenium-server-standalone-2.18.0.jar" /> <property name="selen.sh" value="${tools.d}/SeleniumRC/selenium.sh" /> <property name="selen.host" value="http://192.168.56.210" /> <property name="selen.suite" value="${ftest.d}/Main.html" />
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

目標の作成を始めましょう。

1.最初に、古いアーティファクトからアセンブリディレクトリを削除し、必要なディレクトリを作成するという目標を作成します。

  <target name="clean" description="Remove binary files, recreate report directory."> <echo message="Target starded at: ${datetime::now()}."/> <delete failonerror="false" dir= "${core.d}/${bin.d}"/> <delete failonerror="false" file="${core.d}/ExampleCore.pidb"/> <delete failonerror="false" dir= "${utest.d}/${bin.d}"/> <delete failonerror="false" dir= "${utest.d}/${test.res.d}"/> <delete failonerror="false" file="${utest.d}/ExampleUTest.pidb"/> <delete failonerror="false" dir= "${gui.d}/${bin.d}"/> <delete failonerror="false" dir= "${gui.d}/${test.res.d}"/> <delete failonerror="false" file="${gui.d}/ExampleGUI.pidb"/> <delete failonerror="false" dir= "${report.d}"/> <delete failonerror="false" dir= "${doc.d}"/> <delete failonerror="false" file="${work.d}/stylecop.report"/> <delete failonerror="false" file="${work.d}/stylecop.violations.xml"/> <mkdir dir="${report.d}"/> <mkdir dir="${report.d}/gendarme"/> <mkdir dir="${report.d}/sloccount"/> <mkdir dir="${report.d}/cloneanalyzer"/> <mkdir dir="${report.d}/selenium"/> <mkdir dir="${doc.d}/xml"/> <mkdir dir="${doc.d}/html"/> <echo message="Target completed at: ${datetime::now()}."/> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

2. 2番目のステップは、リポジトリから更新を取得することです。 この操作はJenkinsによって実行されるため、この例ではNAntスクリプトには含まれていませんが、必要な場合はその場所がここにあります。

Subversionリポジトリを作成して構成します。

 su a2enmod dav a2enmod dav_svn a2enmod mod_authz_svn cd /srv/www/htdocs wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/menucheckout.ico wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/svnindex.css wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/svnindex.xsl mkdir -p /srv/svn/{repos,user_access,html} cat > /etc/apache2/conf.d/subversion.conf << EOF <IfModule mod_alias.c> Alias /repos "/srv/svn/html" </IfModule> <Directory /srv/svn/html> Options +Indexes +Multiviews -FollowSymLinks IndexOptions FancyIndexing \ ScanHTMLTitles \ NameWidth=* \ DescriptionWidth=* \ SuppressLastModified \ SuppressSize order allow,deny allow from all </Directory> <Location /repos/Example> DAV svn SVNListParentPath on SVNPath /srv/svn/repos/Example SVNIndexXSLT "/svnindex.xsl" AuthType Basic AuthName "Subversion" AuthUserFile /srv/svn/user_access/passwdfile AuthGroupFile /srv/svn/user_access/groupfile AuthzSVNAccessFile /srv/svn/user_access/accessfile Require valid-user </Location> EOF cd /srv/svn/repos svnadmin create --fs-type fsfs Example mkdir -p /srv/svn/repos/Example/dav chown -R wwwrun:www Example/{dav,db,locks} touch /srv/svn/user_access/passwdfile chown root:www /srv/svn/user_access/passwdfile chmod 640 /srv/svn/user_access/passwdfile touch /srv/svn/user_access/groupfile cat > /srv/svn/user_access/groupfile << EOF Example_commiters: Admin User Example_readers: Admin User CIS touch /srv/svn/user_access/accessfile cat > /srv/svn/user_access/accessfile << EOF [groups] admin = Admin user = User cis = CIS [/] * = @admin = rw [Example:/] @user = rw @cis = r /sbin/service apache2 restart exit
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

その後、Subversionプラグインを構成します。



また、アセンブリの頻度も設定します（更新がある場合にアセンブルするために、その存在が平日の1時間ごとにチェックされます）。



3. xmlサブプロジェクトExampleCoreおよびExampleGUIのドキュメントの生成でコンパイルする目標を作成します。

  <target name="build" description="Compiles the source code."> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Building ExampleCore."/> <csc codepage="utf8" target="library" output="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" doc="${doc.d}/xml/ExampleCore.xml"> <sources> <include name="${core.d}/**.cs"/> </sources> </csc> <copy file="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" tofile="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <copy file="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" tofile="${utest.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <echo message="Building ExampleGUI."/> <csc codepage="utf8" target="library" output="${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll" doc="${doc.d}/xml/ExampleGUI.xml"> <sources> <include name="${gui.d}/**.cs" /> </sources> <references> <include name="System.Web.dll" /> <include name="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> </references> </csc> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

コンパイラメッセージがJenkinsによって処理されるように、警告プラグインを構成します。



将来的には、コンパイラ警告に関するこれらのレポートを受け取ることができるようになります：



4. html形式のドキュメントを生成します。

  <target name="documentation" description="Generation documentation."> <echo message="Target starded at: ${datetime::now()}."/> <exec program="monodocer" commandline=" -pretty -i:${doc.d}/xml/ExampleCore.xml -assembly:${core.d}/${bin.d}/${build.conf}/ExampleCore.dll -path:${doc.d}/xml"/> <exec program="monodocer" commandline=" -pretty -i:${doc.d}/xml/ExampleGUI.xml -assembly:${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll -path:${doc.d}/xml"/> <exec program="mdoc" commandline="export-html ${doc.d}/xml -o=${doc.d}/html"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

DocLinksプラグインをセットアップします。 その結果、ドキュメントへのリンクがプロジェクトのメインページに作成されます。



5.単体テストを収集して実行します。

  <target name="utest" description="Test the source code."> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Building ExampleUTest."/> <csc codepage="utf8" target="library" output="${utest.d}/${bin.d}/${build.conf}/ExampleUTest.dll"> <sources> <include name="${utest.d}/**.cs" /> </sources> <references> <include name="System.Web.dll" /> <include name="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <include name="nunit.core.dll" /> <include name="nunit.framework.dll" /> </references> </csc> <echo message="Launch NUnit." /> <nunit2 haltonfailure="false"> <formatter type="Xml" usefile="true" extension=".xml" outputdir="${utest.d}/${test.res.d}" /> <formatter type="Plain" usefile="false" /> <test assemblyname="${utest.d}/${bin.d}/${build.conf}/ExampleUTest.dll" /> </nunit2> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

NUnitプラグインをセットアップします。



NUnitプラグインレポートは次のようになります。



6. Gendarmeを使用して静的コード分析を実行します。

  <target name="gendarme"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Check code by Gendarme."/> <exec program="gendarme" failonerror="false" commandline=" --config GendarmeRules.xml ${core.d}/${bin.d}/${build.conf}/ExampleCore.dll --xml ${report.d}/gendarme/ExampleCore.gendarme.xml --severity medium+ --confidence total"/> <exec program="gendarme" failonerror="false" commandline=" --config GendarmeRules.xml ${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll --xml ${report.d}/gendarme/ExampleGUI.gendarme.xml --severity medium+ --confidence total"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

...およびStyleCopCmd：

  <target name="stylecop"> <echo message="Target starded at: ${datetime::now()}."/> <exec program="mono" commandline=" ${style.exe} -r -sc ${style.conf} -d ${work.d} -of ${work.d}/stylecop/stylecop.report"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

StyleCopCmdによって引き起こされるエラーを取り除くには：

 While saving registry data at /etc/mono/2.0/../registry/last-btime: System.UnauthorizedAccessException: Access to the path "/etc/mono/registry/last-btime" is denied. at System.IO.FileStream..ctor (System.String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, Boolean anonymous, FileOptions options) [0x00000] in <filename unknown>:0 at System.IO.FileStream..ctor (System.String path, FileMode mode, FileAccess access, FileShare share) [0x00000] in <filename unknown>:0 at (wrapper remoting-invoke-with-check) System.IO.FileStream:.ctor (string,System.IO.FileMode,System.IO.FileAccess,System.IO.FileShare) at System.IO.StreamWriter..ctor (System.String path, Boolean append, System.Text.Encoding encoding, Int32 bufferSize) [0x00000] in <filename unknown>:0 at System.IO.StreamWriter..ctor (System.String path, Boolean append, System.Text.Encoding encoding) [0x00000] in <filename unknown>:0 at (wrapper remoting-invoke-with-check) System.IO.StreamWriter:.ctor (string,bool,System.Text.Encoding) at Microsoft.Win32.KeyHandler.SaveRegisteredBootTime (System.String path, Int64 btime) [0x00000] in <filename unknown>:0
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

すべてのユーザーに対して書き込み権限を持つ目的のファイルを作成します。

 sudo touch /etc/mono/registry/last-btime sudo chmod 666 /etc/mono/registry/last-btime
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

Violationsプラグインをセットアップします。



したがって、レポートは次のようになります。



不快な瞬間がいくつかあります：まず、StyleCopの詳細レポートを正常に表示するには、レポートがプロジェクトのルートにある（一般的な傾向に違反している）必要があります。次に、Gendarmeの詳細レポートをまだ構成できませんでした（誰が出くわした-私は助けを求める）。



7.メトリックを収集します。

  <target name="sloccount"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Analyze code by SLOCCount."/> <exec program="sloccount" output="${report.d}/sloccount/sloccount.report" commandline=" --duplicates --wide --details ${work.d}"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

SLOCCountプラグインをセットアップします。



レポートの例：



8. 2つの段階で重複を検索します。最初にCloneAnalyzerアプリケーションを実行し、次に受信したレポートを変換します。

  <target name="cloneanalyze"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Find code duplicates by CloneAnalyze."/> <exec program="java" failonerror="false" output="${report.d}/cloneanalyzer/cloneanalyzer.report.txt" commandline=" -jar ${clone.jar} -c ${clone.conf} -f .*\.\(cs\|aspx\) -d ${work.d}"/> <echo message="Convert CloneAnalyze report in CPD report."/> <exec program="mono" failonerror="false" commandline=" ${clone.conv} ${report.d}/cloneanalyzer/cloneanalyzer.report.txt ${report.d}/cloneanalyzer/cloneanalyzer.report.xml"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

DRYプラグインをセットアップします。



レポートの例：



9.機能テストを実行します。最初にアプリケーションをデプロイし、Webサーバーを再起動して、実際にテストを実行します。

  <target name="ftest"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Prepare to launch tests."/> <copy todir="${deploy.d}/${bin.d}/"> <fileset basedir="${gui.d}/${bin.d}/${build.conf}"> <include name="*.dll"/> </fileset> </copy> <copy todir="${deploy.d}/"> <fileset basedir="${gui.d}/"> <include name="*.aspx"/> <include name="*.asax"/> <include name="*.config"/> </fileset> </copy> <echo message="Restart apache2 server."/> <exec program="/bin/bash" commandline="-c 'sudo /etc/init.d/apache2 restart'"/> <echo message="Testing project by Selenium."/> <exec program="${selen.sh}" failonerror="false" commandline=" -htmlSuite *firefox ${selen.host} ${selen.suite} ${report.d}/selenium/selenium.html"/> <echo message="Target completed at: ${datetime::now()}." /> </target>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

jenkinsユーザーがWebサーバーを再起動するには、適切な権限を付与する必要があります。

 su cat > /etc/sudoers << EOF jenkins ALL=(ALL) NOPASSWD: /etc/init.d/apache2 EOF exit
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

テストを実行するには、必要な環境変数を設定し、コマンドラインパラメータをそれ自体を介してSeleniumサーバーに送信するスクリプトラッパーを作成します。

 cd /var/lib/jenkins/tools/SeleniumRC touch selenium.sh chmod +x selenium.sh cat > selenium.sh << EOF #!/bin/bash export $(dbas-launch) export NSS_USE_SHARED_DB=ENABLE export DISPLAY=:0 java -jar /var/lib/jenkins/tools/SeleniumRC/selenium-server-standalone-2.18.0.jar $@ EOF
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

Apacheを構成します。 ファイル/etc/apache/conf.d/mod_monoを編集し、アプリケーションの場所を指定します。

 <IfModule !mod_mono.c> LoadModule mono_module /usr/lib/apache2/mod_mono.so </IfModule> MonoAutoApplication disabled AddHandler mono .aspx .ascx .asax .ashx .config .cs .asmx .axd MonoApplications "/:/home/vm/public_html" AddType application/x-asp-net .aspx AddType application/x-asp-net .asmx AddType application/x-asp-net .ashx AddType application/x-asp-net .asax AddType application/x-asp-net .ascx AddType application/x-asp-net .soap AddType application/x-asp-net .rem AddType application/x-asp-net .axd AddType application/x-asp-net .cs AddType application/x-asp-net .vb AddType application/x-asp-net .master AddType application/x-asp-net .sitemap AddType application/x-asp-net .resources AddType application/x-asp-net .skin AddType application/x-asp-net .browser AddType application/x-asp-net .webinfo AddType application/x-asp-net .resx AddType application/x-asp-net .licx AddType application/x-asp-net .csproj AddType application/x-asp-net .vbproj AddType application/x-asp-net .config AddType application/x-asp-net .Config AddType application/x-asp-net .dll DirectoryIndex index.aspx DirectoryIndex Default.aspx DirectoryIndex default.aspx
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

そして、アプリケーション構成ファイル/etc/apache2/conf.d/Exampleを作成します。

 Alias / "home/vm/public_html" MonoServerPath Example "/usr/bin/mod-mono-server2" MonoSetEnv Example MONO_IOMAP=all MonoApplications Example "/:/home/vm/public_html" <Location "/"> Allow from all Order allow,deny MonoSetServerAlias Example SetHandler mono SetOutputFilter DEFLATE SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip dont-vary </Location>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

 su cat > /etc/sudoers << EOF jenkins ALL=(ALL) NOPASSWD: /etc/init.d/apache2 EOF exit
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

Seleniumプラグインをセットアップします。



サンプルレポート（JenkinsはSeleniumレポートを1対1で表示します）： これで、NAntスクリプトの作成が完了しました。



10.リポジトリからソースコードを取得するタスクと同様に、開いているタスクのコードをスキャンするタスクは、Jenkinsから直接呼び出されます（Nantスクリプトをバイパスします）。

Task Scannerプラグインをセットアップします。



レポートの例：



アセンブリプロジェクトが構成され、実行する準備ができました。

チューニング

文字通り一言で言えば、他のいくつかのプラグイン（ 膨大な数のプラグインがあります）について説明したいと思います。



バックアップ -プラグインの目的はその名前から明らかであり、その構成は簡単です。 その説明は不要です。なぜなら 最初に心配するのはバックアップです！



JobConfigHistory-構成プロセス中に、プロジェクト構成に加えられた変更が失敗する場合があります。以前のバージョンに簡単に戻るには、以前のバージョンを自分で保存するための対策を講じる必要があります。 データプラグインは変更の履歴を保持し、加えられた変更を簡単に判断できます。



緑色のボール -デフォルトでは、ジェンキンスは3つの色を使用してステータスを表示します：赤、黄、青。 このプラグインを使用すると、青を緑に置き換えることができます。 このプラグインの実用的な価値は非常に疑わしいですが、美観を過大評価することは困難です！



次のビルド番号 - 次のビルド番号を設定できます。 構成中にいくつかのアセンブリが実行され、それらが削除され、ナンバリングに穴が開いた場合に便利です。 または、バージョン番号を強制的に設定する必要がある場合（たとえば、リリース用）。



Sidebar-Linkは非常に興味深いプラグインです。 メインページまたはプロジェクトのページにリンクを配置できます。 いつ役立つか。 たとえば、メインページで、企業リソース、ナレッジベース、またはその他へのリンクを配置できます（userContentディレクトリに配置されたコンテンツがJenkinsoによって自動的に表示されることを忘れないでください）。メインページにリンクを作成するには、サーバーを構成する必要があります（そしてプロジェクトではありません）：



その結果、メインページに[重要]リンクが表示されます。



プロジェクトページでは、このプロジェクトに固有のリソース（svnリポジトリなど）へのリンクを配置できます。また、より有用な場合、対応するJenkinsプラグインがないユーティリティのレポートへのリンクを配置できます。 プロジェクトページにリンクを作成するには、リンクを構成する必要があります。



アイコンファイルはサーバー設定を介してのみサーバーにダウンロードできることに注意してください。この機能はプロジェクト設定では使用できません。

これは、プロジェクトページのSubversionリンクの外観です。


これが、プロジェクトページの結論です。



そして、ビルドレポートページは次のとおりです。

広範な推論（通常の結論の代わりに）

もちろん、上記の例は理想化されています。

まず、提示された例にはデータベースが含まれていません。これは非常にまれであり、アセンブリプロジェクトからデータベースを正しい状態に維持する面白いタスクを奪います（常に制御下のスクリプトからデータベースを収集するか、バイナリファイルを直接制御下に置いてから、バイナリファイルで制御されたスクリプトを実行するかどうか）。



第二に、CI Servereでのアセンブルでは十分でない場合がほとんどです。ほとんどの場合、Matrixプロジェクトを作成して、アプリケーションのデプロイ操作が多少複雑になるようにすることをお勧めします。



3番目：ビルドサーバーではなく、テスト環境でユニットテストを実行する方がおそらく適切です。



この例では、通知プラグインはいずれも考慮されていません。実際には、それらの使用が必要になる場合があります。



最後に、CI Servereに（少し変更され、この場合、Xサーバのメカニズムを実行する機能テストではないかもしれないに 場合に 測定）。



もっと欲しいもの。

何よりも、事前テスト済みコミットが必要です。

テスト付きのコードカバレッジアナライザーが欲しいです。

より広いパラメータを持つメトリックコレクタが欲しい。C＃で記述されたコードの行数は確かにクールですが、循環的な複雑さや接続の程度に関する情報、そしておそらく何か他のものに関する情報を見たいと思います。ところで、デフォルトのIDEは、アプリケーションに表示されるユーティリティよりもはるかに優れたメトリック収集タスクに対処します。メトリクスの[開発]タブで、次の情報を確認できます。

PS

最後に、顧客のコミットから1か月後ではなく、ビルドサーバーから翌日にエラーについて学習したいすべての人を招待し、経験を共有し、提示された例についてコメントします。