llcong 发表于 2018-8-1 08:54:22

saltstack的探索-通过官网文档迅速了解salt

http://docs.saltstack.com/en/latest/  

  
SaltStack
  

  
Salt, a new approach to infrastructure management, is easy enough to get running in minutes, scalable enough to manage tens of thousands of servers, and fast enough to communicate with those servers in seconds.
  

  
Salt delivers a dynamic communication bus for infrastructures that can be used for orchestration, remote execution, configuration management and much more.
  

  

  
Getting Started
  
通过实例来迅速了解salt:
  
Official Salt Walkthroughhttp://docs.saltstack.com/en/latest/topics/tutorials/walkthrough.html
  

  

  
1. minion的id
  
minion启动时,能自动生成一个id,也可以在配置文件中手动指定
  

  
2. 接受minion的key之前,安全起见,可以打印minion's public key的指纹
  
salt-key -f minion-id
  

  
On the master:
  

  
# salt-key -f foo.domain.com
  
Unaccepted Keys:
  
foo.domain.com:39:f9:e4:8a:aa:74:8d:52:1a:ec:92:03:82:09:c8:f9
  
On the minion:
  

  
# salt-call key.finger --local
  
local:
  
    39:f9:e4:8a:aa:74:8d:52:1a:ec:92:03:82:09:c8:f9
  
If they match, approve the key with salt-key -a foo.domain.com
  

  

  
3. 第一个命令
  
salt '*' test.ping
  
The * is the target, which specifies all minions.
  

  
test.ping tells the minion to run the test.ping function.
  

  
In the case of test.ping, test refers to a execution module. ping refers to the ping function contained in the aforementioned test module.
  

  
test是一个module,ping是这个module中的一个function
  
类似的,还有一堆的module
  
Module documentation is also available on the web.
  
Full list of builtin execution moduleshttp://docs.saltstack.com/en/latest/ref/modules/all/index.html
  

  

  
4. Helpful Functions to Know
  

  
salt '*' cmd.run 'ls -l /usr'
  
test230:
  
    total 212
  
    dr-xr-xr-x.   2 root root 69632 Feb 11 04:49 bin
  
    drwxr-xr-x.   2 root root4096 Nov12011 etc
  
    drwxr-xr-x.   2 root root4096 Nov12011 games
  
    drwxr-xr-x.66 root root 12288 Feb 11 14:34 include
  
    dr-xr-xr-x.30 root root4096 Oct 14 14:32 lib
  
    dr-xr-xr-x. 107 root root 77824 Feb 11 13:35 lib64
  
    drwxr-xr-x.23 root root 12288 Dec 27 03:12 libexec
  
    drwxr-xr-x.26 root root4096 Feb 11 11:31 local
  
    dr-xr-xr-x.   2 root root 12288 Dec 27 03:12 sbin
  
    drwxr-xr-x. 213 root root4096 Dec 26 14:28 share
  
    drwxr-xr-x.   4 root root4096 Jul 302014 src
  
    lrwxrwxrwx.   1 root root    10 Mar62014 tmp -> ../var/tmp
  

  

  
salt '*' pkg.install ruby
  
test230:
  
    ----------
  
    compat-readline5:
  
      ----------
  
      new:
  
            5.2-17.1.el6
  
      old:
  

  
    ruby:
  
      ----------
  
      new:
  
            1.8.7.374-3.el6_6
  
      old:
  

  
    ruby-libs:
  
      ----------
  
      new:
  
            1.8.7.374-3.el6_6
  
      old:
  

  
# salt '*' cmd.run 'tail /var/log/messages -n 3'
  
test230:
  
    Feb 11 15:10:50 test230 yum: Installed: compat-readline5-5.2-17.1.el6.x86_64
  
    Feb 11 15:10:51 test230 yum: Installed: ruby-libs-1.8.7.374-3.el6_6.x86_64
  
    Feb 11 15:10:52 test230 yum: Installed: ruby-1.8.7.374-3.el6_6.x86_64
  

  

  

  
# salt '*' network.interfaces
  
