saltstack之return与job与ssh！！！

SaltStack组件之return

eturn组件可以理解为SaltStack系统对执行Minion返回后的数据进行存储或者返回给其他程序，它支持多种存储方式，比如用MySQL、MongoDB、Redis、Memcache等，通过return我们可以对SaltStack的每次操作进行记录，对以后日志审计提供了数据来源。目前官方已经支持30种return数据存储与接口，我们可以很方便的配置与使用它。当然也支持自己定义的return，自定义的return需由python来编写。在选择和配置好要使用的return后，只需在salt命令后面指定return即可。

查看所有return列表
[root@master ~]# salt '*' sys.list_returners
laolin:
    - carbon
    - couchdb
    - elasticsearch
    - etcd
    - highstate
    - local
    - local_cache
    - mattermost
    - multi_returner
    - pushover
    - rawfile_json
    - slack
    - slack_webhook
    - smtp
    - splunk
    - sqlite3
    - syslog
    - telegram
master:
    - carbon
    - couchdb
    - elasticsearch
    - etcd
    - highstate
    - local
    - local_cache
    - mattermost
    - multi_returner
    - pushover
    - rawfile_json
    - slack
    - slack_webhook
    - smtp
    - splunk
    - sqlite3
    - syslog
    - telegram

1. return流程

return是在Master端触发任务，然后Minion接受处理任务后直接与return存储服务器建立连接，然后把数据return存到存储服务器。关于这点一定要注意，因为此过程都是Minion端操作存储服务器，所以要确保Minion端的配置跟依赖包是正确的，这意味着我们将必须在每个Minion上安装指定的return方式依赖包，假如使用Mysql作为return存储方式，那么我们将在每台Minion上安装python-mysql模块。

1.1 在minion上安装Mysql-python模块

[root@laolin ~]# dnf -y install python3-PyMySQL
上次元数据过期检查：16:23:17 前，执行于 2021年07月08日 星期四 17时03分23秒。
依赖关系解决。
================================================================================================================================
 软件包                          架构              版本                                              仓库                  大小
================================================================================================================================
安装:
 python3-PyMySQL                 noarch            0.10.1-2.module_el8.5.0+761+faacb0fb              appstream             98 k
安装依赖关系:
 python3-cffi                    x86_64            1.11.5-5.el8                                      baseos               237 k
 python3-cryptography            x86_64            3.2.1-5.el8                                       baseos               559 k
 python3-pycparser               noarch            2.14-14.el8                                       baseos               109 k

1.2 部署一台mysql服务器用作存储服务器

[root@mysql ~]# dnf -y install mariadb
CentOS Stream 8 - AppStream                                                                     5.8 MB/s |  11 MB     00:01    
CentOS Stream 8 - BaseOS                                                                        990 kB/s | 8.1 MB     00:08    
CentOS Stream 8 - Extras                                                                         16 kB/s |  14 kB     00:00    
依赖关系解决。
================================================================================================================================
 软件包                              架构            版本                                              仓库                大小
================================================================================================================================
安装:
 mariadb                             x86_64          3:10.3.28-1.module_el8.3.0+757+d382997d           appstream          6.0 M
安装依赖关系:
 mariadb-common                      x86_64          3:10.3.28-1.module_el8.3.0+757+d382997d           appstream           64 k
 mariadb-connector-c                 x86_64          3.1.11-2.el8_3                                    appstream          200 k
 mariadb-connector-c-config          noarch          3.1.11-2.el8_3                                    appstream           15 k
启用模块流:
 mariadb                                             10.3                                                                      

事务概要
================================================================================================================================
安装  4 软件包

1.3 在 mysql 里面创建数据库和表！

MariaDB [(none)]> CREATE DATABASE  `salt`
    ->       DEFAULT CHARACTER SET utf8
    ->       DEFAULT COLLATE utf8_general_ci;
Query OK, 1 row affected (0.001 sec)

MariaDB [(none)]> USE `salt`;
Database changed

MariaDB [salt]> DROP TABLE IF EXISTS `jids`;
Query OK, 0 rows affected, 1 warning (0.001 sec)

