CI学习 CCNET Config 第一天

时间:2022-04-23
本文章向大家介绍CI学习 CCNET Config 第一天，主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项，具有一定的参考价值，需要的朋友可以参考一下。

CCNet的整体结构就是一个Xml文档，根元素就是cruisecontrol，具体的代码块如下所示：

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
     <project name="P1">
         <other settings />
     </project>
     <project name="P2">
         <other settings />
     </project>
</cruisecontrol>

其中，命名空间标定了CCNet里面的预处理过程(Preprocessor)。

一、预处理：Preprocessor

    预处理里面包含三个主要元素：define、include和scope，define用于定义以后扩展的常量、include用于包含其他文件的类容，而scope用于封装现存的常量的值。

   1、define元素

    define元素可以用来定义一个预处理(Preprocessor)常量。如下所示：

 <cb:define foo="bar" />

   也可以在一行中定义多个常量：

<cb:define a="1" b="2" c="3"/>

   还可以定义一个xml段：

<cb:define name="baz">
  <some_element>
    <some_inner_element/>
  </some_element>
</cb:define>

任何有效的xml代码元素都可以包含其中，包括元素、属性、文本节点和注释等。

    有两种方式来使用定义的常量：文本引用和xml引用

    1）、文本引用的方式如下：$(const_name)

如果常量未定义，系统将搜索系统变量来替换；如果系统变量也不存在，将引发错误。

<pre><code class="xml syntaxhl"><span class="CodeRay"><span class="tag"><cb:define</span> <span class="attribute-name">foo</span>=<span class="string"><span class="delimiter">"</span><span class="content">bar</span><span class="delimiter">"</span></span><span class="tag">/></span></span></code>

<somexml attr1="$(foo)"/>

<somexml>$(foo)</somexml>
<env dir="$(PATH)"/>

    2）、xml引用的方式如下：

如果常量未定义，系统将搜索系统变量来替换；如果系统变量也不存在，将引发错误。

<cb:define foo="bar"/>
<sample>
  <cb:foo/>
</sample>

其效果是直接替换被引用的值，上面结果如下：

[html] view plain copy

print?

  1. <sample>  
  2.   bar  
  3. </sample>  
<sample>
  bar
</sample>

   3）、常量的嵌套以及参数

常量引用可以嵌套使用，如下所示：

<cb:define alpha="alphaval"/>
<cb:define zed="zedval/$(alpha)"/>

<z>$(zed)</z>

在高层次的嵌套时，在cb:varname这种语法中，常量值是可以传递到调用的元素中去的，如下面的例子：

  

<cb:define name="beta">
  <hello>
    <cb:gamma/>
    <hi attr1="$(delta)"/>
  </hello>
</cb:define>

此时的gamma和delta都还没有定义

<cb:beta delta="deltaval">
  <cb:define name="gamma">
    <gamma_element>hi</gamma_element>
  </cb:define>
</cb:beta>

在定义了如下xml段之后，gamma就可以正常被替换了，而且上面没有定义的delta常量，也会通过cb:deta定义的delta常量所替换。最终结果如下：

<hello>
  <gamma_element>hi</gamma_element>
  <hi attr1="deltaval" />
</hello>

    2、Scope元素

Scope用于控制预处理定义中的范围，在同一个范围里面不可以定义相同的常量，但是在嵌套的范围里面，可以覆盖外层定义的常量，这一点和程序里面的代码段很像。

如下定义：

<cb:scope a="a_val" b="b_val">
  <test attr="$(a)" attr2="$(b)"/>
  <cb:scope a="a_val_redefined">
    <test attr="$(a)" attr2="$(b)"/>
  </cb:scope>
</cb:scope>

其结果为：

<test attr="a_val" att2="b_val"/>
<test attr="a_val_redefined" att2="b_val"/>

其中就覆盖了外层的a常量。

