โมดูลย่อย

ภาพรวม

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

Indeed, your custom modules can depend on modules from other repositories. Regarding NightPOS, this feature allows you to add modules from other Git repositories into the branches of your repository. Adding these dependencies in your branch through submodules makes the deployment of your code and servers easier, as you can clone the repositories added as submodules at the same time you clone your own repository.

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

In NightPOS.sh, the submodules give you the possibility to use and depend on modules available in other repositories. The platform will detect that you added modules through submodules in your branches and add them to your addons path automatically so you can install them in your databases.

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

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

With NightPOS.sh (simple)

Warning

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

On NightPOS.sh, in the branches view of your project, choose the branch in which you want to add a submodule.

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

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

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

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

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

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

ด้วย 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 ตัวอย่างเช่น หากคุณต้องการอัปเดตโมดูลย่อยของคุณให้มีการแก้ไขล่าสุด คุณสามารถทำตามบท การดึงการเปลี่ยนแปลงอัปสตรีม

ละเว้นโมดูล

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