Buildbot First Run 持续集成框架

Buildbot 当前最新 发布版 2.1(最早接触时是0.8.12),The Continuous Integration Framework。
自 2019年2月 发布 2.0 开始,全面转向 Python 3,不再支持 Python 2.7。

Buildbot is shipped in two components: the buildmaster (called buildbot for legacy reasons) and the buildslave.

Buildbot architectural overview

请按照 First Run Tutorial 认识一下 Buildbot。

Python 环境
现在 Linux 已经预装 Python 2.7(符合安装要求),我们测试机上的完整版本 2.7.5(python --version),Python 默认安装许多 modules,比如 easy_install 等。

python -c "help('modules')" # 查看 python 已经安装的模块 modules
python -m mod # run library module as a script (terminates option list). 这个命令可以查看是否安装了指定的 mod 模块。
python -m SimpleHTTPServer port 可以临时在 port 端口启动一个 HTTP SERVER。

Note
Buildbot does not require root access. Run the commands in this tutorial as a normal, unprivileged user.
即:将 Buildbot 安装在 Virtualenv 虚拟 Python 环境下。

cd #进入用户根目录
mkdir -p tmp/buildbot
cd tmp/buildbot
virtualenv --no-site-packages sandbox # 创建一个名为sandbox的虚拟环境
source sandbox/bin/activate # 启用并进入虚拟环境:(sandbox)[michael@localhost buildbot]$ ...
easy_install sqlalchemy==0.7.10
easy_install buildbot==0.8.12 # 安装 buildbot master

我不打算详述整个过程,仅列举一下新鲜点或者遇到的问题。

安装 virtualenv
virtualenv - Virtual Python Environment builder.

To install version 13.1.2 globally from source:

$ curl -O https://pypi.python.org/packages/source/v/virtualenv/virtualenv-13.1.2.tar.gz # 或者使用 wget
$ tar zxvf virtualenv-13.1.2.tar.gz
$ cd virtualenv-13.1.2
$ [sudo] python setup.py install

** 指明 buildbot 版本 **
在安装 buildbot 时请指明版本,否则匹配到最新版本 0.9.0b3,报告错误:

Best match: buildbot 0.9.0b3
...
Processing buildbot-0.9.0b3.zip
...
error: Setup script exited with error: package directory 'buildbot/test' does not exist

** sandbox 环境 **

  • 虚拟环境下的 python 版本 2.7.5,Twisted 版本 15.4.0;
    python -c "import twisted; print twisted.__version__")
  • 执行 source sandbox/bin/activate 后,即启用并进入虚拟环境:
    (sandbox)[michael@localhost buildbot]$

Creating a master

buildbot create-master master
mv master/master.cfg.sample master/master.cfg
buildbot start master
tail -f master/twistd.log # 可以查看到启动成功的日志

** 了解 buildbot 命令 **
buildbot --help
buildbot create-master --help

Creating a slave

cd
cd tmp/buildbot
source sandbox/bin/activate
easy_install buildbot-slave==0.8.12 # 安装buildbot-slave
buildslave create-slave slave localhost:9989 example-slave pass
buildslave start slave
tail -f slave/twistd.log

diagnostic tool

buildbot --version # If it shows you the versions of Buildbot and Twisted, the install went ok.
buildslave --version
pydoc buildbot # Help on package buildbot,比如 buildbot 依赖的包。pydoc: the Python documentation tool。

初始界面

访问:http://192.168.1.91:8010/

localhost -> 192.168.1.91.png
Waterfall Display.png

Linux centos-release 和 kernel-release

$ cat /etc/centos-release
CentOS Linux release 7.1.1503 (Core)
$ uname -r # --kernel-release
3.10.0-229.el7.x86_64
$ cat /proc/version
Linux version 3.10.0-229.el7.x86_64 (builder@kbuilder.dev.centos.org) (gcc version 4.8.2 20140120 (Red Hat 4.8.2-16) (GCC) ) #1 SMP Fri Mar 6 11:36:42 UTC 2015

配置

buildbot 的设计思路很好,她的一个基本理念就是 将 buildslave 设计得极其简单易用,不需要什么配置。buildbot 的配置都在 buildmaster 的 master.cfg 文件。

The buildslaves are designed to require an absolute minimum of configuration, reducing the effort a potential volunteer needs to expend to be able to contribute a new test environment to the project.

buildbot reconfig master # master/master.cfg 修改后重新加载,或者 buildbot restart master

架构分解

System Architecture

Buildbot: Continuous Integration Framework
master & worker
  • Notifiers: Status targets

BuildSlave Connections

buildslaves obtain source code from vcs

To perform builds, the buildslaves must typically obtain source code from a CVS/SVN/etc repository.
The buildmaster provides instructions for performing builds, but does not provide the source code itself.

Buildmaster Architecture

Buildmaster Architecture
  • 1个 buildmaster,2个 buildslave(如2个平台)
  • master.cfg: 2个 scheduler,3个 builder
  • It is quite common to have many Builders sharing the same buildslave.
  • Within a single BuildSlave, each Builder creates its own SlaveBuilder instance.

Builders:
Simply put, a builder is an element that is in charge of performing some action or sequence of actions, normally something related to building software (for example, checking out the source, or make all), but it can also run arbitrary commands.
The 'builders' list defines the Builders, which tell Buildbot how to perform a build: what steps(with a series of BuildSteps, configured in a BuildFactory), and which slaves can execute them.
Note that any particular build will only take place on one slave(the only reason to use multiple BuildSlaves for a single Builder is to provide a measure of load-balancing.)
为一个 builder 指定多个 buildslave 的唯一原因是负载均衡,任何一个 build 只会在一个 buildslave 上执行。

Status Delivery Architecture

Status Delivery Architecture

参考

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容