可

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
   <cb:define WorkingMainDir="C:Integration"/>
   <cb:define WorkingDir="WorkingDirectory"/>
   <cb:define ArtifactsDir="Artifacts"/>
 
   <cb:scope ProjectName="Alpha">
     <project name="$(ProjectName)" queue="Q1" queuePriority="1">
       <workingDirectory>$(WorkingMainDir)$(ProjectName)$(WorkingDir)</workingDirectory>
       <artifactDirectory>$(WorkingMainDir)$(ProjectName)$(ArtifactsDir)</artifactDirectory>
    </project>
  </cb:scope>

  <cb:scope ProjectName="Beta">
    <project name="$(ProjectName)" queue="Q1" queuePriority="1">
      <workingDirectory>$(WorkingMainDir)$(ProjectName)$(WorkingDir)</workingDirectory>
      <artifactDirectory>$(WorkingMainDir)$(ProjectName)$(ArtifactsDir)</artifactDirectory>
    </project>
  </cb:scope>

</cruisecontrol>

而其结果则为：

<cruisecontrol>
 
     <project name="Alpha" queue="Q1" queuePriority="1">
       <workingDirectory>C:IntegrationAlphaWorkingDirectory</workingDirectory>
       <artifactDirectory>C:IntegrationAlphaArtifacts</artifactDirectory>
     </project>
 
     <project name="Beta" queue="Q1" queuePriority="1">
      <workingDirectory>C:IntegrationBetaWorkingDirectory</workingDirectory>
      <artifactDirectory>C:IntegrationBetaArtifacts</artifactDirectory>
    </project>

</cruisecontrol>

通过scope，一个变通的定义方式如下：

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
  <cb:define WorkingMainDir="C:Integration"/>
  <cb:define WorkingDir="WorkingDirectory"/>
  <cb:define ArtifactsDir="Artifacts"/>
 
  <cb:define name="OurProject">
    <project name="$(ProjectName)" queue="Q1" queuePriority="1">
      <workingDirectory>$(WorkingMainDir)$(ProjectName)$(WorkingDir)</workingDirectory>
      <artifactDirectory>$(WorkingMainDir)$(ProjectName)$(ArtifactsDir)</artifactDirectory>
   </project>
 </cb:define>

 <cb:scope ProjectName="Alpha">
   <cb:OurProject/>
 </cb:scope>

 <cb:scope ProjectName="Beta">
   <cb:OurProject/>
 </cb:scope>
</cruisecontrol>

这样则较大的提高了配置的可维护性。

    3、include元素

    include元素用来包含其他的文件内容，include中根据ccnet.config文件为基准路径进行相对定位，这样就可以在ccnet.config文件里面调用所有其他文件定义的部分，以提高可维护性。如下所示：

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
 
   <cb:include href="Definitions.xml" xmlns:cb="urn:ccnet.config.builder"/>
 
   <cb:include href="CI_Projects.xml" xmlns:cb="urn:ccnet.config.builder"/>
 
   <cb:include href="QA_Projects.xml" xmlns:cb="urn:ccnet.config.builder"/>
 
 </cruisecontrol>

其中Definitions.xml文件定义如下：

<cb:config-template xmlns:cb="urn:ccnet.config.builder">

  <queue name="Q1" duplicates="UseFirst" lockqueues="Q2, Q4" />

  <cb:define name="EmailPublisher">
    <email from="buildmaster@mycompany.com" 
          mailhost="localhost" 
          mailhostUsername="TheMailer" 
          mailhostPassword="JohnWayne" 
          includeDetails="TRUE">
    <users />
        <groups />

        <modifierNotificationTypes>
          <NotificationType>Failed</NotificationType>
          <NotificationType>Fixed</NotificationType>
        </modifierNotificationTypes>

    </email>
  </cb:define>

  <cb:define name="common_publishers">
    <artifactcleanup cleanUpMethod="KeepMaximumXHistoryDataEntries" cleanUpValue="500" />
    <xmllogger />
    <statistics />
    <modificationHistory  onlyLogWhenChangesFound="true" />
    <rss/>
  </cb:define>

  <cb:define name="common_nant">
       <executable>c:nantnant.exe</executable>
       <nologo>true</nologo>
    <buildTimeoutSeconds>240</buildTimeoutSeconds>
  </cb:define>

  <cb:define name="nant_args_CI">
      <buildArgs>clean compile</buildArgs>
  </cb:define>

</cb:config-template>

随机文章
本站知识点必读
最近更新