【odoo14】第一章、安裝odoo的開發環境

有幾種方式去設置odoo的開發環境，咱們將逐個介紹他們。

若是你以前沒有接觸過odoo的開發環境，那麼有幾個必要的概念你是須要了解的。在這一章節中，咱們首先介紹odoo的生態。而後咱們在進行介紹odoo開發環境的安裝。

在這一章節中，咱們主要涉及如下內容。

• 理解odoo的生態
• 源碼安裝
• 管理odoo的數據庫
• 存儲實例配置
• 激活odoo開發環境
• 更新插件列表

---

1、理解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.

---

2、源碼安裝

官方推薦ubuntu，這本書使用的是Ubuntu Server 18.04 LTS版本。

我的的開發環境最好跟生產環境相同，避免很多坑。

準備

Ubuntu 18.0四、管理員帳戶

一些配置可能須要帳戶名，可經過whoami命令獲取用戶名。

步驟

1. 安裝依賴

$ 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

2. 下載安裝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

3. 安裝postgresql數據庫

$ sudo apt install postgresql -y

4. 配置PostgresSQL：

$ sudo -u postgres createuser --superuser $(whoami)

5. 配置git

$ git config --global user.name "Your Name"
$ git config --global user.email youremail@example.com

6. 下載源碼

$ mkdir ~/odoo-dev
$ cd ~/odoo-dev
$ git clone -b 14.0 --single-branch --depth 1 https:// github.com/odoo/odoo.git

7. 安裝odoo14的虛擬環境並激活(我的使用的是pipenv)

$ python3 -m venv ~/venv-odoo-14.0
$ source ~/venv-odoo-14.0/bin/activate

8. 安裝依賴

$ cd ~/odoo-dev/odoo/
$ pip3 install -r requirements.txt

9. 建立odoo實體

$ createdb odoo-test
$ python3 odoo-bin -d odoo-test –i base --addons- path=addons --db-filter=odoo-test$

10. 登陸系統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的數據庫管理工具提供了數據庫的建立、複製、刪除、備份及恢復。還能夠數據庫管理工具的管理密碼，限制非受權用戶對數據庫的操做。

訪問數據庫接口

1. 進入登陸頁面
2. 點擊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中。

步驟

1. 生成配置文件

$ ./odoo-bin --save --config myodoo.cfg --stop-after-init

2. 咱們能夠指定參數，這些參數的值能夠存儲在生成的配置文件中。經過以下命令獲取參數可能的值

$ ./odoo-bin --help | less

3. 要從命令行形式轉換爲配置形式，請使用長選項名，刪除開頭的破折號，並將中間的破折號轉換爲下劃線。--without-demo變成without_demo。這適用於大多數選項，但也有一些例外狀況，將在下面的部分中列出。
4. 經過配置文件啓動實例

$ ./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的開發者，你須要瞭解如何激活開發者模式。激活開發者模式以後，能夠訪問高級的配置以及相映的字段。這些選項一般是隱藏掉的而且在平常到使用過程當中當中並不會用到。

步驟

1. 用admin帳戶登錄系統。

2. 進入配置。

3. 在最下方能夠看到開發者工具。
   

4. 點擊 激活開發者模式。

5. 等待頁面加載完成。

另一種激活方式
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