CI学习 CCNET Config 第一天

用户1198337

发布于 2018-01-19 14:54:37

6150

发布于 2018-01-19 14:54:37

文章被收录于专栏：我有一个梦想

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>$(foo)</somexml>

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

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

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

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

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

[html] view plain copy

print ?

<sample>
bar
</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:\Integration\Alpha\WorkingDirectory</workingDirectory>
       <artifactDirectory>C:\Integration\Alpha\Artifacts</artifactDirectory>
     </project>
 
     <project name="Beta" queue="Q1" queuePriority="1">
      <workingDirectory>C:\Integration\Beta\WorkingDirectory</workingDirectory>
      <artifactDirectory>C:\Integration\Beta\Artifacts</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:\nant\nant.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>

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2017-12-11 ，如有侵权请联系 cloudcommunity@tencent.com 删除

xml

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

xml

登录后参与评论

0 条评论

热度

CI学习 CCNET Config 第一天

CI学习 CCNET Config 第一天

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