test230:
  
    ----------
  
    eth0:
  
      ----------
  
      hwaddr:
  
            d4:3d:7e:32:17:d1
  
      inet:
  
            |_
  
            ----------
  
            address:
  
                  192.168.1.230
  
            broadcast:
  
                  192.168.1.255
  
            label:
  
                  eth0
  
            netmask:
  
                  255.255.255.0
  
      inet6:
  
            |_
  
            ----------
  
            address:
  
                  fe80::d63d:7eff:fe32:17d1
  
            prefixlen:
  
                  64
  
      secondary:
  
            |_
  
            ----------
  
            address:
  
                  192.168.1.249
  
            broadcast:
  
                  None
  
            label:
  
                  eth0
  
            netmask:
  
                  255.255.255.0
  
            type:
  
                  inet
  
      up:
  
            True
  
    lo:
  
      ----------
  
      hwaddr:
  
            00:00:00:00:00:00
  
      inet:
  
            |_
  
            ----------
  
            address:
  
                  127.0.0.1
  
            broadcast:
  
                  None
  
            label:
  
                  lo
  
            netmask:
  
                  255.0.0.0
  
            |_
  
            ----------
  
            address:
  
                  192.168.1.130
  
            broadcast:
  
                  192.168.1.130
  
            label:
  
                  lo:0
  
            netmask:
  
                  255.255.255.255
  
      inet6:
  
            |_
  
            ----------
  
            address:
  
                  ::1
  
            prefixlen:
  
                  128
  
      up:
  
            True
  

  

  
5. Grains
  

  
Salt uses a system called Grains to build up static data about minions. This data includes information about the operating system that is running, CPU architecture and much more. The grains system is used throughout Salt to deliver platform data to many components and to users.
  

  
Grains can also be statically set, this makes it easy to assign values to minions for grouping and managing.
  

  
A common practice is to assign grains to minions to specify what the role or roles a minion might be. These static grains can be set in the minion configuration file or via the grains.setval function.
  

  

  

  

  
6. Targeting
  

  
Salt allows for minions to be targeted based on a wide range of criteria. The default targeting system uses globular expressions to match minions, hence if there are minions named larry1, larry2, curly1, and curly2, a glob of larry* will match larry1 and larry2, and a glob of *1 will match larry1 and curly1.
  

  
Many other targeting systems can be used other than globs, these systems include:
  

  
Regular Expressions
  
Target using PCRE-compliant regular expressions
  
Grains
  
Target based on grains data: Targeting with Grains
  
Pillar
  
Target based on pillar data: Targeting with Pillar
  
IP
  
Target based on IP address/subnet/range
  
Compound
  
Create logic to target based on multiple targets: Targeting with Compound
  
Nodegroup
  
Target with nodegroups: Targeting with Nodegroup
  

  

  
7. SALT STATES
  
Salt States, or the State System is the component of Salt made for configuration management.
  

  

  
The state system is built on SLS formulas. These formulas are built out in files on Salt's file server. To make a very basic SLS formula open up a file under /srv/salt named vim.sls. The following state ensures that vim is installed on a system to which that state has been applied.
  
创建一个文件:
  
/srv/salt/vim.sls:
  

  
内容是:
  
# cat vim.sls
  
vim-enhanced:
  
pkg.installed
  

  
Now install vim on the minions by calling the SLS directly:
  
安装vim:
  
# salt '*' state.sls vim
  
test230:
  
----------
  
          ID: vim-enhanced
  
    Function: pkg.installed
  
      Result: True
  
   Comment: Package vim-enhanced is already installed.
  
   Started: 10:05:53.851780
  
    Duration: 1044.131 ms
  
   Changes:
  

  
Summary
  
------------
  
Succeeded: 1
  
Failed:    0
  
------------
  
Total states run:   1
  

  
This command will invoke the state system and run the vim SLS.
  
这个命令会调入state system并执行对应的vim这个sls文件
  

  
Now, to beef up the vim SLS formula, a vimrc can be added:
  
增强一下,增加一个自定义的配置文件
  

  
# cat /srv/salt/vim.sls:
  
vim-enhanced:
  
pkg.installed: []
  

  
/root/.vimrc:
  
file.managed:
  
    - source: salt://files/vim/vimrc
  
    - mode: 644
  
    - uesr: root
  
    - group: root
  

  

  
执行:
  
# salt '*' state.sls vim
  
test230:
  
----------
  
          ID: vim-enhanced
  
    Function: pkg.installed
  
      Result: True
  
   Comment: Package vim-enhanced is already installed.
  
   Started: 10:08:52.457087
  
    Duration: 1041.624 ms
  
   Changes:
  
----------
  
          ID: /root/.vimrc
  
    Function: file.managed
  
      Result: True
  
   Comment: File /root/.vimrc updated
  
   Started: 10:08:53.498852
  
    Duration: 165.523 ms
  
   Changes:
  
            ----------
  
            diff:
  
                  New file
  
            mode:
  
                  0644
  

  
Summary
  
------------
  
Succeeded: 2 (changed=1)
  
Failed:    0
  
------------
  
Total states run:   2
  

  

  

  
8. Adding Some Depth
  
显然在file server的根目录(/srv/salt/)下维护所有的sls文件扩展性不好,让我们增加一点目录层级的深度。
  
