jenkins + supervisor + ansible 实现netcore程序的多机一键部署

　　

　　上一篇我们简单的说到了使用jenkins+supervisor实现了一个单机版的多副本部署，但是在更多的场景下还是需要netcore程序的多机一键部署，那么多

机器间如何分发呢？ 肯定不能使用scp这么低级别的命令，所以你的技术栈中要引进ansible，用它来实现这个功能不要太爽。

　　

一：ansible部署

     ansible是一个自动化运维工具，实现方法就是在主控机上通过ssh免秘钥的方式自动分发你的程序到多台机器上，所以第一步你要配置主控机到远程机

的ssh免秘钥登陆。我这里有两台机器：

    10.25.198.96   【主控机】

    10.25.59.59     【远程机】

大概的一个简图就是这样。

 

1. 免密登陆

[root@localhost ~]# ssh-keygen -t rsa -P ''
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): 
Created directory '/root/.ssh'.
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
40:72:cc:f4:c3:e7:15:c9:9f:ee:f8:48:ec:22:be:a1 [email protected]
The key's randomart image is:
+--[ RSA 2048]----+
|    .++    ...   |
|     +oo    o.   |
|      . + . .. . |
|       . + .  o  |
|        S .  .   |
|           .  .  |
|        .   oo   |
|       ....o...  |
|      E.oo .o..  |
+-----------------+
[root@localhost ~]# ls /root/.ssh/id_rsa
/root/.ssh/id_rsa
[root@localhost ~]# ls /root/.ssh
id_rsa  id_rsa.pub
[root@localhost ~]# scp /root/.ssh/id_rsa.pub root@10.25.59.59:/root/.ssh/authorized_keys
root@10.25.59.59's password: 
id_rsa.pub                                                                100%  408     0.4KB/s   00:00 
[root@localhost ~]# cat /root/.ssh/id_rsa.pub >> /root/.ssh/authorized_keys

 

2.  安装ansible

   因为ansible是python写的，通常有两种安装方式：yum 和 pip install 。 我这里就采用yum安装，安装完成之后，直接键入ansible命令如下：

[root@localhost ~]# ansible
ERROR! Unexpected Exception, this is probably a bug: (cryptography 0.8.2 (/usr/lib64/python2.7/site-packages), Requirement.parse('cryptography>=1.1'))
the full traceback was:

 

     可以看到上面报错了，如果你不了解python，还是有点头疼的，上面说的是你的cryptography包版本太低，需要安装>=1.1的，你可以到pipy上down一个

新包下来。 https://pypi.org/project/cryptography/2.5/       

 

 

对了，如果你的pip也没装的话，那你还是先通过yum install pip吧。

[root@localhost ~]# pip install cryptography==2.5
DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7.
Collecting cryptography==2.5
  Downloading https://files.pythonhosted.org/packages/17/fd/4c2c8953a9dfe38fbe0c3adafb6355540bd98cef70cc82734acb0a4c0e2f/cryptography-2.5-cp27-cp27mu-manylinux1_x86_64.whl (2.4MB)
    100% |████████████████████████████████| 2.4MB 14kB/s 
Collecting cffi!=1.11.3,>=1.8 (from cryptography==2.5)
  Downloading https://files.pythonhosted.org/packages/14/dd/3e7a1e1280e7d767bd3fa15791759c91ec19058ebe31217fe66f3e9a8c49/cffi-1.11.5-cp27-cp27mu-manylinux1_x86_64.whl (407kB)
    100% |████████████████████████████████| 409kB 15kB/s 
Requirement already satisfied: six>=1.4.1 in /usr/lib/python2.7/site-packages (from cryptography==2.5) (1.9.0)
Collecting ipaddress; python_version < "3" (from cryptography==2.5)
  Downloading https://files.pythonhosted.org/packages/fc/d0/7fc3a811e011d4b388be48a0e381db8d990042df54aa4ef4599a31d39853/ipaddress-1.0.22-py2.py3-none-any.whl
Collecting asn1crypto>=0.21.0 (from cryptography==2.5)
  Downloading https://files.pythonhosted.org/packages/ea/cd/35485615f45f30a510576f1a56d1e0a7ad7bd8ab5ed7cdc600ef7cd06222/asn1crypto-0.24.0-py2.py3-none-any.whl (101kB)
    100% |████████████████████████████████| 102kB 34kB/s 
Requirement already satisfied: enum34; python_version < "3" in /usr/lib/python2.7/site-packages (from cryptography==2.5) (1.0.4)
Requirement already satisfied: pycparser in /usr/lib/python2.7/site-packages (from cffi!=1.11.3,>=1.8->cryptography==2.5) (2.14)
Installing collected packages: cffi, ipaddress, asn1crypto, cryptography
  Found existing installation: cffi 0.8.6
    Uninstalling cffi-0.8.6:
      Successfully uninstalled cffi-0.8.6
  Found existing installation: cryptography 0.8.2
    Uninstalling cryptography-0.8.2:
      Successfully uninstalled cryptography-0.8.2
Successfully installed asn1crypto-0.24.0 cffi-1.11.5 cryptography-2.5 ipaddress-1.0.22

   

      再输入ansbile如果没有报错那就恭喜你搞定了，否则的话还是迭代循环吧。

[root@localhost ~]# ansible
Usage: ansible  [options]

Define and run a single task 'playbook' against a set of hosts

 

3.  ansible简单介绍

    安装好了ansible之后，在/etc/ansible目录下会有三个文件，如下：

