การติดตั้งแหล่งที่มา¶
'การติดตั้ง' แหล่งที่มาไม่ได้เกี่ยวกับการติดตั้ง 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