โมดูลย่อย

ภาพรวม

โมดูลย่อย Git ช่วยให้คุณสามารถรวมโปรเจ็กต์ Git อื่นๆ เข้ากับโค้ดของคุณ โดยไม่จำเป็นต้องคัดลอกและวางโค้ดทั้งหมด

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

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

ใน Odoo.sh โมดูลย่อยช่วยให้คุณใช้งานได้และขึ้นอยู่กับโมดูลที่มีอยู่ในที่เก็บข้อมูลอื่น แพลตฟอร์มจะตรวจพบว่าคุณได้เพิ่มโมดูลผ่านโมดูลย่อยในสาขาของคุณ และเพิ่มลงในเส้นทาง Addons ของคุณโดยอัตโนมัติ เพื่อให้คุณสามารถติดตั้งลงในฐานข้อมูลของคุณได้

If you add private repositories as submodules in your branches, you need to configure a deploy key in your Odoo.sh project settings and in your repository settings. Otherwise Odoo.sh won't be allowed to download them. The procedure is detailed in the chapter Settings > Submodules.

การเพิ่มโมดูลย่อย

ด้วย Odoo.sh (แบบง่าย)

Warning

For now it is not possible to add private repositories with this method. You can nevertheless do so with Git.

บน Odoo.sh ในมุมมองสาขาของโปรเจ็กต์ของคุณ ให้เลือกสาขาที่คุณต้องการเพิ่มโมดูลย่อย

ที่มุมขวาบน คลิกที่ปุ่ม โมดูลย่อย จากนั้นคลิกที่ รัน

../../../_images/advanced-submodules-button.png

กล่องโต้ตอบพร้อมแบบฟอร์มจะแสดงขึ้น กรอกข้อมูลดังต่อไปนี้:

  • URL ของพื้นที่เก็บข้อมูล: URL ของ SSH ของพื้นที่เก็บข้อมูล

  • สาขา: สาขาที่คุณต้องการใช้

  • เส้นทาง: โฟลเดอร์ที่คุณต้องการเพิ่มโมดูลย่อยนี้ในสาขาของคุณ

../../../_images/advanced-submodules-dialog.png

บน Github คุณสามารถรับ URL ของพื้นที่เก็บข้อมูลได้ด้วยปุ่ม โคลนหรือดาวน์โหลด ของพื้นที่เก็บข้อมูล ตรวจสอบให้แน่ใจว่า ใช้ SSH

../../../_images/advanced-submodules-github-sshurl.png

ด้วย Git (ขั้นสูง)

ในเทอร์มินัล ในโฟลเดอร์ที่โคลนพื้นที่เก็บข้อมูล Git ของคุณ ให้ชำระเงินสาขาที่คุณต้องการเพิ่มโมดูลย่อย:

$ git checkout <branch>

จากนั้นเพิ่มโมดูลย่อยโดยใช้คำสั่งด้านล่าง:

$ git submodule add -b <branch> <git@yourprovider.com>:<username/repository.git> <path>

แทนที่

  • <git@yourprovider.com>:<username/repository.git> โดย SSH URL ของที่เก็บที่คุณต้องการเพิ่มเป็นโมดูลย่อย

  • <branch> ตามสาขาที่คุณต้องการใช้ในที่เก็บข้างต้น

  • <path> ตามโฟลเดอร์ที่คุณต้องการเพิ่มโมดูลย่อยนี้

ยืนยันและผลักดันการเปลี่ยนแปลงของคุณ:

$ git commit -a && git push -u <remote> <branch>

แทนที่

  • <remote> โดยพื้นที่เก็บข้อมูลที่คุณต้องการส่งการเปลี่ยนแปลง สำหรับการตั้งค่า Git มาตรฐาน นี่คือ ต้นฉบับ

  • <branch> ตามสาขาที่คุณต้องการส่งการเปลี่ยนแปลง เป็นไปได้มากว่าสาขาที่คุณใช้ การชำระเงิน git ในขั้นตอนแรก

คุณสามารถอ่านเอกสาร git-scm.com เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับโมดูลย่อย Git ตัวอย่างเช่น หากคุณต้องการอัปเดตโมดูลย่อยของคุณให้มีการแก้ไขล่าสุด คุณสามารถทำตามบท การดึงการเปลี่ยนแปลงอัปสตรีม

ละเว้นโมดูล

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