目录

版本控制信息... 1

目录I

1SaltStack简介... 1

2SaltStack安装... 1

2.1测试环境... 1

2.2安装SALTSTACK.. 1

2.2.1SaltMaster端安装... 1

2.2.2SaltMinion端安装... 1

3SaltStack配置... 1

3.1理解YAML.. 1

3.2常用YAML关键字说明... 1

3.2.1unless1

3.2.2include1

3.2.3require1

3.2.4require_in1

3.2.5watch2

3.3SALTMASTER端配置... 2

3.4SALTMINION端配置... 3

3.5签发证书... 4

3.6MASTER端与MINION端的通信测试... 4

4SaltStack基本使用... 5

4.1模块使用相关... 5

4.1.1查看Minion的所有模块... 5

4.1.2查看Minion指定模块下的函数... 5

4.1.3查看Minion模块的使用方法... 6

4.2STATES使用相关... 7

4.2.1查看Minion的所有states列表... 7

4.2.2查看指定States模块下的函数... 8

4.2.3查看指定States模块的使用方法... 9

5SaltStack常用模块使用... 9

5.1CMD模块... 9

5.1.1run函数... 9

5.2PKG模块... 9

5.2.1installed函数... 9

5.3SERVICE模块... 9

5.4FILE模块... 9

5.4.1managed函数... 10

5.4.2append函数... 10

5.5STATE模块... 10

6SaltStack配置管理实例... 10

6.1安装基础软件包... 11

6.2安装JDK.. 11

6.3安装TOMCAT11

6.4安装NGINX.. 12

6.5安装MYSQL.. 12

6.6安装PHP15

6.7安装REDIS15

6.8安装OPENSTACK.. 16

1     SaltStack简介

2     SaltStack安装

2.1   测试环境

主机名


操作系统


IP地址


备注


master01.lavenliu.com


CentOS 6.5 64


192.168.20.134


Salt主控端


minion01.lavenliu.com


192.168.20.135


Salt被控端


minion02.lavenliu.com


192.168.20.136


Salt被控端


 

3台机器上分别安装EPEL源,

rpm -ivh http://mirrors.ustc.edu.cn/fedora/epel//6/x86_64/epel-release-6-8.noarch.rpm

2.2   安装SaltStack

2.2.1  SaltMaster端安装

yum install -y salt-master

2.2.2  SaltMinion端安装

yum install -y salt-minion

3     SaltStack配置

3.1   理解YAML

SLS文件的默认渲染器是YAML渲染器。书写SLS文件只有简单的三条规则。

3.2   常用YAML关键字说明

3.2.1  unless

3.2.2  include

3.2.3  require

我依赖哪个state

3.2.4  require_in

哪个state依赖我

3.2.5  watch

3.3   SaltMaster端配置

Salt主控端的配置如下:

[root@master01 ~]# egrep -v "^#|^$" /etc/salt/master

interface:192.168.20.134

file_roots:

  base:

    - /etc/salt/states

  prod:

- /etc/salt/states/prod

 

Salt Master常用的配置说明:


+ interface: 指定bind的地址(默认为0.0.0.0)

+ publish_port: 指定发布端口(默认为4506)

+ ret_port: 指定结果返回端口,与minion配置文件中的master_port对应(默认为4506)

+ user: 指定master进程的运行用户,如果调整,则需要调整部分目录的权限(默认为root)

+ timeout: 指定超时时间,如果minion规模庞大或网络状况不稳定,建议增大该值(默认5s)

+ keep_jobs: 默认情况下,minion会将执行结果返回给mastermaster会缓存到本地的cachedir目录,该参数指定缓存多长时间,以供查看之前

  的执行结果,会占用磁盘空间(默认为24h)

+ file_recv: 是否允许minion传送文件到master(默认False)

+ file_roots:

+ pillar_roots: 指定pillar目录,默认为:

+ log_level: 执行日志级别,支持的日志级别有"garbage", "trace", "debug", "info", "warning", "error", "critical" (默认warning)

 

接下来创建我们指定的目录,在主控端进行操作:


mkdir -p /etc/salt/states/{init,prod}

 

修改完毕,启动Salt Master并加入开机启动,操作如下:


/etc/init.d/salt-master start

chkconfig salt-master on

 

启动完毕,进行salt的进程的验证,是否启动成功,


[root@master01 ~]# ps -ef |grep salt |grep -v grep

