# SaltAdmin

**Repository Path**: x8x48/SaltAdmin

## Basic Information

- **Project Name**: SaltAdmin
- **Description**: 基于SaltStack的自动化运维平台
- **Primary Language**: HTML
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-02-03
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

SaltAdmin
=========

![SaltAdmin](https://github.com/luxiaok/SaltAdmin/raw/master/static/images/SaltAdminLogo.jpg)

基于[SaltStack](https://github.com/saltstack/salt)的自动化运维平台

Designed By [Xiaok](http://github.com/luxiaok)


### Python运维圈（微信扫一扫） ###

![Python运维圈](https://github.com/luxiaok/SaltAdmin/raw/master/static/images/ops_circle_qrcode.jpg)

>或者微信搜索 **Python运维圈**

### 技术交流QQ群 ###

**459457262**

>加群时请注明来自 **Github**


## 一、环境说明 ##
* SaltAdmin：1.0-Beta
* 系统平台：RHEL/CentOS 6.x | Ubuntu 12.04+
* [SaltStack](https://github.com/saltstack/salt) >= 2014.7.0
* [Python](http://www.python.org)：2.6.6/2.7.x
* [Webpy](http://webpy.org)：0.38
* [Mako](http://www.makotemplates.org/)：0.9.1/1.0.0+
* [MySQL](http://www.percona.com/)：Percona-Server 5.5.36
* [MySQL-python](http://pypi.python.org/pypi/MySQL-python)：1.2.5+
* [uWSGI](http://projects.unbit.it/downloads/uwsgi-2.0.6.tar.gz)：2.0.6 (Not Limit)
* [Nginx](http://nginx.org/download/nginx-1.6.0.tar.gz)：1.4.7 (Not Limit)

**说明**
* (1) RHEL/CentOS支持6.x系列，7.0以上暂未测试(实际生产环境7.x系列还没成为主流)
* (2) uWSGI和Nginx作为Web容器是可选的环境，可以不部署
* (3) 其他软件的版本号在实际运行环境中如果不同，为了兼容性保持主版本号相同即可


## 二、安装 ##

### 1.Webpy ###
* wget http://webpy.org/static/web.py-0.38.tar.gz
* tar zxf web.py-0.38.tar.gz
* python setup.py install

### 2.Mako ###
* pip install mako

### 3.MySQLdb ###
* yum install MySQL-python

### 4.SaltStack ###
RedHat/CentOS 6 系列<br>
* rpm -ivh http://mirrors.sohu.com/fedora-epel/6Server/x86_64/epel-release-6-8.noarch.rpm
* yum install salt-master
* yum install salt-minion

Ubuntu 系列<br>
* add-apt-repository -y ppa:saltstack/salt
* apt-get update
* apt-get install salt-master
* apt-get install salt-ssh
* apt-get install salt-minion

>新版的SaltStack已经有了官方的Yum仓库，具体请参照http://repo.saltstack.com/

### 5.其他依赖 ###
依赖以下python模块
* yum install python-dmidecode
* pip install -U psutil

### 6.数据库配置  ###
* 新建数据库saltadmin
* 导入doc目录下的saltadmin.sql文件
* 配置config/database.py

```
#!/usr/bin/env python
#-*- coding:utf-8 -*-

dbType = 'mysql'
dbHost = '127.0.0.1'
dbPort = 3306
dbName = 'saltadmin'
dbUser = 'test'
dbPass = 'test'
dbChar = 'utf8'
```

## 三、启动SaltAdmin ##
* 启动：python run.py
* 访问端口：8080
* 用户名/密码：admin/admin

>更换监听端口：python run.py IP:Port


## 四、基础排错思路 ##

**万变不离其宗，在终端看程序日志可以解决N多问题，不要依赖前端的弹窗提示**


## 五、截图预览 ##

### 登录 ###
![Login](https://github.com/luxiaok/SaltAdmin/raw/master/screenshot/login.png)

### 控制中心 ###
![Dashboard](https://github.com/luxiaok/SaltAdmin/raw/master/screenshot/dashboard.png)

### 监控 ###
![Monitor](https://github.com/luxiaok/SaltAdmin/raw/master/screenshot/monitor.png)

### 设备管理 ###
![Device](https://github.com/luxiaok/SaltAdmin/raw/master/screenshot/device.png)