环境要求

操作系统

  • OSROOM支持Linux中部署，windows未测试通过
  • 建议使用Ubuntu>=14.04版本
  • 测试通过操作系统有Ubuntu 14.04, 16.04, 18.04; Centos 6.5;
  • 其他Linux系统还未测试

Python要求

  • Python 3.4以上版本，比如Python 3.4, Python 3.5, Python 3.6

Python依赖包安装

创建Python虚拟环境

1
$ virtualenv -p python3 env

安装依赖包

  • 进入依赖包

    1
    source env/bin/active

  • 进入osroom项目根目录

  • 使用pip安装依赖包
    1
    $ pip install -r requirements.txt

配置数据库

安装

初始化配置

因为osroom源代码只把配置文件config.py和数据库配置文件db_config.py的sample文件上传到git，所以请先复制修改名称。

1
2
3
# 进入apps/configs
cp config_sample.py config.py
cp db_config_sample db_config.py

编辑db_config.py，在配置中对应位置填写好数据库用户名和密码。

1
vim db_config.py

初始化第一个用户

  • 进入项目的python虚拟环境
  • 进入根目录运行start.py add_user，操作如下：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    $ source env/bin/action
    $ python start.py add_user
     * [User] add
    Input username:root
    Input email:xiaopingwoo@163.com
    Input password(Password at least 8 characters):
    [Warning]: 密码至少8个字符！ 至少包含数字，字母，特殊字符中的任意两种

    Input password(Password at least 8 characters):
     * Create root role...
    Create root user role successfully
     * Create root user...
     * Create a root user role successfully
     * Create the average user role...
     * Create a generic user role successfully
    The basic information is as follows
    Username: root
    Email: h*****irr@***.com
    User role: Root
    Password: #D****qw123
    End

访问测试

使用自带的服务测试是否能够成功运行osroom.

启动OSROOM

  • 进入osroom项目目录

    1
    $ python start.py runserver --host 127.0.0.1 --port 5000

  • 打开浏览器访问 http://127.0.0.1:5000

更多信息请前往OSROOM DOC