基于 Vagrant 和 Ansible 搭建持续交付平台

Posted 2021-04-25 DevOps时代

这是一个关于Vagrant的学习系列，包含如下文章：

1. Vagrant入门

2. 创建自己的Vagrant box

3. 用Vagrant搭建Jenkins构建环境

4. 用Vagrant和Ansible搭建持续交付平台

随着微服务越来越被行业所接受，与之相关的持续集成和持续交付的作用和价值也更加突显。在本文中，我们将使用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

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

由于采用了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

报名请点击阅读原文