root       2028      1  0 11:20 ?       00:00:00 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2029   2028  0 11:20 ?       00:00:09 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2030   2028  0 11:20 ?       00:00:00 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2033   2028  0 11:20 ?       00:00:00 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2034   2028  0 11:20 ?       00:00:00 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2037   2034  0 11:20 ?       00:00:01 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2038   2034  0 11:20 ?       00:00:01 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2039   2034  0 11:20 ?       00:00:01 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2040   2034  0 11:20 ?       00:00:01 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2041   2034  0 11:20 ?       00:00:01 /usr/bin/python2.6 /usr/bin/salt-master -d

root       2042   2034  0 11:20 ?        00:00:00 /usr/bin/python2.6 /usr/bin/salt-master -d

 

检查是否加入开机自启动,


[root@master01 ~]# chkconfig --list |grep salt

salt-master       0:off  1:off  2:on   3:on   4:on   5:on   6:off

3.4   SaltMinion端配置

被控端的配置很简单,只需要修改一处配置就可以让主控端与被控端进行正常的通信。在minion01minion02上做如下的配置,如下:

[root@minion01 ~]# egrep -v "^#|^$" /etc/salt/minion

master: master01.lavenliu.com

[root@minion02 ~]# egrep -v "^#|^$" /etc/salt/minion

master: master01.lavenliu.com


这里我们使用了Salt主控端的主机名而非主控端的IP地址,主要是我们这里已经配置了DNS解析,所以使用了主机名。如果我们没有配置DNS的域名解析服务,我们改写master: <salt_master_ip>的形式来使用。


 

Salt Minion常用的配置说明:

+ master:指定master主机(默认为salt)

+ master_port: 指定认证和执行结果发送到master的哪个端口,与master配置文件中的ret_port对应(默认为4506)

+ id: 指定本minion的标识,salt内部使用id作为标识(默认为主机名)

+ user: 指定运行minion的用户,用于安装包、启动服务等操作需要特权用户,推荐使用root(默认root)

+ cache_jobs: minion是否

 

启动Salt Minion并加入开机启动,在minion01minion02上进行操作


/etc/init.d/salt-minion start

chkconfig salt-minion on

 

接下来验证Salt Minion是否启动成功,


ps -ef |grep salt |grep -v grep

root       1655      1  0 11:56 ?       00:00:03 /usr/bin/python2.6 /usr/bin/salt-minion -d

chkconfig --list |grep salt

salt-minion       0:off  1:off  2:on   3:on   4:on   5:on   6:off

3.5    签发证书


SaltMasterMinion端第一次启动时都会生成证书,而Master端在生成证书之前,还会创建一个CA,并且自己将证书签发。而Minion端默认会向Master端发起一个证书请求让Master端签发,以建立信任关系。


 

在主控端使用salt-key来查看Minion端的证书申请请求,


[root@master01 states]# salt-key

Accepted Keys:

Denied Keys:

Unaccepted Keys:

minion01.lavenliu.com


minion02.lavenliu.com


Rejected Keys:

接受Minion端的申请,


salt-key -A

3.6    Master端与Minion端的通信测试


以上设置完毕,接下来验证MasterMinion端是否可以正常通信,使用test.ping进行验证,操作如下:


[root@master01 states]# salt '*' test.ping

minion01.lavenliu.com:

    True


minion02.lavenliu.com:

True


返回两个True时,说明我们的Salt配置已成功。在此基础上,我们就可以做更多的配置管理了,在接下来的章节中进行说明。


4     SaltStack基本使用


我们日常简单的执行命令、查看安装包情况、查看服务运行状态情况等工作都是通过SaltStack的模块实现的。当我们安装完毕MasterMinion后,系统默认会安装很多模块,接下来具体看看怎么使用这些模块。


4.1    模块使用相关


4.1.1  查看Minion的所有模块


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.list_modules

minion01.lavenliu.com:

    - acl

    - aliases

    - alternatives

    - apache

    - archive

    - artifactory

    - blockdev

    - btrfs

    - buildout

    - cloud

- cmd

此处省略很多行

    - timezone

    - user

    - vbox_guest

    - virtualenv

    - webutil

    - xfs

4.1.2  查看Minion指定模块下的函数


接下来,我们查看cmd模块有哪些方法,


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.list_functions cmd

