- Ansible官方文档 : [Ansible Documentation][1]
- 本项目源自：[centos-script][2] | [ubuntu-script][3]
- 项目已通过安全扫描，清放心使用
- 使用到的特性：lineinfile,blockinfile,template,user,roles,package,apt,yum,service,systemd,handlers,notify等
- 推荐目标主机系统版本：Ubuntu 16.04,Centos 7,Debian 9
ansible-linux
├── ansible.cfg // ansible 配置文件，优先级最高，其次为/etc/ansible/ansible.cfg
├── files // 模板文件，非roles中的
├── group_vars // 全局环境变量
├── inventory // 机器分组列表
│ ├── all // 所有机器，不分组
│ ├── off // 下线机器列表
│ ├── os // 按操作系统版本分类
│ └── pro // 按项目或集群分类
├── LICENSE // 开源许可证
├── playbooks // 各种剧本
│ ├── backuppc.yml // backuppc配置剧本
│ ├── config.yml // 系统配置剧本
│ ├── files -> ../files
│ ├── group_vars -> ../group_vars
│ ├── install.yml // 软件安装剧本
│ ├── prometheus.yml // p8s配置剧本
│ ├── repository.yml // 仓库源配置剧本
│ ├── uninstall.yml // 软件卸载剧本
│ └── universal.yml // 集合，通用剧本
├── README.md // 自述文件
└── roles // 角色
├── ahuffman.resolv // 配置/etc/resolved.conf
├── cloudalchemy.prometheus // 安装和配置prometheus服务器
├── geerlingguy.ntp // 安装和配置ntp时间同步
├── leif160519.backuppc // 配置backuppc服务器(不包含安装)
├── leif160519.clickhouse-cluster // 安装配置clickhouse集群
├── leif160519.docker // 安装和配置docker
├── leif160519.emqx-cluster // 安装emqx集群
├── leif160519.fstab // 配置/etc/fstab中的挂载点
├── leif160519.kafka-cluster // 安装kafka集群2.x
├── leif160519.kubernetes // 安装kubernetes集群(kubeadm)
├── leif160519.minio-cluster // 安装minio集群
├── leif160519.monit // 安装monit，监控moosefs
├── leif160519.moosefs // 安装moosefs分布式存储集群
├── leif160519.mysql // 安装和配置mysql5.7.28
├── leif160519.nacos-cluster // 安装nacos集群2.0
├── leif160519.network // 配置静态ip地址
├── leif160519.oh-my-zsh // 安装和配置oh-my-zsh
├── leif160519.redis-cluster // 编译安装和配置redis集群6.x
├── leif160519.vim-complex // 配置vim-简单版
├── leif160519.vim-simple // 配置vim-复杂版，带智能语法提示
└── leif160519.zookeeper-cluster // 安装zookeeper集群3.5.9
- 1.选择一台Linux或Mac主机安装python3并安装ansible
#ubuntu
apt-get install ansible
#centos
yum -y install ansible
#macos
brew install ansible
# python
pip3 install ansible
- 2.将本机的ssh-key全部复制进所有目标主机中
ssh-copy-id -i root@<host-ip>
- 3.克隆本项目
git clone https://github.com/Leif160519/ansible-linux
- 4.根据实际情况修改inventory下的主机hostname和IP地址
all: 所有机器,若目标主机ssh端口不为22,请在
ansible_host后新增一列ansible_port=<ssh_port>
os：根据系统版本进行分类
pro: 根据集群或者项目进行分类
- 5.ansible配置文件-
ansible.cfg(使用pip3安装的ansible不会生成配置文件，可手动创建并配置，或者直接引用项目目录下的ansible.cfg(执行时会优先生效)) 使用代理进行ssh远程主机:
vim ansible.cfg(/etc/ansible/ansible.cfg)
[ssh_connection]
ssh_args = -o ProxyCommand="nc -X connect -x 127.0.0.1:3128 %h %p"
请将127.0.0.1:3128改为真实有效的代理地址
- 6.开始刷入(若使用代理上网，请添加参数
-e proxy_url="http://example.com:3128",支持http和socks5)
# all machine(prometheus.yml auto install node_exporter)
ansible-playbook -u root -i inventory/ playbooks/universal.yml
## 五、特定情况
- 1.安装某些软件
ansible-playbook -u root -i inventory/ playbooks/install.yml -t general
- 2.在某些机器上指定playbook
ansible-playbook -u root -i inventory/ playbooks/install.yml -l 'jenkins-server nexus-server'
- 3.监控主机安装prometheus
执行`prometheus.yml`之后别忘了执行一下`node_exporter.yml`，否则`9090`不能显示监控数据
- 4.被监控主机安装node_exporter
需在`node_export.yml`文件中将`delegate_to`后面的`prometheus`主机名按照实际情况修改之后再执行
- 5.安装node_exporter时报错解决办法
在某些情况下，执行带有`delegate_to`（任务委派）的playbook时候，会报错：
failed: [centos-7 -> 192.168.0.108] (item= - job_name: 'node') => {"ansible_loop_var": "item", "changed": false, "item": " - job_name: 'node'", "module_stderr": "Shared connection to 192.168.0.108 closed.\r\n", "module_stdout": "/bin/sh: 1: /usr/bin/python: not found\r\n", "msg": "The module failed to execute correctly, you probably need to set the interpreter.\nSee stdout/stderr for the exact error", "rc": 127}
failed: [debian-10 -> 192.168.0.108] (item= - job_name: 'node') => {"ansible_loop_var": "item", "changed": false, "item": " - job_name: 'node'", "module_stderr": "Shared connection to 192.168.0.108 closed.\r\n", "module_stdout": "/bin/sh: 1: /usr/bin/python3.7: not found\r\n", "msg": "The module failed to execute correctly, you probably need to set the interpreter.\nSee stdout/stderr for the exact error", "rc": 127}
原因是ansible未检测到python环境，也就是说你在Linux终端打`python`是提示无此命令的，所以解决办法是，强制ansible使用python3环境，在执行命令后面添加`-e ansible_python_interpreter=/usr/bin/python3`参数即可：
ansible-playbook -u root -i inventory playbooks/node_exporter.yml -l 'jenkins-server' -e ansible_python_interpreter=/usr/bin/python3
## 六、说明
- 1.prometheus安装完成后，默认加载了若干规则，详情请参看`files/prometheus/alert/rules/`
- 2.项目中的部分文件已经配置了在vim下的自动折叠功能(依据标志),其他折叠方式如下：
- manual //手工定义折叠
- indent //用缩进表示折叠
- expr //用表达式来定义折叠
- syntax //用语法高亮来定义折叠
- diff //对没有更改的文本进行折叠
- marker //用标志折叠
在vim的配置文件中设置`set foldmethod=marker`或者通过ansible刷入即可：
ansible-playbook -u root -i inventory playbooks/vim-simple -e username=
## 七、补充内容
### 7.1 git代码统计工具
#### 1) svn转化为git:git-svn
- 安装：`apt-get install git-svn`
- 下载svn库：`git-svn clone <svn_uri>`
- 更新svn库：`git-svn rebase`
#### 2) git代码图形化报表：[gitstats][7];[gitinspector][8];git-bars
- 安装：
apt-get install gitstats(ubuntu 20.04请先安装gnuplot-nox，之后可以去下载gitstats_2015.10.03-1_all.deb之后再安装) apt-get install gitinspector pip3 install git-bars
- 生成报表：
gitstats <git_dir> <report_dir> gitinspector <git_dir> -HTLlrw --since="2021-01-01" -F html > index.html git-bars
## 八、已知的问题(截止2021-02-01)
- ansible中的service模块(systemd版本:245.4)与内核版本为5.8的linux不兼容，会报`FAILED! => {"changed": false, "msg": "Service is in unknown state", "status": {}}`，建议内核版本5.8基础上升级systemd版本至245.7及以上或降级Linux内核版本,详情参看:[Service is in unknown state #71528][4] | [ansible fails with systemd 245.4][5]
- 当执行ntp.yml时，若远程机器是ubuntu20.04的系统请将ansible版本升级至2.9.8以上或使用2.10(使用pip3而不是apt安装)，详情参看:[Problems on Ubuntu 20.04 #86][6]
## 九、监控其他指标
#### 1. 监控nginx
执行nginx_exporter之前，需提前配置好nginx中的/stub_status,剧本中使用的是8080端口，也可以更换成其他端口，另外，监控信息最好只对p8s服务器开放访问，其他ip可以禁止，配置示例如下：
server { listen 8080; location /stub_status { stub_status on; allow 10.1.1.24; deny all; } }
#### 2. 监控jenkins
需在jenkins中安装`Prometheus metrics`插件才行
Grafana dashboard可以使用[9964][25]
## 十、Grafana所需Dashboard一览表
| 监控点 | Dashboard |
|-----------------------------------------|---------------------------------------------------------|
| Linux服务器状态 | [1 Node Exporter Dashboard 22/04/17 通用Job分组版][9] |
| 自动发现的腾讯云所有Linux服务器状态 | [1 Node Exporter Dashboard 22/04/13 ConsulManager自动同步版][10] |
| Alertmanager告警总览 | [Alertmanager告警总览][11] |
| Prometehus Alerts | [Prometheus Alerts][12] |
| 所有业务http监控 | [1 Blackbox Exporter Dashboard 2022/04/12][13] |
| Backuppc监控 | [Backuppc][14] |
| prometehus数据持久化监控 | [VictoriaMetrics][15] |
| MySQL监控 | [mysql overview][24],[1 Mysqld Exporter Dashboard 22/11/01中文版][36] |
| ElasticSearch监控 | [ElasticSearch Production][26] |
| zookeeper监控 | [Zookeeper Exporter (dabealu)][27],[Zookeeper_exporter][31] |
| emq 监控 | [EMQ 服务指标看板][28](模板可能适用于api v3版本，v4版本的需要修改其中的采集数据) |
| clickhouse监控(内置指标) | [ClickHouse][29] |
| Nacos监控 | [Nacos][30] |
| nginx vts 监控| [Nginx VTS Status][32] |
| kafka 监控 | [Kafka Exporter Overview][33] |
| jvm 监控| [JMX Overview][34],[Kubernetes JMX Dashboard][35],[JVM (Actuator)][36] |
| Vmware ESXI | [VMware ESXi Import][38],[VMware VM][39],[VMware stats][40]|
## 十一、参考
- [ConsulManager][16]
- [prometheus对接飞书告警][17]
- [PrometheusAlert][18]
- [Awesome Prometheus Alerts][19]
- [Prometheus AlertManager][20]
- [prometheus监控nginx][21]
- [Prometheus 监控 nginx][22]
- [prometheus远端存储之VictoriaMetrics][23]
## 十二、资产清单检查
理论上，all中的资产和os中的总数保持一致，故可以在`.git/hooks`下创建如下内容的脚本`pre-commit`，以便在commit过程的时候检查资产完整性
#!/bin/bash workspace="/data/workspace/gitlab/ansible"
function ResultOutput() { if [ ! -z "$3" ];then echo -e "\033[1;31m $1中存在$2中没有的资产名:$3 \033[0m" else echo -e "\033[1;32m $1中的资产在$2中都包含 \033[0m" fi }
egrep -v "[all]" ${workspace}/inventory/all | awk '{print
os=$(grep -v -f /tmp/all /tmp/os | tr '\n' ',') ResultOutput "os" "all" "${os}" os=$(grep -v -f /tmp/os /tmp/all | tr '\n' ',') ResultOutput "all" "os" "${os}"
find /tmp/all -delete find /tmp/os -delete
脚本创建完成之后，执行
chmod +x .git/hooks/pre-commit
## Star History
[](https://star-history.com/#leif160519/ansible-linux&Date)
[1]: https://docs.ansible.com/
[2]: https://github.com/Leif160519/centos-script
[3]: https://github.com/Leif160519/ubuntu-script
[4]: https://github.com/ansible/ansible/issues/71528
[5]: https://bugs.launchpad.net/ubuntu/+source/systemd/+bug/1899232
[6]: https://github.com/geerlingguy/ansible-role-ntp/issues/86
[7]: http://gitstats.sourceforge.net/
[8]: https://github.com/ejwa/gitinspector
[9]: https://grafana.com/grafana/dashboards/16098
[10]: https://grafana.com/grafana/dashboards/8919
[11]: https://grafana.com/grafana/dashboards/9741/revisions
[12]: https://grafana.com/grafana/dashboards/11098
[13]: https://grafana.com/grafana/dashboards/9965
[14]: https://grafana.com/grafana/dashboards/13628
[15]: https://grafana.com/grafana/dashboards/10229
[16]: https://github.com/starsliao/ConsulManager
[17]: https://www.cnblogs.com/lixinliang/p/16045115.html
[18]: https://feiyu563.github.io/index.html
[19]: https://awesome-prometheus-alerts.grep.to/
[20]: https://grafana.com/grafana/plugins/camptocamp-prometheus-alertmanager-datasource/?tab=installation
[21]: https://blog.csdn.net/qq_45464560/article/details/119490479
[22]: https://blog.csdn.net/u010953609/article/details/121988480
[23]: https://www.cnblogs.com/zhrx/p/16028078.html
[24]: https://grafana.com/grafana/dashboards/14969
[25]: https://grafana.com/grafana/dashboards/9964
[26]: https://grafana.com/grafana/dashboards/13641
[27]: https://grafana.com/grafana/dashboards/11442
[28]: https://grafana.com/grafana/dashboards/9963
[29]: https://grafana.com/grafana/dashboards/14192
[30]: https://grafana.com/grafana/dashboards/13221
[31]: https://grafana.com/grafana/dashboards/15026
[32]: https://grafana.com/grafana/dashboards/10990
[33]: https://grafana.com/grafana/dashboards/7589
[34]: https://grafana.com/grafana/dashboards/3457
[35]: https://grafana.com/grafana/dashboards/11131-kubernetes-jmx-dashboard/
[36]: https://grafana.com/grafana/dashboards/17320
[37]: https://grafana.com/grafana/dashboards/9568-jvm-actuator/
[38]: https://grafana.com/grafana/dashboards/15447-vmware-esxi-import/
[39]: https://grafana.com/grafana/dashboards/15446-vmware-vm/
[40]: https://grafana.com/grafana/dashboards/11243-vmware-stats/