[root@localhost ~]# cd /etc/ansible
[root@localhost ansible]# ls
ansible.cfg  hosts  roles

 

 《1》 ansible.cfg

        这个是ansible自身的config文件，默认就这样，我们暂不管。

《2》 hosts

      这里面配置的就是ansible要操控的远程机器，比如我在末尾加上的10.25.59.59 和  10.25.198.96 两台我要分发的机器。

# This is the default ansible 'hosts' file.
#
# It should live in /etc/ansible/hosts
#
#   - Comments begin with the '#' character
#   - Blank lines are ignored
#   - Groups of hosts are delimited by [header] elements
#   - You can enter hostnames or ip addresses
#   - A hostname/ip can be a member of multiple groups

# Ex 1: Ungrouped hosts, specify before any group headers.

## green.example.com
## blue.example.com
## 192.168.100.1
## 192.168.100.10

# Ex 2: A collection of hosts belonging to the 'webservers' group

## [webservers]
## alpha.example.org
## beta.example.org
## 192.168.1.100
## 192.168.1.110

# If you have multiple hosts following a pattern you can specify
# them like this:

## www[001:006].example.com

# Ex 3: A collection of database servers in the 'dbservers' group

## [dbservers]
## 
## db01.intranet.mydomain.net
## db02.intranet.mydomain.net
## 10.25.1.56
## 10.25.1.57

# Here's another example of host ranges, this time there are no
# leading 0s:

## db-[99:101]-node.example.com

[memsql-test]
10.25.59.59
10.25.198.96

 

《3》 roles

      一般来说ansible推荐都是以role模板格式作为playbook来实现非常强大的功能，比如这个地方：https://galaxy.ansible.com/  都是一些供你学习的role模板。

 

4. 编写playbook

《1》 deploy.yaml

---
- hosts: all
  
  remote_user: root

  vars:
    inifile: "memsql-test"
    program: "MemSql.Test"
    workspace: "/var/lib/jenkins/workspace/{{ program }}/MemSql.NetCore/{{ program }}/bin/Release/netcoreapp2.1/publish/" 
  tasks:
    - name: 1. directory publish files
      copy:
        src: "{{ workspace }}"
        dest: "/data/output/{{ program }}"

    - name: 2. copy *.ini file for supervisor
      copy:
        src: "{{ workspace }}/doc/{{ inifile }}.ini"
        dest: /data/supervisor/conf/

    - name: 3. supervisord file
      supervisorctl:
        name: memsql-test
        state: restarted
        supervisorctl_path: /usr/bin/supervisorctl
        config: /data/supervisor/supervisord.conf

 

这个配置文件大概是什么意思呢？

《1》 hosts： memsql-test    表示要操作memsql-test组下的所有主机，还记得你在hosts中配置的ip地址吗？

《2》 remote_user:  root     告诉你远程操控的角色是什么。

《3》 vars     定义一些变量，方便后面少些一些重复的代码。

《4》 tasks：   定义一些按顺序执行的Action

《5》 name： 某一个action动作的描述

          copy： copy命令，这个算是ansible的模块了，具体参见：https://docs.ansible.com/ansible/latest/modules/copy_module.html

          supervisorctl： 这个ansible集成了supervisor，挺好的，具体参见：https://docs.ansible.com/ansible/latest/modules/supervisorctl_module.html 

           

三：ansible 和 jenkins 集成

        在我的doc文件夹下有三个文件，方便jenkins在脚本执行的时候获取相关文件。

《1》 deploy.yaml      这个就是上面介绍的

《2》 entrypoint.sh   这个脚本是准备copy到jenkins的command命令框中

cd ./MemSql.NetCore/MemSql.Test \
&& dotnet publish -c Release \
&& ansible-playbook ./doc/deploy.yaml

《3》 memsql-test.ini   如果看过上一篇，那这个就不介绍了

[program:memsql-test]
command=/usr/bin/dotnet /data/output/MemSql.Test/MemSql.Test.dll
autostart=false
autorestart=true
stdout_logfile=/data/output/MemSql.Test/1.log 　　

《4》 最后就是一个简单的program.cs

 class Program
    {
        static void Main(string[] args)
        {
            var cts = new CancellationTokenSource();

            var bgtask = Task.Run(() =>
            {
                for (int i = 0; i < int.MaxValue; i++)
                {
                    Log.Info($"当前index={i}, 时间为:{DateTime.Now}");

                    Thread.Sleep(new Random().Next(1000, 3000));
                }
            });

            Log.Info($"{DateTime.Now} Test 后端服务程序正常启动！");
            Console.WriteLine($"{DateTime.Now} Test 后端服务程序正常启动！");

            bgtask.Wait();
        }
    }

 

《5》 在jenkins中执行一下， 当然你也可以使用jenkins的ansible插件，简单的话用脚本也可以。

 

点击jenkins构建之后，就可以看到console界面中 playbook的脚本在跑了。

 

       然后你到两台机器都验证一起，process可是起来了。

[root@10-25-59-59 ~]# ps -ef | grep dotnet
root     22949  1371  0 11:28 ?        00:00:01 /usr/bin/dotnet /data/output/MemSql.Test/MemSql.Test.dll
root     26337 18477  0 11:45 pts/0    00:00:00 grep --color=auto dotnet
[root@10-25-198-96 ~]# ps -ef | grep dotnet
root      4831 21660  6 11:45 ?        00:00:00 /usr/bin/dotnet /data/output/MemSql.Test/MemSql.Test.dll

 

    好了，本篇就说到这里，希望对你有帮助。