minion01.lavenliu.com:

    - cmd.exec_code

    - cmd.exec_code_all

    - cmd.has_exec

    - cmd.retcode

    - cmd.run

    - cmd.run_all

    - cmd.run_chroot

    - cmd.run_stderr

    - cmd.run_stdout

    - cmd.script

    - cmd.script_retcode

    - cmd.shell

    - cmd.shells

    - cmd.tty

    - cmd.which

    - cmd.which_bin

4.1.3  查看Minion模块的使用方法


查看cmd模块的使用方法,


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.doc cmd

'cmd.exec_code:'

 

    Pass in two strings, the first naming the executable language, aka -

    python2, python3, ruby, perl, lua, etc. the second string containing

    the code you wish to execute. The stdout will be returned.

 

    CLI Example:

 

        salt '*' cmd.exec_code ruby 'puts "cheese"'

 

 

'cmd.exec_code_all:'

 

    Pass in two strings, the first naming the executable language, aka -

    python2, python3, ruby, perl, lua, etc. the second string containing

    the code you wish to execute. All cmd artifacts (stdout, stderr, retcode, pid)

    will be returned.

 

CLI Example:

此处省略很多行

 

以上输出的信息很多,我们可以只查看某个模块下的某个函数的使用方法。比如我们这里要查看cmd模块下的run方法的使用,操作如下,


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.doc cmd.run

'cmd.run:'

 

    Execute the passed command and return the output as a string

 

    Note that ``env`` represents the environment variables for the command, and

    should be formatted as a dict, or a YAML string which resolves to a dict.

 

    Warning:

 

        This function does not process commands through a shell

       unless the python_shell flag is set to True. This means that any

       shell-specific functionality such as 'echo' or the use of pipes,

       redirection or &&, should either be migrated to cmd.shell or

        have the python_shell=True flag set here.

 

        The use of python_shell=True means that the shell will accept _any_ input

       including potentially malicious commands such as 'good_command;rm -rf /'.

        Be absolutely certain that you have sanitized your input prior to using

        python_shell=True

 

    CLI Example:

此处省略很多行

4.2    States使用相关


StatesSaltStack中的配置管理语言。比如我们在日常配置管理时需要编写大量的States文件,具体要安装一个软件包,然后管理其服务配置文件,最后保证该服务正常运行。针对上述步骤我们要编写一些States SLS文件来描述和实现上述功能。


4.2.1  查看Minion的所有states列表


要查看Minion端所支持的states有哪些,操作如下:


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.list_state_modules

minion01.lavenliu.com:

    - acl

    - alias

    - alternatives

    - apache

    - archive

    - artifactory

    - blockdev

    - buildout

    - cloud

    - cmd

    - composer

    - cron

- disk

此处省略很多行

4.2.2  查看指定States模块下的函数


比如我们要查看与file states相关的函数,操作如下:


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.list_state_functions file

minion01.lavenliu.com:

    - file.absent

    - file.accumulated

    - file.append

    - file.blockreplace

    - file.comment

    - file.copy

    - file.directory

    - file.exists

    - file.managed

    - file.missing

    - file.mknod

    - file.mod_run_check_cmd

    - file.patch

    - file.prepend

    - file.recurse

    - file.rename

    - file.replace

    - file.serialize

    - file.symlink

    - file.touch

- file.uncomment

4.2.3  查看指定States模块的使用方法


在上一小节,我们列出了很多与States相关的模块,具体如何使用它们呢?我们可以在命令行查看其帮助信息。比如我们要查看file相关的使用帮助,可以操作如下,


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.state_doc file

此处省略无数行

由于上面输出的内容较多,故未列出。如何使用fileappend函数呢?操作如下,


[root@master01 ~]# salt 'minion01.lavenliu.com' sys.state_doc file.append

此处省略N

5     SaltStack常用模块使用


5.1    cmd模块


5.1.1  run函数


1
2
3
4
5
6
7
8
9
10
11
12
13
14
[root@master01
states]# salt '*' cmd.run "hostname"
minion02.lavenliu.com:
    minion02.lavenliu.com
minion01.lavenliu.com:
    minion01.lavenliu.com
[root@master01
states]# salt '*' cmd.run "hostname -I"
minion01.lavenliu.com:
    192.168.20.135
192.168.19.132
minion02.lavenliu.com:
    192.168.20.136
192.168.19.133


5.2    pkg模块


5.2.1  installed函数


salt '*' pkg.installed name=vim

5.3    service模块


5.4    file模块


5.4.1  managed函数


5.4.2  append函数


5.5    state模块


