通知（2018-12-24）

• 最新情況與更新，請查看文檔 https://osroom.github.io/osroom-doc或者直接上Github和Gitee
• 有問題請在github或gitee上提出，本站很少查看哦！
  Github地址
  Giteeb地址
  Demo網(wǎng)站

環(huán)境要求(2018-05-24）

操作系統(tǒng)

• OSROOM支持Linux中部署, Windows未測試過

• 建議使用Ubuntu 16.04或14.04,其他Linux系統(tǒng)還未測試

Pyhotn要求

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

Pyhton依賴包安裝

創(chuàng)建Python虛擬環(huán)境(建議)

• 例如在在/home/work創(chuàng)建名為venv-osroom的虛擬環(huán)境

pip -m venv /home/work/venv-osroom

• 沒有安裝好python-venv請先安裝, Ubuntu安裝命令如下:

sudo apt-get install python-venv

安裝依賴包

• 進入虛擬環(huán)境

    source /home/work/venv-osroom/bin/activate
    # 或
    . /home/work/venv-osroom/bin/activate

-進入osroom項目根目錄

• 使用pip安裝依賴包

pip install -r requirements.txt

• 如果出現(xiàn)類似以下錯誤信息 Command "/xxx/venv-osroom/bin/python3 -u -c "import setuptools, tokenize; __file__='/tmp/pip-install-erphi6km/xxx/setup.py'; f=getattr(tokenize, 'open', open)(__file__); code=f.read().replace('\r\n', '\n');f.close(); exec(compile(code, __file__, 'exec'))" install --record /tmp/pip-record-nhbhzs1a/install-record.txt --single-version-externally-managed --compile --install-headers /home/work/project/venv_osroom/include site/python3.5/xxxx" failed with error code 1 in /tmp/pip-install-erphi6km/xxxx/ 那么請嘗試安裝python-dev Ubuntu系統(tǒng): # 不一定需要版本號 sudo apt-get install python3.5-dev 其他使用yum安裝工具的Linux發(fā)行部系統(tǒng):

  # 不一定需要版本號
 sudo yum install python3.5-devel

配置數(shù)據(jù)庫

安裝

• 請看Mongodb安裝文檔與Redis安裝文檔

初始化配置

因為osroom源代碼只把配置文件config.py 和 數(shù)據(jù)庫配置文件db_config.py 的sample文件上傳到git，所以請先復(fù)制修改名稱

 # 進入到apps/configs
 cp config_sample.py config.py
 cp db_config_sample.py db_config.py
<br/><br/>  ```
 - 編輯db_config.py, 在配置中對應(yīng)位置填寫好數(shù)據(jù)庫用戶名和密碼
<br/>
```python
 DB_CONFIG = {
    "redis": {
        "password": "<Your password>",
        "host": [
            "127.0.0.1"
        ],
        "port": [
            "6379"
        ]
    },
    "mongodb": {
        "mongo_web": {
            "password": "<Your password>",
            "username": "work",
            "config": {
                "fsync": False,
                "replica_set": None
            },
            "host": [
                "127.0.0.1:27017"
            ],
            "dbname": "osr_web"
        },
        "mongo_user": {
            "password": "<Your password>",
            "username": "work",
            "config": {
                "fsync": False,
                "replica_set": None
            },
            "host": [
                "127.0.0.1:27017"
            ],
            "dbname": "osr_user"
        },
        "mongo_sys": {
            "password": "<Your password>",
            "username": "work",
            "config": {
                "fsync": False,
                "replica_set": None
            },
            "host": [
                "127.0.0.1:27017"
            ],
            "dbname": "osr_sys"
        }
    }
}

初始化第一個用戶

• 進入項目的Python虛擬環(huán)境

• 進入根目錄運行start.py add_user 按如下操作和提示創(chuàng)建第一個用戶

(venv_osroom) work@osroom:~/project/osroom$ python start.py add_user
 * [User] add
Input username:root
Input email:xiaopingwoo@163.com
Input password(Password at least 8 characters):
[Warning]: 密碼至少8個字符！ 至少包含數(shù)字，字母，特殊字符中的任意兩種

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

訪問測試

使用自帶的服務(wù)測試是否能夠成功運行osroom（測試用, 實際部署產(chǎn)品不會使用該方式啟動運行）

啟動OSROOM

• 進入osroom項目目錄

# 如果需要外部訪問，--host 為0.0.0.0 , --port 指定已開放的端口,默認(rèn)5000
python start.py runserver --host 127.0.0.1 --port 5000

• 打開瀏覽器訪問 127.0.0.1:5000