`_pmiconfig`

Skupna konfiguracija in operativna orodja za okolja Odoo PMIVerse. Repozitorij podpira življenjski cikel instance: pridobivanje repozitorijev in odvisnosti, storitve, varnostno kopiranje in obnovo, migracijo različic ter testiranje dodatkov.

Vsebuje skripte, konfiguracijo, kataloge repozitorijev, predloge storitev in skupne razvojne vire. Delujoče instance, podatki PostgreSQL, filestore, arhivi in dnevniki so zunaj te delovne kopije, običajno v /srv/pmiverse/_pmisuite<version>/.

Spodnje kazalo README povezuje komponente, portal dokumentacije pa podrobne reference ukazov, postopke, arhitekturo in izraze. Razvijalci začnite z razvojnim vodnikom za meje komponent, tok kode, stranske učinke in omejeno preverjanje.

Namen repozitorija

Okolja in izvorni repozitoriji

Skupna konfiguracija določa vzdevke baz, instance in gostitelje kopiranja, zbirke in kataloge:

config/pmiverse.conf: splošna predloga registrov baz/instanc, sinhronizacije kopij, skupnih poti in privzetih vrednosti obnove. Aktivni inventar je /srv/pmiverse/_pmiregistry/config/pmiverse.conf; drugo pot izbere PMIVERSE_CONF.
config/pmisetup.conf: skupine repozitorijev po različicah, veje, lokacije in dnevniki sinhronizacije.
data/repos/: različicni katalogi CSV in vhodne zahteve.

Posodabljalniki klonirajo in posodabljajo nastavljene repozitorije. Zbiralnik zahtev bere izvajalne zahteve lokalnih OCB, OCA in PMIVerse ter ustvari skupinske datoteke; paketov ne namešča. Oba posodabljalnika Odoo 18 po uspešnih posodobitvah OCB in repozitorija prevodov namestita tudi potrjene artefakte pmis-i18n-extra; aktivacija v bazi je ločena.

Storitve Odoo

Predloge vsebujejo konfiguracijo Odoo in enote systemd. Navodila storitev Odoo 18 ločujejo običajen zagon od izrecnega vzdrževanja cele baze ali izbranih modulov. Posodobitev repozitorijev, namestitev enot in nadgradnja modulov baz so ločene operacije.

Kopiranje, sinhronizacija in obnova

Proizvajalec kopij Odoo 18 izbira baze in poti iz centralnih registrov. Ustvari preverjene ZIP z izvozom PostgreSQL po meri in razpoložljivim filestore, uporabi hrambo po bazah (privzeto deset) ter osveži povezave na najnovejše kopije.

Oddaljeni proizvajalci ohranijo /srv/pmiverse/_pmisuite18/data/backups/. Rsync celotne zgodovine shrani kopije vsakega strežnika v ločeno mapo lokalnega strežnika obnove. Naslednja imena so sintetična; storitve in časovniki namestitve sodijo v _pmiregistry.

Oddaljeni vir	Lokalno zrcalo
`backup-a:…/data/backups/`	`…/data/backups/backup-a/`
`backup-b:…/data/backups/`	`…/data/backups/backup-b/`

Postopek prenosnika ločeno prenese samo najnovejše arhive iz izbranih gostiteljev v ravni backups-latest/ in zagotavlja spremljanje napredka ter obnovo.

Obnova razreši lokalna zrcala iz registra baz. Splošni ukaz preverja arhive, pripravi objavo baze in filestore, usklajen povratek, izbirno nevtralizacijo in konfiguracijski suhi zagon. Ciljni ukazi v _pmiregistry/scripts/restore/ ohranijo lastne izvedbe; glejte starejšo referenco.

Ustvarjanje, podvajanje, brisanje in migracija baz

Ustvarjanje inicializira Odoo 18 brez demo podatkov, nastavi skrbnika in izbrane module za dokončanje v UI; obstoječe baze in shrambe zavrne.

Obnovitev skrbnika ponastavi uporabnika ID 2 v obstoječi bazi z zasebnimi ustvarjenimi poverilnicami in izbirno aktivacijo.

Podvajanje kopira bazo in privzeto filestore. Podpira predlogo PostgreSQL ali izrecni dump/restore, zavrne obstoječe cilje in dodeli nov UUID. Kopij ne nevtralizira samodejno.

Brisanje z deletedb odstrani bazo in ustrezni filestore, s predogledom in potrditvijo cilja. Čiščenje osirotelih shramb odstrani mape brez obstoječih lokalnih baz, z izbirnim predogledom in skupnimi števili izbrisov.

Migracijski izvajalnik nadgrajuje zaporedno iz Odoo 14 prek 15, 16 in 17 na 18 z vmesnimi bazami, kopijami in dnevniki. Dopolnitve OpenUpgrade dodajajo različicam prilagojene migracije.

Testna infrastruktura in prevodi

Skupni testni viri vsebujejo konfiguracijo pytest, pripravljalnike, ogrodja dodatkov, oblikovanje/uvoze Ruff, pylint-odoo ter predloge pre-commit in CI. Infrastruktura pytest povezuje zbiranje dodatkov z imenskim prostorom Odoo in bazami izvajalnika.

Ukazi scripts/test/ izvajajo teste in lint, pripravljajo ogrodja, usklajujejo Ruff, čistijo začasne baze in objavljajo značke. Skupinski izvajalnik posreduje --keep-db vsakemu dodatku za ohranitev baz po uspehu ali napaki.