6     SaltStack配置管理实例

文件目录结构为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 [root@master01 states]# tree
.
├── init
│   ├──files
│   │  └── vimrc
│   ├──pkg.sls
│   ├──test.sls
│   └──vim.sls
├── prod
│   ├──jdk
│   │  ├── files
│   │  │   └── jdk-8u65-linux-x64.tar.gz
│   │  └── install.sls
│   ├──keepalived
│   │  └── files
│   │       └── keepalived-1.2.16.tar.gz
│   ├──libevent
│   │  ├── files
│   │  │   └── libevent-2.0.22-stable.tar.gz
│   │  └── install.sls
│   ├──memcached
│   │  ├── files
│   │  │   └── memcached-1.4.25.tar.gz
│   │  ├── install.sls
│   │  └── service.sls
│   ├──nginx
│   │  └── files
│   └──tomcat
│      ├── files
│      │   └── apache-tomcat-8.0.28.tar.gz
│      └── install.sls
└── top.sls
  
15 directories,
15 files

6.1   安装基础软件包

6.2   安装JDK

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
[root@master01
states]# cat prod/jdk/install.sls 
jdk-install:
  file.managed:
    - name: /usr/local/src/jdk-8u65-linux-x64.tar.gz
    source: salt://prod/jdk/files/jdk-8u65-linux-x64.tar.gz
    - user: root
    - group: root
    - mode: 644
  cmd.run:
    - name: cd /usr/local/src
&& tar -xf jdk-8u65-linux-x64.tar.gz && mv jdk1.8.0_65 jdk
&& chown -R root:root jdk
    - unless: test -d
/usr/local/jdk
  
/etc/profile:
  file.append:
    - text:
      export
JAVA_HOME=/usr/local/jdk
      export
JRE_HOME=${JAVA_HOME}/jre
      -
CLASS_PATH=${JAVA_HOME}/lib:${JRE_HOME}/lib
      -
PATH=$PATH:$JAVA_HOME/bin

如何使用,


1
salt '*' state.sls prod.jdk.install

6.3   安装Tomcat

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[root@master01
states]# cat prod/tomcat/install.sls 
include:
  - prod.jdk
  
tomcat-install:
  file.managed:
    - name: /usr/local/src/apache-tomcat-8.0.28.tar.gz
    source: salt://prod/tomcat/files/apache-tomcat-8.0.28.tar.gz
    - user: root
    - group: root
    - mode: 644
  cmd.run:
    - name: cd /usr/local/src
&& tar -xf apache-tomcat-8.0.28.tar.gz && ln -s
apache-tomcat-8.0.28 tomcat && chown -R root:root apache-tomcat-8.0.28
- unless: test -d /usr/local/apache-tomcat-8.0.28

如何使用,


salt '*' state.sls prod.tomcat.install

6.4    安装Nginx


6.5    安装MySQL


这里使用源码的方式进行编译安装。安装配置的大致流程是:


  1. 1.      首先安装MySQL的依赖包;


  2. 2.      创建MySQL用户并设置UIDGID601


  3. 3.      开始编译安装MySQL


  4. 4.      创建MySQL的套接字存放的目录;


  5. 5.      设置MySQL环境变量,以便在命令行直接使用MySQL相关的命令行工具;


  6. 6.      初始化MySQL数据库;


  7. 7.      设置MySQL的启动脚本;


  8. 8.      MySQL加入开机自启动;


  9. 9.      设置MySQL安装目录的权限为mysql用户及组。


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
[root@master01
mysql]# cat install.sls 
dependency-install:
  pkg.installed:
    - names:
      - ncurses-devel
      - libaio-devel
      - cmake
  
mysql:
  user.present:
    - fullname: MySQL Server
    - shell: /sbin/nologin
    - createhome: false
    - uid: 601
    - gid: 601
  
mysql-install:
  file.managed:
    - name:
/usr/local/src/mysql-5.5.32.tar.gz
    source:
salt://prod/mysql/files/mysql-5.5.32.tar.gz
    - user: root
    - group: root
    - mode: 644
  cmd.run:
    - name: cd /usr/local/src
