Pre-release 1.2.7: OCI fixes, 12 new catalog applications and docs updates

Last changes before version 1.2.7. OCI manager Apps - Multi-container applications start while one of their containers is being backed up: the start hook waits until vzdump releases it and does not start it twice. The DHCP client of a dependency no longer keeps the lock of the hook, so later starts do not hang, and the watchdog waits while a dependency is locked. Installing or updating ProxMenux replaces the published copies of the hook already in place. - Images built from scratch with a numeric user, such as ddns-updater, install: the container is created from a copy of the image that adds the /etc/passwd and /etc/group Proxmox VE needs, and the application runs with the user the image declares. The downloaded image stays unchanged. An image with a named user and no user database stops before anything is created, with a message that says why. Catalog - Twelve new applications: MDBListarr, CrossWatch, Free Games Claimer Remaster, Cloudreve, Poznote and AceStream HTTP Proxy, suggested in discussion #440, and the Dockur images of Chrony, Dnsmasq, Tor, Stunnel, strfry and Statping. The catalog lists 347 applications. - Their prompts, labels and notes are translated into the seven languages of the menus. Documentation - OCI manager: architecture, lifecycle and stacks pages revised, with larger diagrams and new screenshots. - Contributors: the page now thanks those developing, reviewing, translating and testing ProxMenux today and those who helped in its first steps, with new avatars. Tests for the stack start hook, the watchdog, the user database check of OCI images and the Tor installation summary.
2026-11-02 10:52:22 +00:00 · 2026-10-25 13:17:54 +01:00
parent 2f48689087
commit fc41b04e87
103 changed files with 12799 additions and 603 deletions
@@ -1,38 +1,67 @@
 {
  "meta": {
    "title": "Prispievatelia | Dokumentácia ProxMenux",
-    "description": "Poďakovanie ľuďom, vďaka ktorým ProxMenux vzniká: testerom, kontrolórom a vývojárom, ktorí sa podieľajú na každom vydaní.",
+    "description": "Za každou verziou sú ľudia, ktorí ProxMenux vyvíjajú, kontrolujú, prekladajú a testujú. Táto stránka ďakuje dnešným prispievateľom aj tým, ktorí pomohli projektu pri prvých krokoch.",
    "ogTitle": "Prispievatelia | Dokumentácia ProxMenux",
-    "ogDescription": "Zoznámte sa s prispievateľmi ProxMenux."
+    "ogDescription": "Za každou verziou sú ľudia, ktorí ProxMenux vyvíjajú, kontrolujú, prekladajú a testujú. Táto stránka ďakuje dnešným prispievateľom aj tým, ktorí pomohli projektu pri prvých krokoch."
  },
  "header": {
    "title": "Prispievatelia",
-    "description": "Projekt ProxMenux rastie vďaka svojim prispievateľom. Táto stránka oceňuje ich prácu: testovanie zostáv pred vydaním, odhaľovanie regresií, kontrolu PR a formovanie nových funkcií.",
+    "description": "Za každou verziou sú ľudia, ktorí ProxMenux vyvíjajú, kontrolujú, prekladajú a testujú. Táto stránka ďakuje dnešným prispievateľom aj tým, ktorí pomohli projektu pri prvých krokoch.",
    "section": "O projekte"
  },
-  "beyond": {
-    "title": "Ďalší prispievatelia",
-    "body": "Mnohí ďalší ľudia prispievajú hlásením chýb, návrhmi funkcií v Discussions, beta testovaním a prekladmi. Úplný zoznam prispievateľov do kódu nájdete v <extlink>grafe prispievateľov na GitHube</extlink>. Táto stránka vyzdvihuje ľudí, ktorí sa najaktívnejšie zapájajú do testovania a kontroly vydaní ProxMenuxu."
+  "active": {
+    "heading": "Vývoj, kontrola a pravidelná spolupráca",
+    "intro": "Vaso73, f3rs3n a jcastro pravidelne prispievajú vylepšeniami, opravami a kontrolami. Ich práca presahuje testovanie verzie: pomáha aj vytvárať a odlaďovať tie nasledujúce.",
+    "people": {
+      "Vaso73": "Vylepšenia a opravy v OCI manager a ProxMenux Monitor, ako aj preklad a kontrola slovenských textov.",
+      "f3rs3n": "Opravy a kontrola správania skriptov a Monitora spolu s priebežným zlepšovaním talianskeho prekladu.",
+      "jcastro": "Vývoj a ladenie funkcií OCI, zálohovania a Monitora, ako aj kontrola dokumentácie a testovanie od začiatkov projektu."
+    }
+  },
+  "code": {
+    "heading": "Ďalšie príspevky do kódu",
+    "intro": "Aj nasledujúci ľudia prispeli zmenami kódu. Odkazy umožňujú spoznať ich prácu; história GitHubu zachytáva príspevky a začlenené pull requesty.",
+    "viewWork": "Zobraziť príspevky",
+    "history": "História príspevkov",
+    "merged": "Všetky začlenené PR"
+  },
+  "community": {
+    "heading": "Komunita, ktorá aj testuje, prekladá a dokumentuje",
+    "body": "Nie každá práca má podobu kódu. Zopakovanie chyby, užitočné protokoly, testovanie iného hardvéru, zrozumiteľnejšie vysvetlenie alebo návrh zlepšenia tiež pomáhajú ProxMenuxu.",
+    "languages": "Osobitná vďaka patrí ľuďom, ktorí kontrolujú texty vo svojom jazyku. Preklady ponúk, Monitora a dokumentácie sprístupňujú projekt ďalším ľuďom a uľahčujú jeho používanie."
  },
  "testers": {
-    "heading": "Testeri a kontrolóri",
-    "intro": "Títo ľudia patrili medzi prvých prispievateľov do projektu. Testovaním, hlásením problémov a návrhmi zlepšení pomohli ProxMenuxu vyrásť do dnešnej podoby.",
-    "roles": {
-      "testing": "Testovanie",
-      "testingReviewer": "Testovanie a kontrola"
-    },
+    "heading": "Vďaka za prvé testy",
+    "intro": "Toto poďakovanie má stále svoje miesto. Títo ľudia pomáhali overovať prvé verzie, testovali projekt na vlastnom vybavení a zdieľali chyby a návrhy, keď ProxMenux začínal rásť.",
    "youtube": "YouTube"
  },
  "contribute": {
-    "heading": "Chceš prispieť?",
-    "intro": "Akýkoľvek príspevok je vítaný – kód, testovanie, dizajn, dokumentácia alebo len zdieľanie nápadov:",
-    "tester": "<strong>Tester</strong> — vyskúšajte <beta>beta kanál</beta> a pred stabilným vydaním nahláste, čo funguje a čo nie.",
-    "developer": "<strong>Vývojár</strong> — Bash, Next.js (TypeScript) a trochu Pythonu pre virtuálne prostredie prekladov (venv). PR na <gh>GitHube</gh> sú vítané.",
-    "designer": "<strong>Dizajnér</strong> — vylepšenia používateľského rozhrania, ikony a snímky obrazovky pre dokumentáciu.",
-    "ideas": "<strong>Nápady</strong> — pred vytvorením požiadavky na novú funkciu otvorte tému v <disc>GitHub Discussions</disc>."
+    "heading": "Aj tvoj príspevok je vítaný",
+    "intro": "Pomôcť môžeš malou opravou, konkrétnym testom alebo kontrolou textu. Nemusíš vytvoriť celú funkciu.",
+    "ways": {
+      "code": {
+        "title": "Kód a kontrola",
+        "body": "Vyvíjaj funkcie, opravuj chyby alebo skontroluj PR. Príručka vysvetľuje, ako pripraviť a navrhnúť zmeny."
+      },
+      "testing": {
+        "title": "Testovanie a diagnostika",
+        "body": "Vyskúšaj beta verzie a zdieľaj postup na zopakovanie problému aj protokoly, ktoré pomôžu pochopiť ho."
+      },
+      "translations": {
+        "title": "Preklady",
+        "body": "Kontroluj správy vo svojom jazyku a pomôž ich udržiavať aktuálne pri pridávaní funkcií."
+      },
+      "docs": {
+        "title": "Dokumentácia a dizajn",
+        "body": "Spresni návod, pridaj snímku obrazovky alebo zlepši rozhranie, aby sa v ňom ostatní ľahšie vyznali."
+      }
+    },
+    "guide": "Príručka pre prispievateľov",
+    "discuss": "Diskutovať s komunitou"
  },
-  "coc": {
-    "title": "Najprv si prečítajte kódex správania",
-    "body": "Pred odoslaním kódu alebo nahlásením problému si prečítajte <coclink>Pravidlá správania a osvedčené postupy</coclink>. Opisujú očakávania týkajúce sa zodpovednosti za kód, oznamovania bezpečnostných chýb a rozsahu PR."
+  "thanks": {
+    "title": "Ďakujeme, že to umožňujete",
+    "body": "Všetkým tu uvedeným aj tým, ktorí pomáhajú v issue, rozhovore či pri teste: ďakujeme za čas venovaný zlepšovaniu ProxMenuxu."
  }
 }
@@ -15,7 +15,7 @@
      "blocks": [
        {
          "mermaid": {
-            "chartCode": "flowchart LR\n A[\"{{repo}}\"] --> B[\"Compose + README\"]\n B --> C[\"{{converter}}\"]\n C --> D[\"{{template}}\"]\n D --> E{\"{{blockers}}\"}\n E -- \"{{no}}\" --> F[\"{{review}}\"]\n F --> D\n E -- \"{{yes}}\" --> G[\"{{plan}}\"]\n G --> H[\"pct create\"]\n H --> I[\"{{lxc}}\"]",
+            "chartCode": "flowchart TB\n A[\"{{repo}}\"] --> B[\"Compose + README\"]\n B --> C[\"{{converter}}\"]\n C --> D[\"{{template}}\"]\n D --> E{\"{{blockers}}\"}\n E -- \"{{no}}\" --> F[\"{{review}}\"]\n F --> D\n E -- \"{{yes}}\" --> G[\"{{plan}}\"]\n G --> H[\"pct create\"]\n H --> I[\"{{lxc}}\"]",
            "labels": {
              "repo": "Repozitár obrazu",
              "converter": "Konvertor",
@@ -76,27 +76,41 @@
    },
    {
      "id": "update",
-      "title": "Transakčná aktualizácia",
+      "title": "Ako prebieha aktualizácia a čo sa stane pri zlyhaní",
      "blocks": [
+        {
+          "p": "Aktualizácia je transakčná: najprv sa pripraví a overí nový obraz, potom sa vytvorí záloha a nahradí súborový systém aplikácie. Nová verzia sa potvrdí až po úspešnej kontrole funkčnosti. Ak po zmene kontajnera nastane chyba, vykoná sa pokus o obnovu predchádzajúcej zálohy a overí sa výsledok."
+        },
        {
          "mermaid": {
-            "chartCode": "sequenceDiagram\n participant U as {{user}}\n participant P as ProxMenux\n participant R as {{registry}}\n participant X as Proxmox VE\n U->>P: {{update}}\n P->>R: {{resolve}}\n R-->>P: digest\n P->>P: {{verify}}\n P->>X: {{backup}}\n P->>X: {{import}}\n P->>X: {{reapply}}\n X-->>P: healthcheck\n alt {{healthy}}\n  P-->>U: {{commit}}\n else {{failure}}\n  P->>X: Rollback\n  P-->>U: {{restored}}\n end",
+            "chartCode": "---\nconfig:\n  sequence:\n    wrap: true\n    actorFontSize: 18\n    messageFontSize: 18\n    width: 170\n    actorMargin: 40\n    useMaxWidth: false\n---\nsequenceDiagram\n autonumber\n participant U as {{user}}\n participant P as ProxMenux\n participant R as {{registry}}\n participant X as Proxmox VE\n U->>P: {{update}}\n P->>R: {{resolve}}\n R-->>P: {{image}}\n P->>P: {{verify}}\n P->>X: {{backup}}\n P->>X: {{import}}\n P->>X: {{reapply}}\n P->>X: {{start}}\n X-->>P: {{checked}}\n alt {{healthy}}\n  P->>P: {{commit}}\n  P-->>U: {{updated}}\n else {{failure}}\n  P->>X: {{rollback}}\n  alt {{recovered}}\n   P-->>U: {{restored}}\n  else {{restoreFailed}}\n   P-->>U: {{manual}}\n  end\n end",
            "labels": {
              "user": "Používateľ",
-              "registry": "Register OCI",
-              "update": "Aktualizovať inštanciu",
-              "resolve": "Zistiť obraz podľa značky",
-              "verify": "Overiť archív a vykonať predbežné kontroly",
-              "backup": "Zastaviť a zálohovať CT",
-              "import": "Importovať nové rootfs",
-              "reapply": "Znova použiť kontrakt",
-              "healthy": "v poriadku",
-              "failure": "zlyhanie",
-              "commit": "Kontrakt zverejnený s novým digestom",
-              "restored": "Predchádzajúca inštancia obnovená"
+              "registry": "Register obrazov OCI",
+              "update": "Aktualizovať aplikáciu",
+              "resolve": "Určiť novú verziu",
+              "image": "Stiahnuť nový obraz",
+              "verify": "Overiť obraz a požiadavky",
+              "backup": "Zastaviť kontajner a vytvoriť zálohu",
+              "import": "Nainštalovať nový súborový systém",
+              "reapply": "Použiť uloženú konfiguráciu",
+              "start": "Spustiť a skontrolovať aplikáciu",
+              "checked": "Výsledok kontroly funkčnosti",
+              "healthy": "Aplikácia funguje",
+              "failure": "Aktualizácia zlyhá",
+              "commit": "Uložiť novú verziu a konfiguráciu",
+              "updated": "Aktualizácia dokončená",
+              "rollback": "Obnoviť a skontrolovať predchádzajúcu zálohu",
+              "recovered": "Obnova je overená",
+              "restored": "Predchádzajúca verzia obnovená",
+              "restoreFailed": "Obnova nie je overená",
+              "manual": "Obnova čaká: skontrolujte chybu"
            }
          }
        },
+        {
+          "p": "Ak príprava alebo predbežné kontroly zlyhajú, aktualizácia sa preruší ešte pred zastavením kontajnera. Obnova zálohy kontajnera nevracia súbory v zdieľaných adresároch hostiteľa do predchádzajúceho stavu."
+        },
        {
          "list": {
            "items": [
@@ -240,13 +254,6 @@
            ]
          }
        },
-        {
-          "figure": {
-            "src": "/oci-manager/restore-offer.png",
-            "alt": "Dialóg, ktorý uvádza obnovené kontajnery a ponúka ich obnoviť",
-            "caption": "Obnova ponúknutá po otvorení Spravovať nainštalované aplikácie OCI."
-          }
-        },
        {
          "table": {
            "headers": [
@@ -335,13 +342,6 @@
            "title": "Kontajner, ktorý sa vráti",
            "body": "Kontajner obnovený s pôvodným ID zo staršej zálohy, vrátený do snímky alebo presunutý späť z iného uzla nesie kontrakt svojho aktuálneho stavu. Ak sa pri výbere na operáciu jeho kontrakt líši od kontraktu na tomto hostiteľovi, operácia sa nespustí a ponúkne sa obnova kontajnera."
          }
-        },
-        {
-          "figure": {
-            "src": "/oci-manager/restore-result.png",
-            "alt": "Výsledok obnovy so súkromnou sieťou, poradím spúšťania a zaregistrovanými kontajnermi",
-            "caption": "Výsledok zotavenia, krok za krokom."
-          }
        }
      ]
    },
@@ -368,7 +368,7 @@
        },
        {
          "mermaid": {
-            "chartCode": "flowchart LR\n P[\"{{prepare}}\"] --> S[\"{{stop}}\"]\n S --> B[\"{{backup}}\"]\n B --> R[\"{{replace}}\"]\n R --> H{\"{{healthy}}\"}\n H -- \"{{yes}}\" --> C[\"{{commit}}\"]\n H -- \"{{no}}\" --> X[\"{{rollback}}\"]",
+            "chartCode": "flowchart TB\n P[\"{{prepare}}\"] --> S[\"{{stop}}\"]\n S --> B[\"{{backup}}\"]\n B --> R[\"{{replace}}\"]\n R --> H{\"{{healthy}}\"}\n H -- \"{{yes}}\" --> C[\"{{commit}}\"]\n H -- \"{{no}}\" --> X[\"{{rollback}}\"]",
            "labels": {
              "prepare": "Pripravte každý obraz",
              "stop": "Stop, hlavný člen prvý",