Izvoz prevodov ustvari POT za dodatek ali izbrane repozitorije prek začasnih baz Odoo. Razpoložljive izbore in poti določata izvor in pomoč CLI. Ločeni testi repozitorija preverjajo _pmiconfig, konfiguracijo, orodja ter pogodbe kopiranja/obnove in integracij.

Ukazi in združljivost Python

Integracija gostitelja namesti restore-db in dopolnjevanje Bash za obnovo, podvajanje/brisanje baz, testiranje ter vzdrževanje. Povezovalnik Python izpiše podprte različice in preveri interpreter glede na izbrani Odoo. Rezervirani pmiverse_policy_check.py je trenutno nedelujoče mesto, ne izveden preverjevalnik gostitelja.

Kazalo README

Vsaka stran določa lastno uporabo, predpogoje in omejitve.

Konfiguracija in gostiteljska orodja

Stran	Vsebina
Konfiguracija	Datoteke, registri baz/instanc in porabniki.
Samostojna orodja	Združljivost Python glede na Odoo.
Integracija	Namestitev CLI, dopolnjevanje in stanje pomočnikov.

Repozitoriji, storitve in migracije

Stran	Vsebina
Posodobitve	Katalogi, sinhronizacija in različicni posodabljalniki.
Izvajalne zahteve	Odkrivanje, filtriranje, združevanje in izhod.
Predloge	Odoo, storitve kopiranja, časovniki, rsync.
Storitve Odoo 18	Namestitev, izvajanje in ločeno vzdrževanje modulov.
Migracija 14–18	Zaporedni OpenUpgrade in operativni postopek.
Dopolnitve OpenUpgrade	Različicne migracije in integracija.

Baze in kopije

Stran	Vsebina
Obnova	Viri registra, nevtralizacija, ključavnice, arhivi, povratek.
Podvajanje	Predloga, dump/restore, filestore, dopolnjevanje.
Ustvarjanje	Nova baza, skrbnik, moduli in predaja UI.
Skrbniški dostop	ID 2 in izbirna aktivacija.
Brisanje	Baza/filestore, cilji, predogled, potrditev.
Čiščenje	Osirotele shrambe, predogled in števila.
Prenosnik	Najnovejši arhivi, storitve, spremljanje in obnova.

Razvojna infrastruktura

Stran	Vsebina
Testkit	Testiranje, oblikovanje, lint, ogrodja, pre-commit in delovni tokovi.
Pytest	Zbiranje, pogodbe, pripravljalniki, predloge.
Testi repozitorija	Omejeni izolirani testi `_pmiconfig`.
Izvoz prevodov	Začasne baze, primerjava POT in napake.

Kazalo ukazov in postopkov

Naloga	Referenca
Varnostne kopije baz in filestore Odoo 18	Postopek kopiranja
Obnova ali nevtralizacija	Splošna obnova
Vzdrževanje obnove	Arhitektura
Ohranjeni ciljni ukazi obnove	Starejša referenca
Testi enega dodatka	Izvajalnik
Testi izbranih dodatkov ali repozitorija	Skupinski izvajalnik
Lint in oblikovanje	Izvajalnik lint
Skupni Ruff	Sinhronizacija politike
Testna ogrodja dodatkov	Generator
Priprava testne konfiguracije repozitorija	Inicializacija
Objava značk	Objavljalnik
Izbor podprtega Python	Združljivost
Bližnjice in dopolnjevanje	Integracija CLI
Predloge prevodov	Izvoz POT

Postavitev repozitorija

config/                 Shared operational configuration
data/repos/             Versioned repository catalogs and requirement inputs
docs/                   Command references, runbooks, and architecture notes
openupgrade_overlays/   Version-specific migration additions
scripts/                Operational commands grouped by function
templates/              Odoo configuration and systemd source templates
testkit/                Reusable infrastructure for Odoo addon repositories
tests/                  Tests of _pmiconfig itself
tools/                  Python compatibility bridge

scripts/test/ vsebuje izvršljive izvajalnike, testkit/ njihove vire, tests/ pa preverja ta repozitorij.

Uporaba orodij

Enotnega koraka namestitve ni. Izberite README komponente ali navodila potrebne operacije. Lupinska orodja običajno potrebujejo Bash in GNU; orodja baz odjemalce PostgreSQL ter dostop do prave baze in filestore. Orodja Odoo uporabljajo konfiguracijo, izvor in podprto okolje Python ustrezne zbirke.

Glavni postopki kopiranja, storitev, testiranja in prevodov ciljajo Odoo 18. Katalogi ter konfiguracija pokrivajo 14–18, migracija celo zaporedje. Kopiranje Odoo 12 se za starejši strežnik vzdržuje v _pmiregistry. Preverite dejansko podporo komponente.

Splošni config/pmiverse.conf je pripravljalna predloga; druge konfiguracije porabniki berejo neposredno. templates/ je treba ločeno pregledati in namestiti; urejanje ali pull ne spremeni nameščene enote systemd. Inventar konkretne namestitve brez skrivnosti sodi v _pmiregistry; baze, shrambe, arhivi, poročila in dnevniki pa na dokumentirane izvajalne poti.

Pred uporabo preberite povezana navodila in trenutno pomoč. Pridobite potrebne odobritve za produkcijo, privilegije, destruktivne operacije, sinhronizacijo, commit, push in zunanje pisanje. Uporabite dokumentirani predogled, kjer obstaja. Kopije produkcije naj ostanejo nedostopne do nevtralizacije. Izvajalniki dodatkov uporabljajo začasne baze test_; lastne teste omejite po tests/README.md.

Licenca

Če ni navedeno drugače, so dokumentacija in skripte namenjene interni uporabi PMIVerse.