&& tar -xf mysql-5.5.32.tar.gz && cd mysql-5.5.32 &&
cmake . -DCMAKE_INSTALL_PREFIX=/application/mysql-5.5.32
-DMYSQL_DATADIR=/application/mysql-5.5.32/data
-DMYSQL_UNIX_ADDR=/application/mysql-5.5.32/sock/mysql.sock
-DDEFAULT_CHARSET=utf8 -DDEFAULT_COLLATION=utf8_general_ci
-DEXTRA_CHARSETS=gbk,gb2312,utf8,ascii -DENABLED_LOCAL_INFILE=ON
-DWITH_INNOBASE_STORAGE_ENGINE=1 -DWITH_FEDERATED_STORAGE_ENGINE=1
-DWITH_BLACKHOLE_STORAGE_ENGINE=1 -DWITHOUT_EXAMPLE_STORAGE_ENGINE=1
-DWITHOUT_PARTITION_STORAGE_ENGINE=1 -DWITH_FAST_MUTEXES=1 -DWITH_ZLIB=bundled
-DENABLED_LOCAL_INFILE=1 -DWITH_READLINE=1 -DWITH_EMBEDDED_SERVER=1
-DWITH_DEBUG=0 && make && make install && ln -s
/application/mysql-5.5.32 /application/mysql
    - unless: test -d
/application/mysql-5.5.32
    - require:
      - pkg:
dependency-install
      file:
mysql-install
  
/application/mysql-5.5.32/sock:
  file.directory:
    - user: mysql
    - group: mysql
    - dir_mode: 755
  require:
    - user: mysql
    - cmd: mysql-install
  
setup-mysql-env:
  file.append:
  
install-mysql-db:
  cmd.run:
    - name: sh
/application/mysql-5.5.32/scripts/mysql_install_db
--basedir=/application/mysql-5.5.32 --datadir=/application/mysql-5.5.32/data
    - require:
      - cmd:
mysql-install
  
init-mysql:
  file.managed:
    - name: /etc/init.d/mysqld
    source:
/application/mysql-5.5.32/support-files/mysql.server
    - user: root
    - group: root
    - mode: 755
  
chkconfig-on-mysql:
  cmd.run:
    - name: chkconfig --add
mysqld
    - unless: chkconfig --list |
grep mysqld
    - require:
      file:
/etc/init.d/mysqld
  
/application/mysql-5.5.32:
  file.directory:
    - user: mysql
    - group: mysql
    - dir_mode: 755
    - recurse:
      - user
      - group
      - mode
  require:
    - user: mysql
- cmd: mysql-install


如何执行呢?


salt 'minion02.lavenliu.com' state.sls prod.mysql.install

6.6    安装PHP


6.7    安装Redis


这里使用YUM的方式进行安装RedisSLS文件如下:


1
2
3
4
5
6
7
8
9
10
11
12
13
[root@master01
redis]# pwd
/etc/salt/states/prod/redis
# 目录结构为
[root@master01
redis]# tree
.
├── files
│   └──redis.conf
└── server.sls
  
1
directory, 2 files

 

server.sls文件的内容为:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
[root@master01
redis]# cat server.sls
redis-server:
  pkg.installed:
    - name: redis
  file.managed:
    - name: /etc/redis.conf
    source:
salt://prod/redis/files/redis.conf
    - user: root
    - group: root
    - mode: 644
  service.running:
    - name: redis
    enable: True
    - reload: True
    watch:
      file:
redis-server

 

redis.conf的配置文件为:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
[root@master01
redis]# egrep -v "(^#|^$)" files/redis.conf
daemonize
yes
pidfile
/var/run/redis/redis.pid
port 6379
bind 0.0.0.0
timeout 0
loglevel
notice
logfile
/var/log/redis/redis.log
databases
16
save 900
1
save 300
10
save 60
10000
rdbcompression
yes
dbfilename
dump.rdb
dir
/var/lib/redis/
slave-serve-stale-data
yes
appendonly
no
appendfsync
everysec
no-appendfsync-on-rewrite
no
auto-aof-rewrite-percentage
100
auto-aof-rewrite-min-size
64mb
slowlog-log-slower-than
10000
slowlog-max-len
1024
vm-enabled
no
vm-swap-file
/tmp/redis.swap
vm-max-memory
0
vm-page-size
32
vm-pages 134217728
vm-max-threads 4
hash-max-zipmap-entries 512
hash-max-zipmap-value 64
list-max-ziplist-entries 512
list-max-ziplist-value 64
set-max-intset-entries 512
zset-max-ziplist-entries 128
zset-max-ziplist-value 64
activerehashing yes

6.8   安装ELK Stack


6.9    安装OpenStack



后续会继续更新