Almodulok

Áttekintés

A Git almodul lehetővé teszi más Git projektek integrálását a kódjába anélkül, hogy az összes kódjukat másolni-beilleszteni kellene.

Valóban, az egyedi moduljai függhetnek más tárolók moduljaitól. Az Odoo esetében ez a funkció lehetővé teszi, hogy más Git tárolók moduljait hozzáadja a tárolója ágaihoz. Ezeknek a függőségeknek az ágakba történő hozzáadása almodulok révén megkönnyíti a kód és a szerverek telepítését, mivel a saját tároló klónozásával egyidejűleg klónozhatja az almodulokként hozzáadott tárolókat is.

Ezenkívül kiválaszthatja az almodulként hozzáadott tároló ágát, és ellenőrizheti a kívánt revíziót. Ön dönti el, hogy rögzíti-e az almodult egy adott revízióhoz, és mikor kíván frissíteni egy újabb revízióra.

Az Odoo.sh-ban az almodulok lehetőséget adnak arra, hogy más tárolókban elérhető modulokat használjon és függjön tőlük. A platform érzékeli, hogy almodulokon keresztül modulokat adott hozzá az ágaihoz, és automatikusan hozzáadja azokat az addon útvonalához, így telepítheti azokat az adatbázisaiba.

Ha privát tárolókat ad hozzá almodulokként az ágaihoz, be kell állítania egy telepítési kulcsot az Odoo.sh projekt beállításaiban és a tároló beállításaiban. Ellenkező esetben az Odoo.sh nem fogja tudni letölteni azokat. Az eljárás részletezve van a Beállítások > Almodulok fejezetben.

Egy almodul hozzáadása

Odoo.sh használatával (egyszerű)

Figyelem

Jelenleg nem lehetséges privát adattárakat hozzáadni ezzel a módszerrel. Mindazonáltal megteheti ezt Git használatával.

Az Odoo.sh felületén, a projekt ágainak nézetében válassza ki azt az ágat, amelyhez almodult szeretne hozzáadni.

A jobb felső sarokban kattintson a Submodule gombra, majd a Run gombra.

Egy űrlappal ellátott párbeszédablak jelenik meg. Töltse ki a mezőket az alábbiak szerint:

• Repository URL: Az adattár SSH URL-je.

• Branch: Az ág, amelyet használni szeretne.

• Path: A mappa, amelybe ezt az almodult szeretné hozzáadni az ágában.

A Githubon az adattár URL-jét a Clone or download gombbal szerezheti meg az adattárból. Ügyeljen arra, hogy SSH-t használjon.

Git használatával (haladó)

Egy terminálban, abban a mappában, ahol a Git tárolója klónozva van, váltson arra az ágakra, amelyhez almodult szeretne hozzáadni:

$ git checkout <branch>

Ezután adja hozzá az almodult az alábbi parancs segítségével:

$ git submodule add -b <branch> <[email protected]>:<username/repository.git> <path>

Cserélje le

• <[email protected]>:<username/repository.git> az almodulként hozzáadni kívánt tároló SSH URL-jére,

• <branch> az adott tárolóban használni kívánt ágra,

• <path> arra a mappára, amelybe ezt az almodult hozzá szeretné adni.

Kötelezze el és tolja fel a változtatásait:

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

Cserélje le

• <remote> arra a tárolóra, amelyre a változtatásait fel szeretné tolni. Egy standard Git beállítás esetén ez origin.

• <branch> arra az ágra, amelyre a változtatásait fel szeretné tolni. Valószínűleg az az ág, amelyre az első lépésben git checkout-ot használt.

A Git almodulokkal kapcsolatos további részletekért olvassa el a git-scm.com dokumentációt. Például, ha frissíteni szeretné almoduljait a legújabb verzióra, kövesse a Pulling in Upstream changes fejezetet.

Modulok figyelmen kívül hagyása

Ha olyan repozitóriumot ad hozzá, amely sok modult tartalmaz, érdemes lehet figyelmen kívül hagyni néhányat közülük, ha vannak olyanok, amelyek automatikusan települnek. Ehhez előtagként használhat egy . jelet az almodul mappájánál. A platform figyelmen kívül hagyja ezt a mappát, és kézzel választhatja ki a modulokat, ha szimbolikus linkeket hoz létre egy másik mappából.