Portal dokumentacije _pmiconfig
To je kanonični portal dokumentacije repozitorija. Navigacijo omogoča po nalogi ali komponenti.
Lokacije dokumentacije
- Korenski
README.mdje kratka vstopna točka. docs/INDEX.mdje kanonični portal celotnega repozitorija.- Razvojni vodnik opisuje lastništvo kode, tok izvajanja, skupne vmesnike, napake in preverjanje.
docs/scripts/vsebuje podrobne ukazne in operativne strani, kjer obstajajo.- Lokalni
README.mdopisujejo namen in meje map. - Dokumentacija ob izvedbi ostane pri komponenti, kadar je smiselna samo tam, na primer pri migracijah.
Če je vedenje opisano večkrat, je podrobna stran iz spodnjih povezav kanonična za ta repozitorij; drugi README naj ostanejo kratki in se nanjo sklicujejo. Kanonična politika upravljanja in testiranja ostaja v _pmiguidelines.
Vrste strani: pregled uvaja obseg/meje/navigacijo, operativni postopek določa korake in varnost, referenca opisuje vmesnike/izraze/infrastrukturo, izvedbene podrobnosti pa konkretno komponento in se spreminjajo z njo.
Po nalogi
Storitve Odoo
Predloge ločijo običajen zagon od nadgradenj modulov baz. Namestitev enot in vzdrževanje vplivata na gostitelja/baze; urejanje predlog ne spremeni nameščenih storitev.
Varnostno kopiranje
Opravila berejo dejansko bazo in filestore, objavijo arhive in odstranjujejo starejše po izvedbeni politiki. Glavni postopek je Odoo 18. Skripte/enote Odoo 12 so v _pmiregistry za preostali starejši strežnik in tam dokumentirane.
Obnova
- Arhitektura in vzdrževanje.
- Kanonični splošni postopek.
- Starejši ciljni ukazi.
- Pregled komponente.
- Obnova sinhroniziranih kopij prenosnika.
Obnova in nevtralizacija spreminjata baze in lahko zamenjata filestore. Najprej uporabite dokumentirani suhi zagon in preverjen načrt okrevanja.
Čiščenje osirotelih shramb
Čiščenje lokalnih shramb odstrani cele mape brez ustreznih baz. Podpira predogled in ne briše baz.
Ustvarjanje baze
Ustvari novo bazo Odoo 18, nastavi skrbnika in namesti module. Obstoječe cilje zavrne, nepopolne ohrani.
Obnovitev skrbniškega dostopa
Ponastavi ID 2 v obstoječi bazi Odoo 18 z izbirno aktivacijo in zasebnimi datotekami gesel. Ne obide MFA in ne dodeljuje pravic.
Migracija
Izvajalnik nadgradi zaporedno od 14 do 18. Ustvari izpeljane baze in jih ob prisili lahko izbriše.
Testiranje in lint
- Združljivost Python.
- Pregled infrastrukture.
- En dodatek.
- Omejeni večmodulni ali repozitorijski zagon.
- Lint in oblikovanje.
- Sinhronizacija Ruff.
- Generator ogrodij.
- Inicializacija repozitorija.
- Objava značk.
- Testi
_pmiconfig.
Izvajalniki ustvarjajo in odstranjujejo začasne baze ter pišejo testne artefakte zunaj repozitorija. Sledite kanonični politiki in izbirajte omejene dodatke.
Prevodi
Izvedba izvoza. Orodja Odoo 18 lahko ustvarijo začasne baze in zapišejo POT v repozitorije dodatkov. Vodnik opisuje čiščenje/objavo, celotne možnosti določa pomoč skript.
Posodabljanje repozitorijev
Orodja izvajajo fetch, clone, checkout in pull: omrežne zapise ter pisanje v zunanje repozitorije.
Politika in postavitev gostitelja
Rezervirana pot preverjevalnika je nedelujoče mesto; stran dokumentira omejitev. Namestilnik CLI spreminja uporabniško ali sistemsko lupinsko integracijo in lahko zahteva privilegije.
Po komponenti
| Komponenta | Vsebina |
|---|---|
config/ |
Skupni vhodi lupine in INI za skripte/orodja. |
scripts/ |
Operativna avtomatizacija po nalogah; podrobnosti v docs/scripts/. |
scripts/clean/ |
Osirotele shrambe in predogled. |
scripts/integration/ |
Integracija, namestitev, politika, lupina, namizje, urejevalnik in okolje gostitelja. |
scripts/test/ |
Testni izvajalniki in ogrodja. |
scripts/laptop-backup/ |
Kanonična namestitev prenosnika, sinhronizacija, latest in obnova. |
tools/ |
Vmesnik za skupno združljivost Python glede na Odoo. |
templates/ |
Izvorne predloge Odoo in systemd. |
testkit/ |
Avtoritativni skupni pytest, lint, oblikovanje, pre-commit, delovni tokovi, pripravljalniki in ogrodja. |
tests/ |
Lupinski in Python testi tega repozitorija. |
openupgrade_overlays/ |
Različicne migracijske dopolnitve. |
data/ hrani različicne kataloge in zahteve. Izvajalni in sinhronizacijski dnevniki sodijo zunaj repozitorija in niso verzionirani.
Izrazi
terms/terms.md: izrazi repozitorija in poti PMIVerse.terms/smoke_test.md: osnovni preizkus delovanja.
Za verzionirano konfiguracijsko mapo tega repozitorija uporabite config/. Tudi posamezna instanca ima lahko svoj config/; ne uporabljajte nepovezanega conf/, razen če ga določa konkreten vmesnik.