MariaDB [salt]> CREATE TABLE `jids` (
    ->        `jid` varchar(255) NOT NULL,
    ->        `load` mediumtext NOT NULL,
    ->        UNIQUE KEY `jid` (`jid`)
    ->      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
Query OK, 0 rows affected (0.005 sec)

MariaDB [salt]> DROP TABLE IF EXISTS `salt_returns`;
Query OK, 0 rows affected, 1 warning (0.000 sec)

MariaDB [salt]> CREATE TABLE `salt_returns` (
    ->        `fun` varchar(50) NOT NULL,
    ->        `jid` varchar(255) NOT NULL,
    ->        `return` mediumtext NOT NULL,
    ->        `id` varchar(255) NOT NULL,
    ->        `success` varchar(10) NOT NULL,
    ->        `full_ret` mediumtext NOT NULL,
    ->        `alter_time` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    ->        KEY `id` (`id`),
    ->        KEY `jid` (`jid`),
    ->        KEY `fun` (`fun`)
    ->      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
Query OK, 0 rows affected (0.007 sec)

MariaDB [salt]> DROP TABLE IF EXISTS `salt_events`;
Query OK, 0 rows affected, 1 warning (0.000 sec)

MariaDB [salt]> CREATE TABLE `salt_events` (
    ->      `id` BIGINT NOT NULL AUTO_INCREMENT,
    ->      `tag` varchar(255) NOT NULL,
    ->      `data` mediumtext NOT NULL,
    ->      `alter_time` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    ->      `master_id` varchar(255) NOT NULL,
    ->      PRIMARY KEY (`id`),
    ->      KEY `tag` (`tag`)
    ->      ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
Query OK, 0 rows affected (0.006 sec)

MariaDB [salt]> grant all on salt.* to salt@'192.168.160.%' identified by 'salt';
Query OK, 0 rows affected (0.001 sec)

MariaDB [salt]> flush privileges;
Query OK, 0 rows affected (0.001 sec)

1.4 配置minion！

[root@laolin ~]# vim /etc/salt/minion
mysql.host: '192.168.160.100'
mysql.user: 'salt'
mysql.pass: 'salt'
mysql.db: 'salt'
mysql.port: 3306
[root@laolin ~]# systemctl restart salt-minion

1.5 在master上测试！！！

[root@master ~]# salt 'laolin' test.ping --return mysql
laolin:
    True

1.6 返回数据库中查看！！！

MariaDB [salt]> select * from salt_returns\G
*************************** 1. row ***************************
       fun: test.ping
       jid: 20210709021205309777
    return: true
        id: laolin
   success: 1
  full_ret: {"success": true, "return": true, "retcode": 0, "jid": "20210709021205309777", "fun": "test.ping", "fun_args": [], "id": "laolin"}
alter_time: 2021-07-08 22:12:05

2. job cache流程

return时是由Minion直接与存储服务器进行交互，因此需要在每台Minion上安装指定的存储方式的模块，比如python-mysql，那么我们能否直接在Master上就把返回的结果给存储到存储服务器呢？

答案是肯定的，这种方式被称作 job cache。意思是当Minion将结果返回给Master后，由Master将结果给缓存在本地，然后将缓存的结果给存储到指定的存储服务器，比如存储到mysql中。

2.1 开启master端的master_job_cache

[root@master ~]# yum -y install python3-PyMySQL
上次元数据过期检查：0:20:11 前，执行于 2021年07月09日 星期五 09时54分11秒。
依赖关系解决。
================================================================================================================================
 软件包                          架构              版本                                              仓库                  大小
================================================================================================================================
安装:
 python3-PyMySQL                 noarch            0.10.1-2.module_el8.5.0+761+faacb0fb              appstream             98 k
安装依赖关系:
 python3-cffi                    x86_64            1.11.5-5.el8                                      baseos               237 k
 python3-cryptography            x86_64            3.2.1-5.el8                                       baseos               559 k
 python3-pycparser               noarch            2.14-14.el8                                       baseos               109 k


[root@master ~]# vim /etc/salt/master
master_job_cache: mysql

mysql.host: '192.168.160.100'
mysql.user: 'salt'
mysql.pass: 'salt'
mysql.db: 'salt'
mysql.port: 3306

2.2 在数据库服务器中清空表内容

MariaDB [salt]> delete from salt.salt_returns;
Query OK, 2 rows affected (0.003 sec)

MariaDB [salt]> select * from salt.salt_returns;
Empty set (0.000 sec)

2.3 在master上再次测试！！

[root@master ~]# salt 'laolin' test.ping
laolin:
    True
[root@master ~]# salt 'laolin' cmd.run 'date'
laolin:
    Fri Jul  9 10:23:30 CST 2021

2.4 查询数据库！

MariaDB [salt]> select * from salt.salt_returns\G
*************************** 1. row ***************************
       fun: test.ping
       jid: 20210709022100974625
    return: true
        id: laolin
   success: 1
  full_ret: {"cmd": "_return", "id": "laolin", "success": true, "return": true, "retcode": 0, "jid": "20210709022100974625", "fun": "test.ping", "fun_args": [], "_stamp": "2021-07-09T02:21:01.244928"}
alter_time: 2021-07-08 22:21:01
1 row in set (0.001 sec)

*************************** 4. row ***************************
       fun: cmd.run
       jid: 20210709022330441621
    return: "Fri Jul  9 10:23:30 CST 2021"
        id: laolin
   success: 1
  full_ret: {"cmd": "_return", "id": "laolin", "success": true, "return": "Fri Jul  9 10:23:30 CST 2021", "retcode": 0, "jid": "20210709022330441621", "fun": "cmd.run", "fun_args": ["date"], "_stamp": "2021-07-09T02:23:30.679350"}
alter_time: 2021-07-08 22:23:30
4 rows in set (0.001 sec)

3. job管理

3.1 获取任务的jid

[root@master ~]# salt '*' cmd.run 'uptime' -v
Executing job with jid 20210709022516935707
-------------------------------------------

master:
     10:25:17 up  1:10,  3 users,  load average: 0.28, 0.53, 0.47
laolin:
     10:25:17 up  1:10,  3 users,  load average: 0.17, 0.22, 0.26


[root@master ~]# salt-run jobs.lookup_jid 20210709022516935707
laolin:
     10:25:17 up  1:10,  3 users,  load average: 0.17, 0.22, 0.26
master:
     10:25:17 up  1:10,  3 users,  load average: 0.28, 0.53, 0.47

4. SaltStack之salt-ssh

salt-ssh的特点:

1. 远程系统需要Python支持，除非使用-r选项发送原始ssh命令
2. salt-ssh是一个软件包，需安装之后才能使用，命令本身也是salt-ssh
3. salt-ssh不会取代标准的Salt通信系统，它只是提供了一个基于SSH的替代方案，不需要ZeroMQ和agent

由于所有与Salt SSH的通信都是通过SSH执行的，因此它比使用ZeroMQ的标准Salt慢得多

salt-ssh有两种方式实现远程管理，一种是在配置文件中记录所有客户端的信息，诸如 IP
地址、端口号、用户名、密码以及是否支持sudo等；另一种是使用密钥实现远程管理，不需要输入密码。

4.1 salt-ssh管理

master 上安装 salt-ssh

[root@master ~]# yum -y install salt-ssh
上次元数据过期检查：0:35:50 前，执行于 2021年07月09日 星期五 09时54分11秒。
软件包 salt-ssh-3000.9-1.el8.noarch 已安装。
依赖关系解决。
无需任何处理。
完毕！

4.2 通过使用用户名密码的SSH实现远程管理

root@master ~]# vim /etc/salt/roster
mysql:
  host: 192.168.160.100
  user: root
  passwd: 7
~                 

第一次访问时需要输入 yes/no ，但是 saltstack 是不支持交互式操作的，所以为了解决这个问题，我们需要对其进行设置，让系统不进行主机验证。

[root@master ~]# vim ~/.ssh/config
[root@master ~]# cat ~/.ssh/config
StrictHostKeyChecking no

4.3 测试！！！

[root@master ~]# salt-ssh '*' test.ping
mysql:
    True

4.4 通过salt-ssh初始化系统安装salt-minion

[root@master ~]# mkdir -p /srv/salt/base/{repo,files}
[root@master yum.repos.d]# cp /etc/yum.repos.d/salt.repo /srv/salt/base/repo/salt.repo
[root@master yum.repos.d]# cp /etc/salt/minion /srv/salt/base/files/
[root@master yum.repos.d]# vim /srv/salt/base/repo.sls
[root@master yum.repos.d]# cat /srv/salt/base/repo.sls
salt_repo:
  file.managed:
    - name: /etc/yum.repos.d/salt.repo
    - source: salt://repo/salt.repo
    - user: root
    - group: root
    - mode: 0644
[root@master yum.repos.d]# vim /srv/salt/base/minion.sls
[root@master yum.repos.d]# cat /srv/salt/base/minion.sls
minion_install:
  pkg.installed:
    - name: salt-minion

minion_conf:
  file.managed:
    - name: /etc/salt/minion
    - source: salt://files/minion
    - user: root
    - group: root
    - mode: 644
    - template: jinja
    - default:
      ID: {{ grains['ipv4'] [1] }}
    - require:
      - pkg: minion_install

minion_service:
  service.running:
    - name: salt-minion
    - enable: True
    - start: True
    - watch:
       - file: /etc/salt/minion

[root@master salt]# salt-ssh '*' state.sls repo
mysql:
----------
          ID: salt_repo
    Function: file.managed
        Name: /etc/yum.repos.d/salt.repo
      Result: True
     Comment: File /etc/yum.repos.d/salt.repo updated
     Started: 22:59:37.513904
    Duration: 83.461 ms
     Changes:   
              ----------
              diff:
                  New file
              mode:
                  0644

Summary for mysql
------------
Succeeded: 1 (changed=1)
Failed:    0
------------
Total states run:     1
Total run time:  83.461 ms
[root@master salt]# salt-ssh '*' state.sls minion

测试！！

[root@master ~]# salt-key -L
Accepted Keys:
master
laolin
Denied Keys:
Unaccepted Keys:
mysql
Rejected Keys:
[root@master ~]# salt-key -ya mysql
[root@master ~]# salt '*' test.ping
master:
    True
laolin:
    True
mysql:
    True