有幾種方式去設定odoo的開發環境,我們將逐個介紹他們,
如果你之前沒有接觸過odoo的開發環境,那么有幾個必要的概念你是需要了解的,在這一章節中,我們首先介紹odoo的生態,然后我們在進行介紹odoo開發環境的安裝,
在這一章節中,我們主要涉及以下內容,
- 理解odoo的生態
- 原始碼安裝
- 管理odoo的資料庫
- 存盤實體配置
- 激活odoo開發環境
- 更新插件串列
一、理解odoo的生態
妞妞為開發者提供了開箱即用的開發模式,這可以讓開發者很快完成專案建設,
odoo的版本
妞妞有兩個版本,第一個是社區版,也是開源的,第二個是企業版,是需要軟體授權的,企業班只是在社區版的基礎上增加了一些新的功能,社區版基于LGPLv3協議開源,并集成了基礎的ERP應用,企業版是妞妞公司獨有的協議,社區版有更強大的功能,比如全套的記賬,開發,以及網路電話等設企業半夜將提供無限制的bug修復,下面這張表格說明了企業版于社區版的關系,

Git 存盤庫
妞妞的原始碼都是托管在github上,

每年妞妞都會發布,一般主要的版本(Long-Term Support LTS)以及一些小版本,小版本主要使用在SaaS服務上,
Runbot
Runbot是妞妞的自動測驗環境,它可以自動拉去github中最新的4次提交,并進行構建,在這,你可以使用企業版以及他們的分支,(原始碼是看不到的)
每次構建有不同的顏色,這代表這測驗用例的情況,綠色代表通過,紅色代表失敗,你可以查看具體的日志,每次構建會有兩個資料庫,一個是安裝了全部模塊的資料庫,一個是基礎資料庫,每次構建都會安裝一些模擬資料,
Note
訪問:http://runbot.odoo. com/runbot.
幾個基本的賬戶
- admin,admin
- demo,demo
- portal,portal
這是一個公開的測驗環境,任何人都可以使用,所以說在你測驗的時候也有可能其他人也在測驗相同的分支,
妞妞的app商城
正如其名,商城,大家上去看看就懂了,
妞妞社區協會
**Odoo Community Association (OCA)**非盈利組織,管理者不少好模塊,但是有不少模塊都是老版本的了,跟新的版本不一定兼容,如有需要,需要自己修改,地址如下:https://github.com/OCA
官方的幫助論壇
有問題先上論壇,有很多坑其實大家都在踩,https://help.odoo.com.help.odoo.com.
妞妞的在線學習平臺
官方的視頻教程,訪問地址:https://www.odoo.com/slides.
二、原始碼安裝
官方推薦ubuntu,這本書使用的是Ubuntu Server 18.04 LTS版本,
個人的開發環境最好跟生產環境相同,避免不少坑,
準備
Ubuntu 18.04、管理員賬戶
一些配置可能需要賬戶名,可通過whoami命令獲取用戶名,
步驟
- 安裝依賴
$ sudo apt-get update
$ sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools libpng12-0 libjpeg-dev gdebi -y
- 下載安裝wkhtmltopdf
$ wget https://github.com/wkhtmltopdf/wkhtmltopdf/ releases/download/0.12.5/wkhtmltox_0.12.5-1.trusty_amd64. deb
$ sudo dpkg -i wkhtmltox_0.12.5-1.trusty_amd64.deb
- 安裝postgresql資料庫
$ sudo apt install postgresql -y
- 配置PostgresSQL:
$ sudo -u postgres createuser --superuser $(whoami)
- 配置git
$ git config --global user.name "Your Name"
$ git config --global user.email [email protected]
- 下載原始碼
$ mkdir ~/odoo-dev
$ cd ~/odoo-dev
$ git clone -b 14.0 --single-branch --depth 1 https:// github.com/odoo/odoo.git
- 安裝odoo14的虛擬環境并激活(個人使用的是pipenv)
$ python3 -m venv ~/venv-odoo-14.0
$ source ~/venv-odoo-14.0/bin/activate
- 安裝依賴
$ cd ~/odoo-dev/odoo/
$ pip3 install -r requirements.txt
- 創建odoo物體
$ createdb odoo-test
$ python3 odoo-bin -d odoo-test –i base --addons- path=addons --db-filter=odoo-test$
- 登錄系統http://localhost:8069,賬戶名密碼設定為admin
作業原理
步驟1,安裝核心依賴,用于安裝odoo,
步驟2,安裝wkhtmltopdf,
PostgreSQL配置
步驟3,安裝資料庫,
步驟4,創建一個與當前用戶相同的用戶,-s 是授予用戶超級權限,odoo通過psycopg2連接資料庫,為了訪問資料庫,odoo使用如下默認配置:
- 默認psycopg2通過當前系統用戶相同的用戶名去連接本地資料庫,支持無密碼登錄,
- 本地連接使用的是Unix domain sockets,
- 資料庫默認使用5432埠,
因為我們使用的是開發環境,因此我們給用戶授予了超級權限,但在生產環境下,要使用 --createdb命令替換--superuser,我們可以通過--pwprompt引數創建密碼,如果用戶已存在,可重置密碼,
psql -c "alter role $(whoami) with password 'newpassword'"
如果報錯說資料庫不存在,是我們再步驟4中沒有創建資料庫引起的,可通過在步驟4命令的用戶名后面添加 --dbname db_1,
Git 配置
通過git,我們可方便的調整部署的版本,
步驟5,我們創建git用戶,
步驟6,下載最新的原始碼,用到的命令git clone及--depth 1(可下載一層commit),
虛擬環境
python虛擬環境是為了避免環境污染,
步驟7,我們在~/venv-odoo-14.0檔案夾中創建了python的環境及安裝所需的包,我們可通過source ~/venv-odoo-14.0/bin/activate命令激活虛擬環境,
安裝pyhon包
步驟8,安裝odoo所需的python包,
啟動物體
步驟9,啟動物體
odoo-bin所用到的引數
- -d 指定資料庫
- --db-filter=database_name$: 僅連接database_name$(正則匹配)的資料庫,一次安裝,可同時啟動多個實體(連接不同的資料庫),這個引數可以限制物體所能使用的資料庫,
- --addons-path=directory1, directory2,這個引數是指定實體所載入的模塊路徑,
- -i base:這是為了安裝base模塊,這是一切的基礎哦,
或使用的資料庫并不是系統登錄賬戶,可通過如下引數進行配置,
- --db_host=IP地址:使用TCP連接資料庫服務器,
- --db_user=database_username:資料庫賬戶,
- --db_password=database_password:資料庫密碼,
其他的引數,可通過 odoo-bin --help引數查看,
當odoo啟動了一個空的資料庫,odoo將創建運行所需的基礎表結構,同時將掃描addons-path目錄中可用的模塊,并加載到資料庫中,默認的賬戶密碼是admin,
登錄系統http://localhost:8069/,如下截圖

