การติดตั้งแหล่งที่มา¶

'การติดตั้ง' แหล่งที่มาไม่ได้เกี่ยวกับการติดตั้ง Odoo แต่เป็นการเรียกใช้โดยตรงจากแหล่งที่มาแทน

การใช้แหล่งที่มาของ Odoo จะสะดวกกว่าสำหรับนักพัฒนาโมดูล เนื่องจากเข้าถึงได้ง่ายกว่าการใช้ตัวติดตั้งแบบแพ็คเกจ

ทำให้การเริ่มและการหยุด Odoo มีความยืดหยุ่นและชัดเจนมากกว่าบริการที่ตั้งค่าโดยตัวติดตั้งแบบแพ็คเกจ นอกจากนี้ยังอนุญาตให้แทนที่การตั้งค่าโดยใช้ พารามิเตอร์บรรทัดคำสั่ง โดยไม่จำเป็นต้องแก้ไขไฟล์การกำหนดค่า

สุดท้ายนี้ ช่วยให้สามารถควบคุมการตั้งค่าของระบบได้ดียิ่งขึ้น และช่วยให้สามารถเก็บ (และเรียกใช้) Odoo หลายเวอร์ชันไว้เคียงข้างกันได้ง่ายขึ้น

ดึงแหล่งที่มา¶

มีสองวิธีในการรับซอร์สโค้ดของ Odoo: เป็นไฟล์ ZIP เก็บถาวร หรือผ่าน Git

เก็บถาวร¶

ฉบับคอมมูนิตี้:

รุ่นองค์กร:

Git¶

Note

จำเป็นต้องมีการติดตั้ง Git และขอแนะนำให้มีความรู้พื้นฐานเกี่ยวกับคำสั่ง Git เพื่อดำเนินการต่อ

หากต้องการโคลนพื้นที่เก็บข้อมูล Git ให้เลือกระหว่างการโคลนด้วย HTTPS หรือ SSH ในกรณีส่วนใหญ่ ตัวเลือกที่ดีที่สุดคือ HTTPS อย่างไรก็ตาม เลือก SSH เพื่อสนับสนุนซอร์สโค้ด Odoo หรือเมื่อปฏิบัติตาม บทช่วยสอนการเริ่มต้นใช้งานสำหรับนักพัฒนา

$ 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

Note

ที่เก็บ Enterprise git ไม่มีซอร์สโค้ด Odoo แบบเต็ม ที่เป็นเพียงชุดของส่วนเสริมพิเศษเท่านั้น รหัสเซิร์ฟเวอร์หลักอยู่ในรุ่นคอมมูนิตี้ การเรียกใช้เวอร์ชันองค์กร หมายถึงการเรียกใช้เซิร์ฟเวอร์จากเวอร์ชันคอมมูนิตี้ โดยตั้งค่าตัวเลือก addons-path ไปยังโฟลเดอร์ที่มีรุ่นองค์กร จำเป็นต้องโคลนทั้งที่เก็บข้อมูลคอมมูนิตี้และองค์กร เพื่อให้มีการติดตั้ง Odoo องค์กรที่ใช้งานได้

เตรียมพร้อม¶

Python¶

Odoo ต้องใช้ Python 3.10 หรือใหม่กว่าจึงจะทำงานได้

Changed in version 17: ข้อกำหนดขั้นต่ำได้รับการอัปเดตจาก Python 3.7 เป็น Python 3.10

ใช้ตัวจัดการแพ็คเกจเพื่อดาวน์โหลดและติดตั้ง Python 3 หากจำเป็น

Note

หากติดตั้ง Python 3 ไว้แล้ว ตรวจสอบให้แน่ใจว่าเวอร์ชันเป็น 3.10 ขึ้นไป เนื่องจากเวอร์ชันก่อนหน้าเข้ากันไม่ได้กับ Odoo

$ python3 --version

C:\> python --version

$ python3 --version

ตรวจสอบว่ามีการติดตั้ง pip สำหรับเวอร์ชันนี้ด้วย

$ pip3 --version

C:\> pip --version

$ pip3 --version

PostgreSQL¶

Odoo ใช้ PostgreSQL เป็นระบบจัดการฐานข้อมูล

ใช้ตัวจัดการแพ็คเกจเพื่อดาวน์โหลดและติดตั้ง PostgreSQL (เวอร์ชันที่รองรับ: 12.0 หรือสูงกว่า) สามารถทำได้โดยดำเนินการดังต่อไปนี้:

$ sudo apt install postgresql postgresql-client

ใช้ Postgres.app เพื่อดาวน์โหลดและติดตั้ง PostgreSQL (เวอร์ชันที่รองรับ: 12.0 หรือสูงกว่า)

Tip

หากต้องการให้เครื่องมือบรรทัดคำสั่งที่มาพร้อมกับ Postgres.app ใช้งานได้ โปรดตั้งค่าตัวแปร $PATH โดยทำตามคำแนะนำเกี่ยวกับเครื่องมือ `Postgres.app CLI <https://postgresapp.com/documentation/cli-tools.html >`_.

