用Vagrant创建Jenkins构建环境
这是一个关于Vagrant的学习系列,包含如下文章:
在上一篇文章中,我们讲到了如何创建自己的vagrant box。本文中,我们将使用Vagrant一次性创建3台虚拟机以组成一个Jenkins的master-slave构建环境,其中包含1台Jenkins master机器,2台slave机器。我们将采用Shell作为provision工具,当然你也可以使用像Ansible、Chef等。
本文源代码:https://github.com/davenkin/vagrant/tree/master/multi-machine-jenkins-cluster-ubuntu1404
在Vagrantfile中,通过config.vm.define来定义多台机器,通过引用外部的Shell脚本进行provision,Vagrantfile如下:
Vagrant.configure("2") do |config| config.vm.box = "ubuntu/trusty64" config.vm.define "master" do |master| master.vm.network "private_network", ip: "192.168.2.2" master.vm.provision "shell", path: "master_provision.sh" master.vm.provider "virtualbox" do |v| v.name = "jenkins-master" end end config.vm.define "slave1" do |slave1| slave1.vm.network "private_network", ip: "192.168.2.3" slave1.vm.provision "shell", path: "slave_provision.sh" slave1.vm.provider "virtualbox" do |v| v.name = "jenkins-slave1" end end config.vm.define "slave2" do |slave2| slave2.vm.network "private_network", ip: "192.168.2.4" slave2.vm.provision "shell", path: "slave_provision.sh" slave2.vm.provider "virtualbox" do |v| v.name = "jenkins-slave2" end end end
在每一个config.vm.define的配置内部,我们可以使用与其外部相同的配置项,内部配置会覆盖外部配置。这样,我们可以在外部配置中设置一些所有机器都共享的配置信息,然后在每个config.vm.define内部中针对性地配置某一台机器。
我们使用private network组成一个局域网,分别为各台机器指定静态的IP地址,此时其实使用的Virtualbox的Host-only网络类型。
对于master机器而言,我们首先需要安装JDK,然后安装Jenkins server,此时的master_provision.sh如下:
#! /bin/bash #change apt source to be inside China to speed up apt sudo mv /etc/apt/sources.list /etc/apt/sources.list.old sudo cp /vagrant/sources.list /etc/apt/sources.list #prepare for jenkins installation wget -q -O - https://pkg.jenkins.io/debian/jenkins-ci.org.key | sudo apt-key add - sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list' sudo apt-get update #install openjdk sudo apt-get -y install default-jdk #install jenkins sudo apt-get -y install jenkins
请注意,在provision一开始,我们更新了apt的源以提高下载速度。此时的sources.list包含以下阿里云的源:
deb http://mirrors.aliyun.com/ubuntu/ trusty main multiverse restricted universe deb http://mirrors.aliyun.com/ubuntu/ trusty-backports main multiverse restricted universe deb http://mirrors.aliyun.com/ubuntu/ trusty-proposed main multiverse restricted universe deb http://mirrors.aliyun.com/ubuntu/ trusty-security main multiverse restricted universe deb http://mirrors.aliyun.com/ubuntu/ trusty-updates main multiverse restricted universe deb-src http://mirrors.aliyun.com/ubuntu/ trusty main multiverse restricted universe deb-src http://mirrors.aliyun.com/ubuntu/ trusty-backports main multiverse restricted universe deb-src http://mirrors.aliyun.com/ubuntu/ trusty-proposed main multiverse restricted universe deb-src http://mirrors.aliyun.com/ubuntu/ trusty-security main multiverse restricted universe deb-src http://mirrors.aliyun.com/ubuntu/ trusty-updates main multiverse restricted universe
对于两台slave机器来说,我们只需要安装JDK即可(其他软件,比如SSH等都已经包含在ubuntu/trusty64 box中了),对两台slave执行同一份provision文件provision_slave.sh:
#! /bin/bash #change apt source to be inside China to speed up apt sudo mv /etc/apt/sources.list /etc/apt/sources.list.old sudo cp /vagrant/sources.list /etc/apt/sources.list sudo apt-get update #install openjdk sudo apt-get -y install default-jdk
运行“vagrant up”,在Virtualbox中将出现三台虚拟机,他们与host机器同属于一个局域网,相互可连通。
在host机器中打开http://192.168.2.2:8080(即Jenkins master),开始初始化配置Jenkins:
Jenkins要求输入初始的admin密码,密码位于文件/var/lib/jenkins/secrets/initialAdminPassword中,请注意,该文件为master机器上的文件,而不是host机上的。此时我们通过“vagrant ssh master”登录到master机器上,该文件的内容即为admin的初始密码。之后Jenkins将提示我们安装一些必要的插件,安装Jenkins推荐的插件即可,之后Jenkins还会让我们创建一个真正的admin用户,完了就可以使用Jenkins了。
不过此时的Jenkins master还并不知道slave机器的存在,为了能使用slave机器,我们需要将master机上用户“jenkins”的public key上传到每一台slave机器上,这里我们选择slave上的“vagrant”用户作为构建Jenkins job的用户,即我们需要先在master机器上为jenkins用户生成一对keypair,然后将public key加入到每台slave机上vagrant用户的authorised_keys文件中。这个过程是标准的SSH配置过程,请参考这里。另外,为了使master能够通过SSH连接slave,我们还需要以master机器上的jenkins用户的private key添加一个Credential,这里我们添加一个名为vagrant的Credential,采用直接输入密钥的方式填入jenkins用户的密钥:
在配置好了SSH之后,便可以在Jenkins中加入slave了:进入添加新node页面:
这里有几点需要注意,在“Romote root directory”中,必须填入“/home/vagrant”,因为这是vagrant用户拥有读写权限的目录;另外,在“Launch method”中,选择“Launch slave agents on Unix machines via SSH”,最后在Credentials中选择在先前添加的vagrant。
在下一篇中,我们将讲到如何用Vagrant和Ansible搭建持续交付平台。