管理odoo的資料庫
準備
已經在運行的odoo實體
步驟
odoo的資料庫管理工具提供了資料庫的創建、復制、洗掉、備份及恢復,還可以資料庫管理工具的管理密碼,限制非授權用戶對資料庫的操作,
訪問資料庫介面
- 進入登錄頁面
- 點擊Manager Database鏈接,將進入/web/database/manager頁面,

設定和修改管理工具密碼

創建新的資料庫

按步驟創建就行,如果點擊Continue之后又進入了登錄頁面,可能是剛剛填寫的Database Name不符合之前設定的--db_filter指定的的資料庫正則,
復制資料庫
有時我們需要對在用的資料進行測驗,但是又不能操作生產庫,那么我們可以將資料庫復制一份,在復制的資料庫中進行操作,
洗掉資料庫
慎重操作,需輸入資料庫管理工具的管理密碼,
備份資料庫
同樣需要管理密碼,
恢復備份的資料庫
按提示操作就行,
原理
管理密碼是存盤在odoo.conf組態檔中的,
odoo使用PostgreSQL的createdb工具創建新的資料庫,并呼叫odoo內部的函式初始化資料庫,
如果想復制資料庫,可通過createdb --template 資料名,通過這種方式,比通過頁面的上的backup、restore要快很多,
備份和恢復使用的是pg_dump及pg_restore工具,當使用zip的格式的資料庫備份時,備份將包含一些檔案的副本(在配置odoo時用到但并未存盤在資料庫中的檔案),這些在odoo14中是默認選項,這些檔案默認存盤在~/.local/share/odoo/filestore中,
如果備份太大,可能會導致下載失敗,odoo無法在記憶體中處理大檔案、http的response設定的太小等都會導致這個問題,同樣,restore也一樣,
餐后甜點
直接通過命令列操作資料庫是非常方便的,
用演示資料初始化新的資料庫
$ createdb testdb && odoo-bin -d testdb
我們還可以同時安裝模塊,-i sale, purchase, stock,
復制資料庫,停用服務并啟動
$ createdb -T dbname newdbname
$ cd ~/.local/share/Odoo/filestore # adapt if you have changed the data_dir
$ cp -r dbname newdbname
$ cd -
在開發環境的背景關系中,檔案存盤經常被忽略,
命令列createdb -T操作資料庫需在資料庫沒有被使用的情況下哦,也就是復制資料庫需要odoo停用的情況下進行,
移除資料庫物體,可通過
$ dropdb dbname
$ rm -rf ~/.local/share/Odoo/filestore/dbname
創建備份,假定資料庫在本地
$ pg_dump -Fc -f dbname.dump dbname
$ tar cjf dbname.tgz dbname.dump ~/.local/share/Odoo/filestore/ dbname
恢復備份,可通過如下
$ tar xf dbname.tgz
$ pg_restore -C -d dbname dbname.dump
注意!
如果odoo使用不同的用戶連接資料庫,那么你需要傳參-U username來為恢復的資料庫指定擁有者,
存盤實體的配置
odoo-bin腳本支持幾十個引數的配置,我們可通過組態檔簡化記憶,默認存盤在/etc/odoo/odoo.conf中,
步驟
- 生成組態檔
$ ./odoo-bin --save --config myodoo.cfg --stop-after-init
- 我們可以指定引數,這些引數的值可以存盤在生成的組態檔中,通過如下命令獲取引數可能的值
$ ./odoo-bin --help | less
- 要從命令列形式轉換為配置形式,請使用長選項名,洗掉開頭的破折號,并將中間的破折號轉換為下劃線,--without-demo變成without_demo,這適用于大多數選項,但也有一些例外情況,將在下面的部分中列出,
- 通過組態檔啟動實體
$ ./odoo-bin -c odoo.conf
原理
在實體啟動的時候,主要經歷三個階段的配置,第一,所有的配置引數通過源代碼設定默認值,第二,加載組態檔并覆寫已有配置,第三,命令列傳參將再次覆寫已有配置,
大多數命令列引數都可按照上面說的方式在組態檔中找到,但是如下是不規則的變化:
| 命令列 | 組態檔 |
| --db-filter | dbfilter |
| --no-http | http_enable = True/False |
| --database | db_name |
| --dev | dev_mode |
| --il8n-import/--il8n-export | Unavailabe |
下面列出了一些常用的配置:
| 配置 | 格式 | 說明 |
| without_demo | 模塊名s | 阻止模塊安裝延時資料, all:全部禁用 False:全部開啟 串列:sale,purchase |
| addons_path | 模塊所在的目錄 | 多個路徑,“,”隔開 |
| admin_passwd | 文本 | 主密碼 |
| data_dir | 資料檔案路徑 | 存盤session、網上下載的add-ons以及檔案 |
| http_port longpolling_port |
數字 | 在運行多個odoo服務的使用需要指定兩個port, longpolling_port是在workers為非0 的指定, http_port默認8069,longpolling_port為8072. |
| logfile | 檔案路徑 | odoo的log檔案 |
| log_level | 日志級別 | critical,error,warn,info,debug,debug_rpc, debug_rpc_answer,debug_sql |
| workers | 整數 | worker的行程數量,詳見第三章服務開發 |
| proxy_mode | True/False | 激活反向代理WSGI包裝器, 僅當運行在可信的web代理后時才啟用此功能! |
以下是資料庫相關的配置
| 配置 | 格式 | 說明 |
| db_host | hostname | 資料庫主機ip |
| db_user | 資料庫用戶名 | 若db_host為False,則該項為空,這將使用當前用戶連接資料庫 |
| db_password | 資料庫密碼 | |
| db_name | 資料庫名 | This is used to set the database name on which some commands operate by default. This does not limit the databases on which the server will act. Refer to the following dbfilter option for this. |
| db_sslmode | 資料庫的ssl模式 | 指定資料庫的ssl連接模式 |
| dbfilter | 正則 | 匹配odoo實體可訪問的資料庫,若是運行網站,需精確匹配到一個資料庫如^databasename$ |
| list_db | True/False | 顯示或隱藏資料庫管理頁面, |
一些組態檔并不會在組態檔中使用,但在開發模式下廣泛使用,
| 配置 | 格式 | 說明 |
| -i or --init | 模塊名s | 使用“模塊”初始化資料庫 |
| -u or --update | 模塊名s | 更新模塊 |
| --dev | all,reload,qweb, werkzeug,xml |
激活開發者模式
作為odoo的開發者,你需要了解如何激活開發者模式,激活開發者模式之后,可以訪問高級的配置以及相映的欄位,這些選項通常是隱藏掉的并且在日常到使用程序中當中并不會用到,
步驟
-
用admin賬戶登陸系統,
-
進入配置,
-
在最下方可以看到開發者工具,