ตามค่าเริ่มต้น ผู้ใช้เพียงคนเดียวคือ postgres เนื่องจาก Odoo ห้ามไม่ให้เชื่อมต่อเป็น postgres ให้สร้างผู้ใช้ PostgreSQL ใหม่

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Note

เนื่องจากผู้ใช้ PostgreSQL มีชื่อเดียวกับข้อมูลเข้าสู่ระบบ Unix คุณจึงสามารถเชื่อมต่อกับฐานข้อมูลได้โดยไม่ต้องใช้รหัสผ่าน

เพิ่มไดเร็กทอรี ถังขยะ ของ PostgreSQL (โดยค่าเริ่มต้น: C:\Program Files\PostgreSQL\<version>\bin) ลงใน PATH
สร้างผู้ใช้ postgres ด้วยรหัสผ่านโดยใช้ pg admin gui:
1. เปิด pgAdmin
2. ดับเบิลคลิกที่เซิร์ฟเวอร์เพื่อสร้างการเชื่อมต่อ
3. เลือก ออบเจ็กต์ ‣ สร้าง ‣ เข้าสู่ระบบ/บทบาทกลุ่ม
4. ป้อนชื่อผู้ใช้ในช่อง ชื่อบทบาท (เช่น odoo)
5. เปิดแท็บ คำจำกัดความ ป้อนรหัสผ่าน (เช่น odoo) แล้วคลิก บันทึก
6. เปิดแท็บ สิทธิ์ และเปลี่ยน สามารถเข้าสู่ระบบได้หรือไม่ เป็น 'ใช่' และ สร้างฐานข้อมูล? เป็น 'ใช่'

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Note

การขึ้นต่อกัน¶

การใช้ แพ็คเกจการแจกจ่าย เป็นวิธีที่แนะนำในการติดตั้งการขึ้นต่อกัน หรือติดตั้งการขึ้นต่อกันของ Python ด้วย pip

บน Debian/Ubuntu คำสั่งต่อไปนี้ควรติดตั้งแพ็คเกจที่จำเป็น:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

สคริปต์ setup/debinstall.sh จะแยกวิเคราะห์ไฟล์ debian/control และติดตั้งแพ็คเกจที่พบ

Warning

การใช้ pip อาจนำไปสู่ปัญหาด้านความปลอดภัยและการขึ้นต่อกันที่เสียหาย ทำสิ่งนี้เฉพาะเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่

เนื่องจากแพ็คเกจ Python บางตัวจำเป็นต้องมีขั้นตอนการคอมไพล์ จึงจำเป็นต้องติดตั้งระบบไลบรารี

บน Debian/Ubuntu คำสั่งต่อไปนี้ควรติดตั้งไลบรารีที่จำเป็นเหล่านี้:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

การขึ้นต่อกันของ Odoo จะแสดงอยู่ในไฟล์ requirements.txt ซึ่งอยู่ที่รากของไดเร็กทอรี Odoo คอมมูนิตี้

Note

แพ็กเกจ Python ใน requirements.txt อิงตามเวอร์ชันเสถียร/LTS Debian/Ubuntu ที่สอดคล้องกันในขณะที่เปิดตัว Odoo ตัวอย่างเช่น สำหรับ Odoo 15.0 เวอร์ชันแพ็คเกจ python3-babel คือ 2.8.0 ใน Debian Bullseye และ 2.6.0 ใน Ubuntu Focal เวอร์ชันต่ำสุดจะถูกเลือกใน requirements.txt

Tip

ไม่ควรผสมแพ็คเกจโมดูล Python ระหว่างอินสแตนซ์ต่างๆ ของ Odoo หรือกับระบบ อย่างไรก็ตาม คุณสามารถใช้ virtualenv เพื่อสร้างสภาพแวดล้อม Python แบบแยกได้

นำทางไปยังเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ (CommunityPath) และเรียกใช้ pip บนไฟล์ข้อกำหนดเพื่อติดตั้งข้อกำหนดสำหรับผู้ใช้ปัจจุบัน

$ cd /CommunityPath
$ pip install -r requirements.txt

ก่อนที่จะติดตั้งการขึ้นต่อกัน ให้ดาวน์โหลดและติดตั้ง สร้างเครื่องมือสำหรับ Visual Studio เลือก เครื่องมือสร้าง C++ ในแท็บ ภาระงาน และติดตั้งเมื่อได้รับแจ้ง

Tip
ไม่ควรผสมแพ็คเกจโมดูล Python ระหว่างอินสแตนซ์ต่างๆ ของ Odoo หรือกับระบบ อย่างไรก็ตาม คุณสามารถใช้ virtualenv เพื่อสร้างสภาพแวดล้อม Python แบบแยกได้

นำทางไปยังเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ (CommunityPath) และเรียกใช้ pip บนไฟล์ข้อกำหนดในเทอร์มินัล ด้วยสิทธิ์ของผู้ดูแลระบบ:

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