Obviously maintaining SLS formulas right in a single directory at the root of the file server will not scale out to reasonably sized deployments. This is why more depth is required.
  
以安装nginx为例
  
Start by making an nginx formula a better way, make an nginx subdirectory and add an init.sls file:
  

  
/srv/salt/nginx/init.sls:
  

  
# cat nginx/init.sls
  
nginx:
  
pkg.installed: []
  
service.running:
  
    - require:
  
      - pkg: nginx
  

  
A few concepts are introduced in this SLS formula.
  

  
First is the service statement which ensures that the nginx service is running.
  
service这个语法,保障nginx服务是running状态的
  
Of course, the nginx service can't be started unless the package is installed -- hence the require statement which sets up a dependency between the two.
  
The require statement makes sure that the required component is executed before and that it results in success.
  
当然,只有安装了nginx服务的包,才能启动nginx服务呀,所以,require语法保障了这样一个依赖关系,确保required的组件在之前已经被执行成功,这样才能去start这个服务。
  

  
Note
  
The require option belongs to a family of options called requisites. Requisites are a powerful component of Salt States, for more information on how requisites work and what is available see: Requisites
  
http://docs.saltstack.com/en/latest/ref/states/requisites.html
  
Also evaluation ordering is available in Salt as well: Ordering States
  
http://docs.saltstack.com/en/latest/ref/states/ordering.html
  

  

  
This new sls formula has a special name -- init.sls. When an SLS formula is named init.sls it inherits the name of the directory path that contains it. This formula can be referenced via the following command:
  
新的sls公司有一个特殊的名称“init.sls”,这样的一个sls会继承当前目录的名称,用这样的一个命令来关联起来,试一试:
  
salt '*' state.sls nginx
  

  
# salt '*' state.sls nginx
  
test230:
  
----------
  
          ID: nginx
  
    Function: pkg.installed
  
      Result: True
  
   Comment: The following packages were installed/updated: nginx.
  
   Started: 11:37:04.182413
  
    Duration: 187110.65 ms
  
   Changes:
  
            ----------
  
            gd:
  
                  ----------
  
                  new:
  
                      2.0.35-11.el6
  
                  old:
  

  
            nginx:
  
                  ----------
  
                  new:
  
                      1.0.15-11.el6
  
                  old:
  

  
            nginx-filesystem:
  
                  ----------
  
                  new:
  
                      1.0.15-11.el6
  
                  old:
  

  
----------
  
          ID: nginx
  
    Function: service.running
  
      Result: True
  
   Comment: The service nginx is already running
  
   Started: 11:40:11.293241
  
    Duration: 59.986 ms
  
   Changes:
  

  
Summary
  
------------
  
Succeeded: 2 (changed=1)
  
Failed:    0
  
------------
  
Total states run:   2
  

  

  

  
Note
  
Reminder!
  

  
Just as one could call the test.ping or disk.usage execution modules, state.sls is simply another execution module. It simply takes the name of an SLS file as an argument.
  

  
就像可以调用test.ping or disk.usage这两个执行模块一样,state.sls也是另一个执行模块,,后边跟着的参数就是要执行的sls配置文件的名称(例如vim,nginx这些)。
  

  

  
现在,继续用子目录来管理,调整下vim的配置:
  
Now that subdirectories can be used, the vim.sls formula can be cleaned up. To make things more flexible, move the vim.sls and vimrc into a new subdirectory called edit and change the vim.sls file to reflect the change:
  

  
/srv/salt/edit/vim.sls:
  

  
vim:
  
pkg.installed
  

  
/etc/vimrc:
  
file.managed:
  
    - source: salt://edit/vimrc
  
    - mode: 644
  
    - user: root
  
    - group: root
  
Only the source path to the vimrc file has changed. Now the formula is referenced as edit.vim because it resides in the edit subdirectory. Now the edit subdirectory can contain formulas for emacs, nano, joe or any other editor that may need to be deployed.
  

  
执行方式变成了salt '*' state.sls edit.vim
  

  
# salt '*' state.sls edit.vim
  
test230:
  
----------
  
          ID: vim-enhanced
  
    Function: pkg.installed
  
      Result: True
  
   Comment: Package vim-enhanced is already installed.
  
   Started: 11:53:52.288936
  
    Duration: 1039.998 ms
  
   Changes:
  
----------
  
          ID: /root/.vimrc
  
    Function: file.managed
  
      Result: True
  
   Comment: File /root/.vimrc is in the correct state
  
   Started: 11:53:53.329085
  
    Duration: 161.691 ms
  
   Changes:
  

  
Summary
  
------------
  
Succeeded: 2
  
Failed:    0
  
------------
  
Total states run:   2
页: [1]
查看完整版本: saltstack的探索-通过官网文档迅速了解salt