-
點擊 激活開發者模式,
-
等待頁面加載完成,
另外一種激活方式
It is also possible to activate the developer mode by editing the URL. Before the # sign, insert ?debug=1.
For example, if your current URL is http://localhost:8069/ web#menu_id=102&action=94 and you want to enable
developer mode, then you need to change that URL to http:// localhost:8069/web?debug=1#menu_id=102&action=94. Furthermore, if you want debug mode with assets, then change the URL
to http://localhost:8069/web?debug=assets#menu_ id=102&action=94.
退出開發者模式
- 可以直接編輯url,將 ?debug=0,
- 在頁面上選擇退出激活模式,
- 點擊頁面上方的bug選單,點擊離開開發者模式,
還有一種更簡單的方式是通過插件

小貼士
自odoo13之后,除錯模式有所改變,除錯模式是存盤在sessino中的,即便你移除了url當中的?debug,依舊debug模式,
原理
在開發者模式下會有兩個改變
- 當你把滑鼠放在form視圖和串列視圖相應filed的時候會展示這一個欄位的技術資訊,
- 頁面的上方會有一個bug的圖示選單,我們可以訪問一些除錯工具,
還有另外一種開發者模式-,Developer mode(with assets),這一個模式下于正常的開發者模式大部分相同,只是多了JavaScript和CSS的相關內容,相應的檔案不再進行壓縮,方便除錯,
注意!
請在非開發者模式下除錯你的應用,否則會可能忽略一些潛在的問題,
更新本地模塊串列
當你新建了一個模塊兒的時候,妞妞其實是不知道的,所以需要你進行手動的重繪,
步驟
這里就放兩張圖


原理
當我們點擊了更新按鈕的時候,妞妞會去讀取add-ons path中配置的路徑中的檔案,并查找每一個__manifest__.py檔案,這里包含著模塊的相關資訊,如果在檔案當中包含installable=False,那么這一個模塊兒資訊將不會被寫入資料庫,如果模塊已經存在那么會更新相關資訊,如果不存在則新建,
小貼士
手動更新主要是在完成資料庫初始化之后新增的模塊,
# 資料初始化
python3 odoo-bin -d odoo-test -i base --addons-path=addons --db-filter=odoo-test
# 啟動
./odoo-bin -c odoo.conf
轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/262792.html
標籤:Python