Tip
ไม่ควรผสมแพ็คเกจโมดูล Python ระหว่างอินสแตนซ์ต่างๆ ของ Odoo หรือกับระบบ อย่างไรก็ตาม คุณสามารถใช้ virtualenv เพื่อสร้างสภาพแวดล้อม Python แบบแยกได้

นำทางไปยังเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ (CommunityPath) และเรียกใช้ pip ในไฟล์ข้อกำหนด:

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

Warning

ต้องติดตั้งการพึ่งพาที่ไม่ใช่ Python ด้วยตัวจัดการแพ็คเกจ (Homebrew, MacPorts)

ดาวน์โหลดและติดตั้ง เครื่องมือบรรทัดคำสั่ง:
```
$ xcode-select --install
```
ใช้ตัวจัดการแพ็คเกจเพื่อติดตั้งการขึ้นต่อกันที่ไม่ใช่ Python

Note

สำหรับภาษาที่ใช้ อินเทอร์เฟซจากขวาไปซ้าย (เช่น อารบิกหรือฮีบรู) จำเป็นต้องมีแพ็คเกจ rtlcss

ดาวน์โหลดและติดตั้ง nodejs และ npm ด้วยตัวจัดการแพ็คเกจ
ติดตั้ง rtlcss:
```
$ sudo npm install -g rtlcss
```

ดาวน์โหลดและติดตั้ง nodejs
ติดตั้ง rtlcss:
```
C:\> npm install -g rtlcss
```
แก้ไขตัวแปร PATH ของสภาพแวดล้อมระบบเพื่อเพิ่มโฟลเดอร์ที่มี rtlcss.cmd อยู่ (โดยทั่วไป: C:\Users\<user>\AppData\Roaming\npm\)

ดาวน์โหลดและติดตั้ง nodejs ด้วยตัวจัดการแพ็คเกจ (Homebrew, MacPorts)
ติดตั้ง rtlcss:
```
$ sudo npm install -g rtlcss
```

Warning

wkhtmltopdf ไม่ได้ติดตั้งผ่าน pip และต้องติดตั้งด้วยตนเองใน เวอร์ชัน 0.12.6 เพื่อรองรับส่วนหัวและส่วนท้าย ตรวจสอบ wkhtmltopdf wiki เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับเวอร์ชันต่างๆ

Odoo กำลังทำงาน¶

เมื่อตั้งค่าการขึ้นต่อกันทั้งหมดแล้ว Odoo จะสามารถเปิดใช้งานได้โดยการเรียกใช้ odoo-bin ซึ่งเป็นอินเทอร์เฟซบรรทัดคำสั่งของเซิร์ฟเวอร์ ซึ่งอยู่ที่รากของไดเรกทอรี Odoo คอมมูนิตี้

หากต้องการกำหนดค่าเซิร์ฟเวอร์ ให้ระบุ อาร์กิวเมนต์บรรทัดคำสั่ง หรือ ไฟล์การกำหนดค่า

Tip

สำหรับรุ่นองค์กร ให้เพิ่มเส้นทางไปยังส่วนเสริม "องค์กร" ไปยังอาร์กิวเมนต์ "addons-path" โปรดทราบว่าจะต้องมาก่อนเส้นทางอื่นๆ ใน addons-path เพื่อให้โหลด ส่วนเสริมได้อย่างถูกต้อง

การกำหนดค่าที่จำเป็นทั่วไปคือ:

ผู้ใช้และรหัสผ่าน PostgreSQL
เส้นทางเสริมที่กำหนดเองนอกเหนือจากค่าเริ่มต้นเพื่อโหลดโมดูลที่กำหนดเอง

วิธีทั่วไปในการรันเซิร์ฟเวอร์คือ:

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

โดยที่ CommunityPath คือเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ และ mydb คือชื่อของฐานข้อมูล PostgreSQL

C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb

โดยที่ CommunityPath คือเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ dbuser คือการเข้าสู่ระบบ PostgreSQL, dbpassword คือรหัสผ่าน PostgreSQL และ mydb คือชื่อของฐานข้อมูล PostgreSQL

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

หลังจากที่เซิร์ฟเวอร์เริ่มทำงาน (พิมพ์บันทึกข้อมูล odoo.modules.loading: กำลังโหลดโมดูล ` แล้ว) ให้เปิด http://localhost:8069 ในเว็บเบราว์เซอร์และเข้าสู่ระบบฐานข้อมูล Odoo ด้วยบัญชีผู้ดูแลระบบพื้นฐาน: ใช้ ` แอดมิน เป็นอีเมล และ แอดมิน เป็นรหัสผ่านอีกครั้ง

Tip

จากนั้น สร้างและจัดการ ผู้ใช้ใหม่
บัญชีผู้ใช้ที่ใช้ในการเข้าสู่ระบบเว็บอินเทอร์เฟซของ Odoo แตกต่างจาก --db_user อาร์กิวเมนต์ CLI