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

2019-05-17 16:16:53 浏览数 (1)

这是一个关于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

代码语言:javascript复制
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如下:

代码语言:javascript复制
---
- 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的目录包含以下内容:

代码语言:javascript复制
├── handlers
│   └── main.yml
├── meta
│   └── main.yml
└── tasks
     └── main.yml

首先在tasks/main.yml中,我们通过apt这个module安装了jdk和go-server:

代码语言:javascript复制
---
- 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中:

代码语言:javascript复制
---
- name: start go server
  service: name=go-server state=started

对于Go Server来说,安装过程的最后一步会自动启动Go Server的service,故以上步骤其实省略也可。但是对于Go Agent来说,则不是自动启动的了。

另外,在meta/main.yml文件中,我们声明了goserver依赖于另一个role——apt_update:

代码语言:javascript复制
---
dependencies:
  - { role: apt_update }

也就是说,在goserver运行之前,apt_update这个role会自动运行,该role主要作用是将apt源从默认的国外转成国内的阿里云,这样在安装软件时速度会更快,另外由于go-server不在阿里云源里,我们还需要手动添加go-server的源。apt_update目录如下:

代码语言:javascript复制
├── files
│   └── sources.list
└── tasks
    └── main.yml

在apt_update/tasks/main.yml文件中,设置阿里云的源和go-server自己的源:

代码语言:javascript复制
---
- 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文件如下:

代码语言:javascript复制
# 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

作者:无知者云 链接:https://www.cnblogs.com/davenkin/p/vagrant-ansible-gocd.html

0 人点赞