用Vagrant和Ansible搭建持续交付平台
这是一个关于Vagrant的学习系列，包含如下文章：
随着微服务越来越被行业所接受，与之相关的持续集成和持续交付的作用和价值也更加突显。在本文中，我们将使用Vgrant和Ansible来自动地创建一套持续交付平台——ThoughtWorks的GoCD。如果你对Jenkins比较熟悉，也可以参考笔者另外一篇搭建Jenkins多机构建环境的文章。
我们将创建一台Go Server和两台Go Agent，对于不熟悉GoCD的读者来说，可以将Go Server理解成Jenkins的Master，而将Go Agent理解为Jenkins的Slave。
本文源代码：https://github.com/davenkin/vagrant/tree/master/ansible-go-server-2-agents-ubuntu1404
首先，创建如下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}
}
end
end
以上，我们创建了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 Vagrant
agent1 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
