การติดตั้งแหล่งที่มา¶
'การติดตั้ง' แหล่งที่มาไม่ได้เกี่ยวกับการติดตั้ง 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 หากจำเป็น
ดาวน์โหลด Python 3 เวอร์ชันล่าสุด และติดตั้ง
ระหว่างการติดตั้ง ให้ทำเครื่องหมาย เพิ่ม Python 3 ไปยัง PATH จากนั้นคลิก ปรับแต่งการติดตั้ง และตรวจสอบให้แน่ใจว่าได้ทำเครื่องหมาย pip แล้ว
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
ดาวน์โหลด PostgreSQL (เวอร์ชันที่รองรับ: 12.0 หรือสูงกว่า) แล้วติดตั้ง
ใช้ 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:
เปิด pgAdmin
ดับเบิลคลิกที่เซิร์ฟเวอร์เพื่อสร้างการเชื่อมต่อ
เลือก
ป้อนชื่อผู้ใช้ในช่อง ชื่อบทบาท (เช่น
odoo
)เปิดแท็บ คำจำกัดความ ป้อนรหัสผ่าน (เช่น
odoo
) แล้วคลิก บันทึกเปิดแท็บ สิทธิ์ และเปลี่ยน สามารถเข้าสู่ระบบได้หรือไม่ เป็น 'ใช่' และ สร้างฐานข้อมูล? เป็น 'ใช่'
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Note
เนื่องจากผู้ใช้ PostgreSQL มีชื่อเดียวกับข้อมูลเข้าสู่ระบบ Unix คุณจึงสามารถเชื่อมต่อกับฐานข้อมูลได้โดยไม่ต้องใช้รหัสผ่าน
การพึ่งพา¶
การใช้ แพ็คเกจการแจกจ่าย เป็นวิธีที่แนะนำในการติดตั้งการขึ้นต่อกัน หรือติดตั้งการขึ้นต่อกันของ Python ด้วย pip
บน Debian/Ubuntu คำสั่งต่อไปนี้ควรติดตั้งแพ็คเกจที่จำเป็น:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh
script will parse the debian/control file and install the found packages.
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++ ในแท็บ ภาระงาน และติดตั้งเมื่อได้รับแจ้ง
การขึ้นต่อกันของ Odoo จะแสดงอยู่ในไฟล์ requirements.txt
ซึ่งอยู่ที่รากของไดเร็กทอรี Odoo คอมมูนิตี้
Tip
ไม่ควรผสมแพ็คเกจโมดูล Python ระหว่างอินสแตนซ์ต่างๆ ของ Odoo หรือกับระบบ อย่างไรก็ตาม คุณสามารถใช้ virtualenv เพื่อสร้างสภาพแวดล้อม Python แบบแยกได้
นำทางไปยังเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ (CommunityPath
) และเรียกใช้ pip บนไฟล์ข้อกำหนดในเทอร์มินัล ด้วยสิทธิ์ของผู้ดูแลระบบ:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
การขึ้นต่อกันของ Odoo จะแสดงอยู่ในไฟล์ requirements.txt
ซึ่งอยู่ที่รากของไดเร็กทอรี Odoo คอมมูนิตี้
Tip
ไม่ควรผสมแพ็คเกจโมดูล Python ระหว่างอินสแตนซ์ต่างๆ ของ Odoo หรือกับระบบ อย่างไรก็ตาม คุณสามารถใช้ virtualenv เพื่อสร้างสภาพแวดล้อม Python แบบแยกได้
นำทางไปยังเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ (CommunityPath
) และเรียกใช้ pip ในไฟล์ข้อกำหนด:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
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\
)
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
โดยที่ CommunityPath
คือเส้นทางของการติดตั้ง Odoo คอมมูนิตี้ และ mydb
คือชื่อของฐานข้อมูล PostgreSQL
หลังจากที่เซิร์ฟเวอร์เริ่มทำงาน (พิมพ์บันทึกข้อมูล odoo.modules.loading: กำลังโหลดโมดูล ` แล้ว) ให้เปิด http://localhost:8069 ในเว็บเบราว์เซอร์และเข้าสู่ระบบฐานข้อมูล Odoo ด้วยบัญชีผู้ดูแลระบบพื้นฐาน: ใช้ ` แอดมิน
เป็นอีเมล และ แอดมิน
เป็นรหัสผ่านอีกครั้ง
Tip
จากนั้น สร้างและจัดการ ผู้ใช้ใหม่
บัญชีผู้ใช้ที่ใช้ในการเข้าสู่ระบบเว็บอินเทอร์เฟซของ Odoo แตกต่างจาก
--db_user
อาร์กิวเมนต์ CLI