buildbot-travis 0.6.4

支持的语言

支持的语言列表取决于您的构建工作器配置。

借助docker，您可以根据需要创建任意数量的工作器配置镜像。

实际上，travis规范的语言参数并未充分利用buildbot的全部可能性。

您可以根据要检查的软件版本选择不同的docker镜像。这可以避免在您的travis.yml文件（如travis saas所做的那样）开始时设置工作环境的时间。

构建步骤

Travis为您提供了6个构建钩子点。

• before_install

• install

• after_install

• before_script

• script

• after_script

我们并不关心您从这些钩子中运行什么，只要退出代码为0表示成功，其他任何代码都表示失败。

您可以提供一个这样的单条命令

install: ./bin/buildout

或者像这样提供多条命令

install:
  - ./configure
  - ./bin/buildout

yaml中的列表中的每个元素都会创建一个单独的步骤，该步骤的名称为命令行的第一个字符。

如果您想创建一个自定义名称，buildbot_travis支持以下语法

script:
  - |
      # build
      ./configure
      make
  - |
      # tests
      make tests

Buildbot 特定功能

script:
  - |
      # build
      ./configure
      make

  - title: tests
    shell: dash
    condition: TESTS=='tests'
    cmd: make tests

- title: make dist
  cmd: !i make REVISION=%(prop:got_revision:-%(src::revision:-unknown)s)s dist

script:
  - title: make dist
    cmd: [ "make", !i "REVISION=%(prop:got_revision:-%(src::revision:-unknown)s)s", "dist" ]

script:
  - condition: TESTS=='trial'
    step: !Trial
        name: trial
        tests: buildbot.test

from buildbot_travis.travisyml import registerStepClass

class FancyStep(steps.ShellSequence):
    ...

registerStepClass("FancyStep", FancyStep)

script:
  - step: !FancyStep

script:
  - step: !ShellCommand "true"

  - step: !ShellCommand
        - "true"

  - step: !ShellCommand
        command: "true"

language: python

label_mapping:
  TWISTED: tw
  SQLALCHEMY: sqla
  SQLALCHEMY_MIGRATE: sqlam
  latest: l
  python: py

安装依赖项

使用的Docker镜像是一次性的，并且每个构建都将从干净的状态开始。

您可以创建一个具有无密码sudo的Docker镜像，就像travis一样，这样您就可以使用apt-get

before_install:
  - sudo apt-get update
  - sudo apt-get install -y -q mydependency

但是，提供一个包含所需内容的预构建Docker镜像是一种更好的做法，并且更优化。

环境

您可能想要构建同一软件的多个版本。Travis提供了

env:
 - FLAVOUR=blue
 - FLAVOUR=green
 - FLAVOUR=red

install:
  - ./configure -f $FLAVOUR
  - ./bin/buildout

对这个代码库的提交将触发对蓝色、绿色和红色版本的构建。环境变量可以在您从.travis.yml运行的脚本中像普通环境变量一样使用，也可以在.travis.yml本身中使用。

env是一系列环境变量。您可以在一行中指定多个变量，如下所示

env:
 - PROP1=foo PROP2=bar

构建矩阵

您在language和env上的选项创建了一个隐含的构建矩阵。构建矩阵是所有可能的env选项和语言版本的组合集。您可以排除某些组合或插入额外的组合来微调此矩阵。

以下是一个排除组合和插入额外构建的示例

python:
  - 2.6
  - 2.7

env:
  - FLAVOUR=apple
  - FLAVOUR=orange

matrix:
  exclude:
    - python: 2.7
      env: FLAVOUR=orange
  include:
    - python: 2.7
      env: FLAVOUR=banana

这将为banana构建执行额外的构建，但仅针对python 2.7。并且它将关闭对orange版本的构建，再次仅针对python 2.7。

部署

左侧菜单中有一个Deploy部分。在这个部分中，一旦配置，将提供部署仪表板。

此仪表板实现了一个从提交到生产环境的自动化交付流程，用户只需点击一下即可获得您项目的最新版本。

以下是一个仪表板的模板

可交付成果	阶段
(项目)	提交	开发	质量保证	生产
可交付成果A	GIT修订版本	1.2.3	GIT标签	GIT标签

例如，可交付成果A的版本1.2.3（通过GIT标签指定）已部署到开发阶段。

以下是设置Buildbot Travis中的部署仪表板的5个步骤。

1. 在“设置”部分有一个可用的“部署”部分。在这个部分中，“部署环境”是交付物将要部署的目标环境（或阶段）的列表。这些环境应该按照您的开发流程定义进行排序。示例：

   COMMIT (merged dev), DEV, QA, PROD
   BEWARE!The first column is reserved for COMMIT stage so you do not need to define it in the Stages list.

2. 转到左侧菜单中的“部署”部分。您应该看到一个类似于上面的部署仪表板。阶段应该与1)中定义的阶段相同。

3. 转到“设置/项目”部分。在不同的项目中，将相应的阶段添加到阶段字段中。阶段可以是2)中定义的阶段的一个子集。

4. 您应该看到一个完全配置的部署仪表板，其中包含所有交付物、阶段、GIT修订和GIT标签。GIT修订和GIT标签可用在下拉列表中。当您选择特定版本时，会弹出一个窗口来在特定阶段启动部署过程。

5. 要启用按钮部署，您需要定义部署过程。创建部署脚本并更新每个交付物的.travis.yml文件的脚本和/或after_script部分。

   示例

   after_script:
      - |
        # Deployment
          python ./deploy.py --repo "${repository}" --stage "${stage}" --version "${version}";
   
          ${repository} is the URL of the project's (or deliverable's) repo.
          ${stage} is the retrieved from the Deployment dashboard.
          ${version} is retrieved from the Deployment dashboard.