Saltshaker项目安装与配置指南

项目概述

Saltshaker是一个基于SaltStack的自动化运维管理平台，提供了Web界面来简化SaltStack的管理操作。本指南将详细介绍如何在Ubuntu和CentOS系统上安装和配置Saltshaker环境。

环境准备

系统要求

• 操作系统：Ubuntu 14.04.3 LTS 或 CentOS 6.x
• Python环境：需要安装pip工具
• 数据库：MySQL

详细安装步骤

1. 安装pip工具

pip是Python的包管理工具，用于安装后续所需的Python依赖包。

wget "https://pypi.python.org/packages/source/p/pip/pip-7.1.2.tar.gz#md5=3823d2343d9f3aaab21cf9c917710196" --no-check-certificate
tar -xzvf pip-7.1.2.tar.gz
cd pip-7.1.2
python setup.py install

2. 安装SaltStack

Saltshaker基于SaltStack构建，需要先安装SaltStack组件。

Ubuntu系统安装方式：

# 添加软件源
add-apt-repository ppa:saltstack/salt

# 或者手动添加源
echo deb http://ppa.launchpad.net/saltstack/salt/ubuntu `lsb_release -sc` main | sudo tee /etc/apt/sources.list.d/saltstack.list
wget -q -O- "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x4759FA960E27C0A6" | sudo apt-key add -

# 更新并安装
apt-get update
apt-get install salt-master salt-minion salt-syndic salt-api

CentOS系统安装方式：

rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/latest/SALTSTACK-GPG-KEY.pub
yum clean all
yum install salt-master salt-minion salt-api salt-syndic

3. 安装CherryPy

CherryPy是一个轻量级的Python Web框架，用于Salt API。

pip install cherrypy==3.8.0

4. 配置Salt API

Salt API提供了RESTful接口供Saltshaker调用。

# 创建系统用户
useradd -M -s /sbin/nologin admin
passwd admin

# 创建配置文件
vim /etc/salt/master.d/saltapi.conf

配置文件内容：

rest_cherrypy:
  port: 8000
  host: 127.0.0.1
  disable_ssl: true
external_auth:
  pam:
    admin:
      - .*
      - '@runner'
      - '@wheel'

重启服务：

/etc/init.d/salt-master restart
/etc/init.d/salt-api restart
netstat -tnlp | grep 8000  # 验证8000端口是否监听

5. 安装Django及相关组件

Saltshaker使用Django作为Web框架。

pip install Django==1.8.4
pip install django-crontab
pip install mysql-python
mkdir -pv /var/log/saltshaker/

配置数据库和Salt API认证信息：

# settings.py中的数据库配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'saltshaker',
        'USER': 'root',
        'PASSWORD': '123456',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

# SaltStack API配置
SALT_API_URL = 'http://127.0.0.1:8000'
SALT_API_USER = 'admin'
SALT_API_PASSWD = 'admin'

6. 安装Celery和RabbitMQ

Celery用于处理异步任务，RabbitMQ作为消息队列。

# 安装Celery
pip install django-celery==3.1.17
pip install celery==3.1.17

# 安装RabbitMQ
# Ubuntu
echo 'deb http://www.rabbitmq.com/debian/ testing main' >> /etc/apt/sources.list
wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
apt-key add rabbitmq-signing-key-public.asc
apt-get install rabbitmq-server

# 启用管理插件
/usr/lib/rabbitmq/bin/rabbitmq-plugins enable rabbitmq_management
service rabbitmq-server restart

配置Celery：

# settings.py中的Celery配置
platforms.C_FORCE_ROOT = True
djcelery.setup_loader()
BROKER_HOST = "127.0.0.1"
BROKER_PORT = 5672
BROKER_USER = "guest"
BROKER_PASSWORD = "guest"
BROKER_VHOST = "/"

7. 数据库初始化

-- 在MySQL中执行
CREATE DATABASE saltshaker;
USE saltshaker;
SOURCE /path/to/saltshaker-init.sql.txt;  -- 根据实际路径修改

8. 启动服务

# 启动Celery worker
python manage.py celery worker --loglevel=info -c 5

# 添加计划任务
python manage.py crontab add

# 启动Django开发服务器
python manage.py runserver 0.0.0.0:80

访问地址：http://127.0.0.1 初始用户名：admin 初始密码：admin

生产环境部署建议

对于生产环境，建议使用Nginx和uWSGI替代Django开发服务器：

# 安装uWSGI和Nginx
pip install uwsgi django-uwsgi
apt-get install nginx  # 或yum install nginx

常见问题解决

1. Salt API无法启动：检查8000端口是否被占用，确保saltapi.conf配置正确
2. 数据库连接失败：检查MySQL服务是否运行，用户名密码是否正确
3. Celery任务不执行：检查RabbitMQ服务状态，确认worker已启动

总结

本文详细介绍了Saltshaker项目的安装和配置过程，涵盖了从基础环境准备到各个组件的安装配置。通过遵循这些步骤，您可以成功搭建一个功能完整的Saltshaker运维管理平台。对于生产环境，建议进一步优化配置并考虑安全加固措施。