Nguồn cài đặt¶
'Cài đặt' nguồn không phải là cài đặt Odoo mà thay vào đó là chạy nó trực tiếp từ nguồn.
Việc sử dụng nguồn Odoo có thể thuận tiện hơn cho các nhà phát triển mô-đun vì nguồn này dễ truy cập hơn so với việc sử dụng các trình cài đặt đóng gói.
Nó làm cho việc khởi động và dừng Odoo trở nên linh hoạt và rõ ràng hơn so với các dịch vụ được thiết lập bởi trình cài đặt đóng gói. Ngoài ra, nó cho phép ghi đè cài đặt bằng cách sử dụng tham số dòng lệnh mà không cần chỉnh sửa tệp cấu hình.
Cuối cùng, nó cung cấp khả năng kiểm soát tốt hơn đối với việc thiết lập hệ thống và cho phép dễ dàng giữ (và chạy) nhiều phiên bản Odoo cạnh nhau hơn.
Tìm nạp các nguồn¶
Có hai cách để lấy mã nguồn của Odoo: dưới dạng ZIP kho lưu trữ hoặc thông qua Git.
Lưu trữ¶
Phiên bản Community:
Phiên bản doanh nghiệp:
Git¶
Ghi chú
Cần phải cài đặt Git và nên có kiến thức cơ bản về các lệnh Git để tiếp tục.
Để sao chép kho lưu trữ Git, hãy chọn giữa sao chép bằng HTTPS hoặc SSH. Trong hầu hết các trường hợp, tùy chọn tốt nhất là HTTPS. Tuy nhiên, hãy chọn SSH để đóng góp cho mã nguồn Odoo hoặc khi làm theo Hướng dẫn bắt đầu dành cho nhà phát triển.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Ghi chú
Kho lưu trữ git Enterprise không chứa mã nguồn Odoo đầy đủ. Nó chỉ là một tập hợp các tiện ích bổ sung. Mã máy chủ chính nằm trong phiên bản Cộng đồng. Chạy phiên bản Enterprise có nghĩa là chạy máy chủ từ phiên bản Cộng đồng với tùy chọn addons-path
được đặt vào thư mục có phiên bản Enterprise. Cần phải sao chép cả kho Cộng đồng và Doanh nghiệp để cài đặt Odoo Enterprise hoạt động.
Chuẩn bị¶
Python¶
Odoo yêu cầu Python 3.10 trở lên để chạy.
Thay đổi trong phiên bản 17: Yêu cầu tối thiểu được cập nhật từ Python 3.7 lên Python 3.10.
Sử dụng trình quản lý gói để tải xuống và cài đặt Python 3 nếu cần.
Tải xuống phiên bản Python 3 mới nhất và cài đặt nó.
Trong quá trình cài đặt, hãy chọn Thêm Python 3 vào PATH, sau đó nhấp vào Tùy chỉnh cài đặt và đảm bảo rằng pip được chọn.
Ghi chú
Nếu Python 3 đã được cài đặt, hãy đảm bảo rằng phiên bản đó là 3.10 trở lên vì các phiên bản trước không tương thích với Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Xác minh rằng pip cũng được cài đặt cho phiên bản này.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo sử dụng PostgreSQL làm hệ thống quản lý cơ sở dữ liệu.
Sử dụng trình quản lý gói để tải xuống và cài đặt PostgreSQL (phiên bản được hỗ trợ: 12.0 trở lên). Nó có thể đạt được bằng cách thực hiện như sau:
$ sudo apt install postgresql postgresql-client
Tải xuống PostgreSQL (phiên bản được hỗ trợ: 12.0 trở lên) và cài đặt nó.
Sử dụng Postgres.app để tải xuống và cài đặt PostgreSQL (phiên bản được hỗ trợ: 12.0 trở lên).
Mẹo
Để cung cấp các công cụ dòng lệnh đi kèm với Postgres.app, hãy đảm bảo thiết lập biến $PATH
bằng cách làm theo hướng dẫn về công cụ `Postgres.app CLI <https://postgresapp.com/documentation/cli-tools.html >`_.
Theo mặc định, người dùng duy nhất là postgres
. Vì Odoo cấm kết nối dưới dạng postgres
, hãy tạo người dùng PostgreSQL mới.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Vì người dùng PostgreSQL có cùng tên với thông tin đăng nhập Unix nên có thể kết nối với cơ sở dữ liệu mà không cần mật khẩu.
Thêm thư mục
bin
của PostgreSQL (theo mặc định:C:\Program Files\PostgreSQL\<version>\bin
) vàoPATH
.Tạo người dùng postgres bằng mật khẩu bằng gui quản trị viên pg:
Mở pgAdmin.
Bấm đúp vào máy chủ để tạo kết nối.
Chọn
.Nhập tên người dùng vào trường Tên vai trò (ví dụ:
odoo
).Mở tab Định nghĩa, nhập mật khẩu (ví dụ:
odoo
) và nhấp vào Lưu.Mở tab Đặc quyền và chuyển Có thể đăng nhập? thành
Có
và Tạo cơ sở dữ liệu? thànhCó
.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Vì người dùng PostgreSQL có cùng tên với thông tin đăng nhập Unix nên có thể kết nối với cơ sở dữ liệu mà không cần mật khẩu.
Phụ thuộc¶
Sử dụng gói phân phối là cách ưa thích để cài đặt các phần phụ thuộc. Ngoài ra, hãy cài đặt các phần phụ thuộc Python bằng pip.
Trên Debian/Ubuntu, các lệnh sau sẽ cài đặt các gói cần thiết:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
Tập lệnh setup/debinstall.sh
sẽ phân tích tệp debian/control và cài đặt các gói tìm thấy.
Cảnh báo
Việc sử dụng pip có thể dẫn đến các vấn đề về bảo mật và sự phụ thuộc bị hỏng; chỉ làm điều này nếu bạn biết những gì bạn đang làm.
Vì một số gói Python cần bước biên dịch nên chúng yêu cầu cài đặt thư viện hệ thống.
Trên Debian/Ubuntu, lệnh sau sẽ cài đặt các thư viện cần thiết này:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Các phần phụ thuộc của Odoo được liệt kê trong tệp requirements.txt
nằm ở thư mục gốc của Cộng đồng Odoo.
Ghi chú
Các gói Python trong requirements.txt
dựa trên phiên bản tương ứng ổn định/LTS Debian/Ubuntu tại thời điểm phát hành Odoo. Ví dụ: đối với Odoo 15.0, phiên bản gói python3-babel
là 2.8.0 trong Debian Bullseye và 2.6.0 trong Ubuntu Focal. Sau đó, phiên bản thấp nhất sẽ được chọn trong requirements.txt
.
Mẹo
Tốt nhất là không trộn lẫn các gói mô-đun Python giữa các phiên bản khác nhau của Odoo hoặc với hệ thống. Tuy nhiên, có thể sử dụng virtualenv để tạo môi trường Python biệt lập.
Điều hướng đến đường dẫn cài đặt Cộng đồng Odoo (CommunityPath
) và chạy pip trên tệp yêu cầu để cài đặt các yêu cầu cho người dùng hiện tại.
$ cd /CommunityPath
$ pip install -r requirements.txt
Trước khi cài đặt các phần phụ thuộc, hãy tải xuống và cài đặt Công cụ xây dựng cho Visual Studio. Chọn Công cụ xây dựng C++ trong tab Khối lượng công việc và cài đặt chúng khi được nhắc.
Các phần phụ thuộc của Odoo được liệt kê trong tệp requirements.txt
nằm ở thư mục gốc của Cộng đồng Odoo.
Mẹo
Tốt nhất là không trộn lẫn các gói mô-đun Python giữa các phiên bản khác nhau của Odoo hoặc với hệ thống. Tuy nhiên, có thể sử dụng virtualenv để tạo môi trường Python biệt lập.
Điều hướng đến đường dẫn cài đặt Cộng đồng Odoo (CommunityPath
) và chạy pip trên tệp yêu cầu trong thiết bị đầu cuối với đặc quyền của Quản trị viên:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Các phần phụ thuộc của Odoo được liệt kê trong tệp requirements.txt
nằm ở thư mục gốc của Cộng đồng Odoo.
Mẹo
Tốt nhất là không trộn lẫn các gói mô-đun Python giữa các phiên bản khác nhau của Odoo hoặc với hệ thống. Tuy nhiên, có thể sử dụng virtualenv để tạo môi trường Python biệt lập.
Điều hướng đến đường dẫn cài đặt Cộng đồng Odoo (CommunityPath
) và chạy pip trên tệp yêu cầu:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Ghi chú
Đối với các ngôn ngữ sử dụng giao diện từ phải sang trái (chẳng hạn như tiếng Ả Rập hoặc tiếng Do Thái), bắt buộc phải có gói rtlcss
.
Tải xuống và cài đặt nodejs và npm bằng trình quản lý gói.
Cài đặt
rtlcss
:$ sudo npm install -g rtlcss
Tải xuống và cài đặt nodejs.
Cài đặt
rtlcss
:C:\> npm install -g rtlcss
Chỉnh sửa biến
PATH
của môi trường hệ thống để thêm thư mục chứartlcss.cmd
(thường:C:\Users\<user>\AppData\Roaming\npm\
) .
Cảnh báo
wkhtmltopdf
không được cài đặt thông qua pip và phải được cài đặt thủ công trong phiên bản 0.12.6 cho nó để hỗ trợ đầu trang và chân trang. Hãy xem wkhtmltopdf wiki để biết thêm chi tiết về các phiên bản khác nhau.
Chạy Odoo¶
Sau khi tất cả các phần phụ thuộc đã được thiết lập, Odoo có thể được khởi chạy bằng cách chạy odoo-bin
, giao diện dòng lệnh của máy chủ. Nó nằm ở thư mục gốc của cộng đồng Odoo.
Để định cấu hình máy chủ, hãy chỉ định đối số dòng lệnh hoặc một tệp cấu hình.
Mẹo
Đối với phiên bản Enterprise, hãy thêm đường dẫn đến tiện ích bổ sung enterprise
vào đối số addons-path
. Lưu ý rằng nó phải đứng trước các đường dẫn khác trong addons-path
để các tiện ích bổ sung được tải chính xác.
Các cấu hình cần thiết phổ biến là:
Người dùng và mật khẩu PostgreSQL.
Đường dẫn bổ trợ tùy chỉnh ngoài giá trị mặc định để tải các mô-đun tùy chỉnh.
Một cách điển hình để chạy máy chủ sẽ là:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Cộng đồng Odoo và mydb
là tên của cơ sở dữ liệu PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Cộng đồng Odoo, dbuser
là thông tin đăng nhập PostgreSQL, dbpassword
là mật khẩu PostgreSQL và mydb
là tên của cơ sở dữ liệu PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Cộng đồng Odoo và mydb
là tên của cơ sở dữ liệu PostgreSQL.
Sau khi máy chủ khởi động (nhật ký INFO odoo.modules.loading: Mô-đun đã tải.
được in), hãy mở http://localhost:8069 trong trình duyệt web và đăng nhập vào cơ sở dữ liệu Odoo bằng tài khoản quản trị viên cơ sở: sử dụng ` admin` làm email và một lần nữa, admin
làm mật khẩu.
Mẹo