saltstack
buyfakett
saltstack
服务器 | 主机名 | ip | 身份 | 软件包 |
---|---|---|---|---|
centos7 | xue1 | 192.168.70.75 | master | salt-master |
centos7 | xue2 | 192.168.70.76 | minion | salt-minion |
命令
安装
# 安装saltstack存储库和密钥
# rpm --import https://repo.saltproject.io/py3/redhat/7/x86_64/3003/SALTSTACK-GPG-KEY.pub
rpm --import https://repo.saltproject.io/salt/py3/redhat/7/x86_64/3007/SALT-PROJECT-GPG-PUBKEY-2023.pub
# curl -fsSL https://repo.saltproject.io/py3/redhat/7/x86_64/3003.repo | sudo tee /etc/yum.repos.d/salt.repo
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
# 换源
sed -i 's#https://repo.saltproject.io/#https://mirrors.tuna.tsinghua.edu.cn/saltstack/#g' /etc/yum.repos.d/salt.repo
yum -y install salt-master # 主控端安装
yum -y install salt-ssh # salt-ssh安装
yum -y install salt-minion # 受控端安装
mkdir -p /etc/apt/keyrings
curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring-2023.gpg https://repo.saltproject.io/salt/py3/debian/12/amd64/SALT-PROJECT-GPG-PUBKEY-2023.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring-2023.gpg arch=amd64] https://repo.saltproject.io/salt/py3/debian/12/amd64/3007 bookworm main" | \
tee /etc/apt/sources.list.d/salt.list
sed -i 's#https://mirrors.tuna.tsinghua.edu.cn/saltstack/#https://repo.saltproject.io/#g' /etc/apt/sources.list.d/salt.list
apt -y install salt-master # 主控端安装
apt -y install salt-ssh # salt-ssh安装
apt -y install salt-minion # 受控端安装
# 受控端需要修改(注意:后面需要有一个空格)
vim /etc/salt/minion
# 受控端设置
# 主控端ip
master: 192.168.70.75
# 受控端的名字(自定义)
id: xue2
# 主控端设置(取消注释,默认salt脚本路径和复制文件的路径)
file_roots:
base:
- /srv/salt/
# 在主控端可以看有多少请求(主控端需要开启4505和4506端口)
salt-key -L
# 接受需要的受控端
salt-key -a "xue*"
# 接受以后可以测试有没有成功
salt "xue*" test.ping
//salt-key常用选项
-L //列出所有公钥信息
-a minion //接受指定minion等待认证的key
-A //接受所有minion等待认证的key
-r minion //拒绝指定minion等待认证的key
-R //拒绝所有minion等待认证的key
-f minion //显示指定key的指纹信息
-F //显示所有key的指纹信息
-d minion //删除指定minion的key
-D //删除所有minion的key
-y //自动回答yes
//语法:salt [options] '<target>' <function> [arguments]
//常用的options
--version //查看saltstack的版本号
--versions-report //查看saltstack以及依赖包的版本号
-h //查看帮助信息
-c CONFIG_DIR //指定配置文件目录(默认为/etc/salt/)
-t TIMEOUT //指定超时时间(默认是5s)
--async //异步执行
-v //verbose模式,详细显示执行过程
--username=USERNAME //指定外部认证用户名
--password=PASSWORD //指定外部认证密码
--log-file=LOG_FILE //指定日志记录文件
//常用target参数
-E //正则匹配
-L //列表匹配
-S //CIDR匹配网段
-G //grains匹配
--grain-pcre //grains加正则匹配
-N //组匹配
-R //范围匹配
-C //综合匹配(指定多个匹配)
-I //pillar值匹配
编写
具体格式可以参考官方文档
vi /data/salt/test.sls 创建测试文件
#创建文件夹(注意file.directory前面两个空格,-前面4个,-后面1个,True前面1个,最后三行可以指定用户、组、权限)
/data/logs/:
file.directory:
- makedirs: True
- user: fred
- group: users
- mode: 755
#删除/data这个目录和下面的所有文件
del:
file.absent:
- name: /data/
#上传单文件到受控端(主控端写相对路径,上传到受控端的绝对路径)
upload:
file.managed:
- name: /data/app/1.txt
- source: salt://1.txt
- mode: 644
#上传目录到受控端(主控端写相对路径,上传到受控端的绝对路径,include_empty空目录也要上传)
#exclude_pat来排除文件,在E@后面跟正则表达式
#watch可以监视某个有没有执行成功
upload_res:
file.recurse:
- name: /data/data/
- source: salt://data/
- dir_mode: 755
- file_mode: 644
- exclude_pat: E@(.svn)|(setup-v3.sh)|(setup.sh)
- include_empty: True
- watch:
- file: upload
salt使用git为服务端
使用最新的tls版(目前为3006.5)
# 新版本的salt自带python
rpm --import https://repo.saltproject.io/salt/py3/redhat/7/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/x86_64/3006.repo | sudo tee /etc/yum.repos.d/salt.repo
salt -V
Salt Version:
Salt: 3006.5
Python Version:
Python: 3.10.13 (main, Nov 15 2023, 04:34:27) [GCC 11.2.0]
Dependency Versions:
cffi: 1.16.0
cherrypy: unknown
dateutil: 2.8.1
docker-py: Not Installed
gitdb: Not Installed
gitpython: Not Installed
Jinja2: 3.1.2
libgit2: 1.7.1
looseversion: 1.0.2
M2Crypto: Not Installed
Mako: Not Installed
msgpack: 1.0.2
msgpack-pure: Not Installed
mysql-python: Not Installed
packaging: 22.0
pycparser: 2.21
pycrypto: Not Installed
pycryptodome: 3.9.8
pygit2: 1.13.3
python-gnupg: 0.4.8
PyYAML: 6.0.1
PyZMQ: 23.2.0
relenv: 0.14.2
smmap: Not Installed
timelib: 0.2.4
Tornado: 4.5.3
ZMQ: 4.3.4
System Versions:
dist: centos 7.9.2009 Core
locale: utf-8
machine: x86_64
release: 3.10.0-1160.71.1.el7.x86_64
system: Linux
version: CentOS Linux 7.9.2009 Core
安装pygit2
yum install python-pygit2 -y
salt-pip install pygit2
需要在master中配置
fileserver_backend: # 当前配置为git和本地都用,两边有文件时优先使用git
- gitfs # 需要在这里写出来才能用
- roots
gitfs_provider: pygit2 # 配置salt的文件服务器为pygit2
gitfs_ssl_verify: False # 是否校验ssl(主配置)
gitfs_update_interval: 120 # 间隔多少s去拉git(主配置)
gitfs_user: test # git的账号(主配置)
gitfs_password: test # git的密码(主配置)
gitfs_insecure_auth: True # 默认False情况下,Salt将不会通过HTTP(非HTTPS)远程进行身份验证(主配置)
gitfs_remotes:
- http://xx.xx.xx.xx:8080/root/saltstack.git: # git地址
- user: root # git的账号(子配置)
- password: password # git的密码(子配置)
- ssl_verify: False # 是否校验ssl(子配置)
- update_interval: 30 # 间隔多少s去拉git(子配置)
- base: master # 分支(子配置)
配置git钩子(gitlab为例)
在/data/salt/
新建update_fileserver.sls
文件,可以按照上面的来填写目录和文件名
update_fileserver:
runner.fileserver.update
在master中配置
reactor:
- 'salt/fileserver/gitfs/update':
- /data/salt/update_fileserver.sls # 此配置可以按照上面的来填写目录和文件名
配置gitlab钩子
15.11 及更高的版本可能在hooks目录
15.10 及更早的版本(当前公司为这个配置)
# 管理中心->项目->saltstack->找到Gitaly相对路径
# 在服务端中找到对应路径(容器内目录需要加上/var/opt/gitlab/git-data/repositories)
mkdir custom_hooks && cd custom_hooks && touch post-receive chmod a+x post-receive
vim post-receive # 注:下面的脚本最开始的那行最好在容器内执行which python3来填写
#!/opt/gitlab/embedded/bin/python3
from pyssh_util.ssh_util import SSHClient
if __name__ == "__main__":
host = '192.168.1.1'
password = 'password'
ssh = SSHClient(host, password)
command = 'salt-call event.fire_master update salt/fileserver/gitfs/update'
result_single = ssh.execute_command(command)
ssh.close()
TIP
需要再gitlab
容器中安装我封装的依赖
docker exec -i gitlab /opt/gitlab/embedded/bin/pip3 install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
docker exec -i gitlab /opt/gitlab/embedded/bin/pip3 install pyssh-util==1.0.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
其他
salt-ssh
# target的信息
host: # 远端主机的ip地址或者dns域名
port: # ssh端口
user: # 登录的用户
sudo: # 可以通过sudo
priv: # ssh秘钥的文件路径
tty: # 如果设置了sudo,设置这个参数为true
timeout: # 当建立链接时等待响应时间的秒数
# 可选的部分
passwd: # 用户密码,如果不使用此选项,则默认使用秘钥方式
minion_opts: # minion的位置路径
thin_dir: # target系统的存储目录,默认是/tmp/salt-<hash>
cmd_umask: # 使用salt-call命令的umask值
hdy-xg-server-001:
host: 154
port: 22
user: root
sudo: true
passwd:
tty: true
timeout: 60
# 可能需要py3
salt-ssh -r 'hdy-xg-server-001' 'yum -y install python3'
vim ~/.ssh/config
StrictHostKeyChecking no
salt-proxy
需要在proxy
端安装salt-syndic
然后再proxy
端的master
增加配置order_masters: True
和syndic_master: <master_ip>