这是一个关于Vagrant的学习系列,包含如下文章:
随着越来越被行业所接受,与之相关的持续集成和持续交付的作用和价值也更加突显。在本文中,我们将使用Vgrant和Ansible来自动地创建一套持续交付平台——ThoughtWorks的。如果你对Jenkins比较熟悉,也可以参考笔者搭建Jenkins多机构建环境的文章。
我们将创建一台Go Server和两台Go Agent,对于不熟悉GoCD的读者来说,可以将Go Server理解成Jenkins的Master,而将Go Agent理解为Jenkins的Slave。
本文源代码:
首先,创建如下Vangrantfile:
GO_SERVER_IP="192.168.3.2"GO_AGENT1_IP="192.168.3.3"GO_AGENT2_IP="192.168.3.4"Vagrant.configure("2") do |config| config.vm.box = "ubuntu/trusty64" config.vm.define "server" do |server| server.vm.hostname = "goserver" server.vm.network "private_network", ip: GO_SERVER_IP server.vm.provider "virtualbox" do |v| v.name = "go-server" v.memory = 1024 v.cpus = 2 end end config.vm.define "agent1" do |agent1| agent1.vm.hostname = "goagent1" agent1.vm.network "private_network", ip: GO_AGENT1_IP agent1.vm.provider "virtualbox" do |v| v.name = "go-agent1" v.memory = 1024 end end config.vm.define "agent2" do |agent2| agent2.vm.hostname = "goagent2" agent2.vm.network "private_network", ip: GO_AGENT2_IP agent2.vm.provider "virtualbox" do |v| v.name = "go-agent2" v.memory = 1024 end end config.vm.provision "ansible" do |ansible| ansible.playbook = "ansible/playbook.yml" ansible.groups = { "servers" => ["server"], "agents" => ["agent[1:2]"], "agents:vars" => {"goserver_ip" => GO_SERVER_IP} } endend
以上,我们创建了3台虚拟机,其中Go Server的IP地址为192.168.3.2,两台Go Agent的IP地址分别为192.168.3.3和192.168.3.4。由于采用了Vagrant的private_network网络方式,这3台虚拟机以及Host机器之间都是相互连通的。在config.vm.provision配置项中,我们指定了所使用的Ansible配置文件ansible/playbook.xml,该文件将同时用于Go Server和Go Agent的provision。最后,我们声明了两个Ansible的group,一个名为servers,包含了Go Server;另一个名为agents,包含两台Go Agent。对于两台Go Agent,我们还定义了变量goserver_ip,该变量将用于配置两台Go Agent,用于指向他们需要连接的Go Server。
然后创建playbook.xml如下:
---- hosts: servers become: true become_method: sudo roles: - role: goserver - role: git- hosts: agents become: true become_method: sudo roles: - role: goagent - role: git
在该文件中,我们定义了两份playbook,一份用于配置Go Server(上文提到的servers这个group),另一份用于配置Go Agent。可以看出,该playbook本身并没有做什么配置工作,而是对于不同的group使用了不同的Ansible role——goserver、goagent和git。
为了引用这些role,他们需要遵循一定的目录结构,比如需要在playbook.xml所在的目录下创建一个名为roles的目录用于存放所有的role。而每个role又有自身的目录结构,比如对于goserver这个role来说,要执行的task应该放在roles/goserver/tasks/main.yml这个文件中。有关role的目录结构细节请参考Ansible的。
这里我们将以goserver这个role为例讲解Go Server的provision过程。goserver这个role的目录包含以下内容:
├── handlers│ └── main.yml├── meta│ └── main.yml└── tasks └── main.yml
首先在tasks/main.yml中,我们通过apt这个module安装了jdk和go-server:
---- name: install jdk apt: pkg=default-jdk state=present- name: install go sever apt: pkg=go-server state=present notify: - start go server
在安装完成之后,我们还需要保证Go Server是启动的,这个在handlers/main.yml中:
---- name: start go server service: name=go-server state=started
对于Go Server来说,安装过程的最后一步会自动启动Go Server的service,故以上步骤其实省略也可。但是对于Go Agent来说,则不是自动启动的了。
另外,在meta/main.yml文件中,我们声明了goserver依赖于另一个role——apt_update:
---dependencies: - { role: apt_update }
也就是说,在goserver运行之前,apt_update这个role会自动运行,该role主要作用是将apt源从默认的国外转成国内的阿里云,这样在安装软件时速度会更快,另外由于go-server不在阿里云源里,我们还需要手动添加go-server的源。apt_update目录如下:
├── files│ └── sources.list└── tasks └── main.yml
在apt_update/tasks/main.yml文件中,设置阿里云的源和go-server自己的源:
---- name: archieve existing sources.list shell: creates="/etc/apt/sources.list.old" mv /etc/apt/sources.list /etc/apt/sources.list.old- name: copy new sources.list copy: src=sources.list dest=/etc/apt/ - name: add gocd.list shell: creates="/etc/apt/sources.list.d/gocd.list" echo "deb https://download.go.cd /" | sudo tee /etc/apt/sources.list.d/gocd.list- name: add gocd apt key shell: curl https://download.go.cd/GOCD-GPG-KEY.asc | sudo apt-key add -- name: update apt cache apt: update_cache=yes
除了安装Go Server,我们还安装了Git,用于在构建项目时能够顺利从Git服务器(比如Github)下载到项目源代码。
对于两台Go Agent来说,也具有与Go Server相似的过程。
最后,运行vagrant up,我们便可以在Virtualbox中看到这3台虚拟机了:
然后在Host机器上打开http://192.168.3.2:8153/go/pipelines,便可以看到Go Server的页面了:
请注意,此时的两台Go Agent虽然能够正常连接Go Server,但是他们的状态却是disable的,为了正常使用Go Agent来构建项目,你需要先在Go Server中将他们enable。点击页面上方的“AGENTS”,进入agents管理也便可enable/disable所有的agents:
还有个问题,Ansible所需要的inventory在哪里?事实上,Vagrant会基于Vangrantfile自动为我们生成Ansible的inventory文件,并放在与Vgrantfile文件同级的.vagrant/provisioners/ansible/inventory/vagrant_ansible_inventory文件中。对于本项目,在笔者的机器上所生成的vagrant_ansible_inventory文件如下:
# Generated by Vagrantagent1 ansible_ssh_host=127.0.0.1 ansible_ssh_port=2200 ansible_ssh_user='vagrant' ansible_ssh_private_key_file='/Users/yteng/github/vagrant/ansible-go-server-2-agents-ubuntu1404/.vagrant/machines/agent1/virtualbox/private_key'agent2 ansible_ssh_host=127.0.0.1 ansible_ssh_port=2201 ansible_ssh_user='vagrant' ansible_ssh_private_key_file='/Users/yteng/github/vagrant/ansible-go-server-2-agents-ubuntu1404/.vagrant/machines/agent2/virtualbox/private_key'server ansible_ssh_host=127.0.0.1 ansible_ssh_port=2222 ansible_ssh_user='vagrant' ansible_ssh_private_key_file='/Users/yteng/github/vagrant/ansible-go-server-2-agents-ubuntu1404/.vagrant/machines/server/virtualbox/private_key'[servers]server[agents]agent[1:2][agents:vars]goserver_ip=192.168.3.2