mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 19:02:31 +00:00
219 lines
10 KiB
JSON
219 lines
10 KiB
JSON
{
|
||
"meta": {
|
||
"title": "OCI manager Apps | ProxMenux",
|
||
"description": "Führen Sie offizielle OCI-Images als native LXC-Container unter Proxmox VE aus – mit persistenten Daten, Gerätezugriff, Anwendungen aus mehreren Containern und transaktionalen Aktualisierungen."
|
||
},
|
||
"header": {
|
||
"title": "OCI manager Apps",
|
||
"description": "Offizielle OCI-Images laufen als native LXC-Container unter Proxmox VE. Das vom Maintainer veröffentlichte Image bleibt unverändert; ProxMenux bildet die Umgebung nach, die Docker Compose dafür eingerichtet hätte.",
|
||
"section": "OCI manager Apps"
|
||
},
|
||
"sections": [
|
||
{
|
||
"id": "model",
|
||
"blocks": [
|
||
{
|
||
"calloutInfo": {
|
||
"title": "Ein OCI-Image, ein nativer LXC",
|
||
"body": "In den Containern läuft keine Docker Engine. Proxmox VE importiert das Dateisystem und die OCI-Metadaten des Images. Die Anwendung wird zum Hauptprozess eines nativen LXC und lässt sich mit denselben Werkzeugen verwalten wie andere Container auf dem Knoten."
|
||
}
|
||
},
|
||
{
|
||
"flow": {
|
||
"nodes": [
|
||
{
|
||
"label": "Quelle",
|
||
"detail": "OCI-Image\nCompose und Dokumentation"
|
||
},
|
||
{
|
||
"label": "ProxMenux",
|
||
"detail": "JSON-Vertrag\nValidierung und Planung"
|
||
},
|
||
{
|
||
"label": "Proxmox VE",
|
||
"detail": "Nativer LXC\nVolumes und Geräte"
|
||
}
|
||
],
|
||
"caption": "Die Anwendung wird nicht neu gebaut. Ihre Umgebung wird deklarativ beschrieben und nachgebildet."
|
||
}
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "where",
|
||
"title": "Wo Sie es finden",
|
||
"intro": "Öffnen Sie auf dem Proxmox-Knoten als root den Eintrag <strong>OCI manager Apps (Technology Preview)</strong> im ProxMenux-Hauptmenü. Die erste Ansicht bietet:",
|
||
"blocks": [
|
||
{
|
||
"list": {
|
||
"items": [
|
||
"<strong>Anwendungen suchen</strong> – den gesamten Katalog nach Namen durchsuchen.",
|
||
"<strong>Alle Anwendungen</strong> – den vollständigen Katalog samt Anzahl der Anwendungen anzeigen.",
|
||
"<strong>Installierte OCI-Anwendungen verwalten</strong> – vorhandene Installationen aktualisieren, ändern, entfernen oder wiederherstellen.",
|
||
"<strong>Registry-Konten</strong> – Konten zum Installieren und Aktualisieren von Images aus privaten Registries verwalten.",
|
||
"<strong>Image außerhalb des Katalogs installieren</strong> – eine Compose-Datei, einen <code>docker run</code>-Befehl oder eine Image-Referenz übernehmen und anpassen.",
|
||
"Die Kategorien des Katalogs, jeweils mit der Anzahl ihrer Anwendungen."
|
||
]
|
||
}
|
||
},
|
||
{
|
||
"figure": {
|
||
"src": "/oci-manager/main-menu.png",
|
||
"alt": "Hauptansicht von OCI manager Apps mit Suche, Gesamtkatalog, Anwendungsverwaltung, eigenen Images und Katalogkategorien.",
|
||
"caption": "Hauptansicht von OCI manager Apps."
|
||
}
|
||
},
|
||
{
|
||
"p": "Nach der Auswahl einer Anwendung sehen Sie deren Beschreibung, das verwendete Image und zwei Installationsarten. <strong>Mit Standardeinstellungen installieren</strong> fragt nur die grundlegenden Entscheidungen ab: Speicher, Datenablage, Adresse und Start. <strong>Mit erweiterten Einstellungen installieren</strong> führt nacheinander durch alle Optionen: VMID und Ressourcen, Speicher für jeden Pfad, Netzwerk-Bridge und Geräte."
|
||
},
|
||
{
|
||
"p": "Tatsächlich getestete Anwendungen zeigen in dieser Ansicht <strong>Geprüft</strong> und sind in den Listen mit ✓ gekennzeichnet. Das gilt für Tests im ProxMenux-Labor ebenso wie für Tests durch die Community."
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "beta",
|
||
"title": "Warum es als Technology Preview gekennzeichnet ist",
|
||
"blocks": [
|
||
{
|
||
"p": "OCI manager Apps verwendet die Bezeichnung <strong>Technology Preview</strong>, die Proxmox VE den aus OCI-Images erstellten Anwendungscontainern zuweist. Deren Unterstützung wurde mit Proxmox VE 9.1 eingeführt. Die Bezeichnung betrifft die zugrunde liegende Proxmox-Technik, nicht die ProxMenux-Engine: Das Verhalten dieser Container kann sich zwischen Proxmox-VE-Versionen noch ändern. Die Kennzeichnung bleibt bestehen, bis Proxmox VE diese Unterstützung als stabil einstuft."
|
||
},
|
||
{
|
||
"p": "Die Funktionen von OCI manager Apps werden im ProxMenux-Labor getestet: Installation, Aktualisierung, Änderung, Neuerstellung, Sicherung, Wiederherstellung, Migration und Watchdog. Jede Anwendung wird separat geprüft. Tatsächlich getestete Anwendungen tragen die Kennzeichnung <strong>Geprüft</strong> und ein ✓ in den Listen."
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "translation",
|
||
"title": "Wie Docker Anforderungen beschreibt und OCI manager Apps sie umsetzt",
|
||
"blocks": [
|
||
{
|
||
"table": {
|
||
"headers": [
|
||
"Anforderung",
|
||
"Darstellung in Docker",
|
||
"Umsetzung durch OCI manager Apps"
|
||
],
|
||
"rows": [
|
||
[
|
||
"Anwendung ausführen",
|
||
"<code>image</code>, <code>entrypoint</code>, <code>command</code>",
|
||
"OCI-rootfs und Hauptprozess des LXC"
|
||
],
|
||
[
|
||
"Konfiguration erhalten",
|
||
"<code>volumes: /config</code>",
|
||
"Ein persistentes <code>mpN</code>-Volume, das in die Sicherung aufgenommen wird, oder ein Verzeichnis auf dem Host."
|
||
],
|
||
[
|
||
"Dienst bereitstellen",
|
||
"<code>ports</code>",
|
||
"Eine eigene Adresse für den LXC und die Zugriffs-URL des Dienstes."
|
||
],
|
||
[
|
||
"Hardware verwenden",
|
||
"<code>devices</code>, <code>group_add</code>",
|
||
"<code>devN</code>-Einträge mit der tatsächlich verwendeten Gruppen-ID (GID) des Hosts und einem validierten Profil."
|
||
],
|
||
[
|
||
"Abhängigkeiten verbinden",
|
||
"<code>networks</code>, <code>depends_on</code>",
|
||
"Eine private Netzwerk-Bridge, feste Adressen, Startreihenfolge und Zustandsprüfungen."
|
||
],
|
||
[
|
||
"Aktualisieren",
|
||
"Mit <code>pull</code> herunterladen und neu erstellen",
|
||
"Ein neues rootfs mit demselben Persistenzvertrag."
|
||
]
|
||
]
|
||
}
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "kept",
|
||
"title": "Was erhalten bleibt und was sich ändert",
|
||
"blocks": [
|
||
{
|
||
"cards": {
|
||
"items": [
|
||
{
|
||
"icon": "archive",
|
||
"title": "Bleibt erhalten",
|
||
"body": "Das offizielle Image, seine internen Pfade, seine Umgebung, sein Startprozess und seine Nutzungsdokumentation."
|
||
},
|
||
{
|
||
"icon": "boxes",
|
||
"title": "Wird angepasst",
|
||
"body": "Die Laufzeitumgebung: Netzwerk, Persistenz, Geräte, Berechtigungen und Abhängigkeiten werden mit den nativen LXC-Funktionen von Proxmox VE umgesetzt."
|
||
},
|
||
{
|
||
"icon": "shield",
|
||
"title": "Ohne Entsprechung",
|
||
"body": "Eine Compose-Option ohne sichere Entsprechung wird als Installationshindernis aufgeführt. Vorlagen mit solchen Hindernissen werden nicht zur Installation angeboten. Sensible Optionen müssen während der Installation bestätigt werden."
|
||
},
|
||
{
|
||
"icon": "refresh",
|
||
"title": "Wird gespeichert",
|
||
"body": "Image-Digest, Ressourcen, Pfade, Netzwerk, Geräte und Zugehörigkeit zu einem Stack werden im Instanzvertrag gespeichert. Aktualisierungen und Neuerstellungen bilden diesen Vertrag wieder ab."
|
||
}
|
||
]
|
||
}
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "pages",
|
||
"title": "Seiten in diesem Abschnitt",
|
||
"blocks": [
|
||
{
|
||
"next": {
|
||
"items": [
|
||
{
|
||
"label": "So wird ein OCI-Image umgesetzt",
|
||
"href": "/docs/oci-manager/architecture",
|
||
"tail": "Vom Image und seiner Compose-Datei zu einem nativen LXC."
|
||
},
|
||
{
|
||
"label": "Image außerhalb des Katalogs installieren",
|
||
"href": "/docs/oci-manager/custom-image",
|
||
"tail": "Compose-Datei, docker run oder eine Image-Referenz."
|
||
},
|
||
{
|
||
"label": "Daten, Pfade und Netzwerk",
|
||
"href": "/docs/oci-manager/storage-network",
|
||
"tail": "Container-Volumes, Host-Verzeichnisse, rclone-Mounts und Adressen."
|
||
},
|
||
{
|
||
"label": "Geräte und Beschleunigung",
|
||
"href": "/docs/oci-manager/hardware",
|
||
"tail": "GPU, NVIDIA, Coral, USB und weitere Geräte."
|
||
},
|
||
{
|
||
"label": "Anwendungen mit mehreren Containern",
|
||
"href": "/docs/oci-manager/stacks",
|
||
"tail": "Anwendung, Datenbank und Cache als koordinierte LXCs."
|
||
},
|
||
{
|
||
"label": "Eine App installieren und zum Katalog beitragen",
|
||
"href": "/docs/oci-manager/contribute-app",
|
||
"tail": "Anleitung für Agenten, Tests und Katalog-Pull-Request."
|
||
},
|
||
{
|
||
"label": "Installieren, aktualisieren und ändern",
|
||
"href": "/docs/oci-manager/lifecycle",
|
||
"tail": "Der Instanzvertrag und seine Vorgänge."
|
||
},
|
||
{
|
||
"label": "In ProxMenux Monitor",
|
||
"href": "/docs/oci-manager/monitor",
|
||
"tail": "Versionen, Aktualisierungen, Konsolenausgabe und Terminal."
|
||
}
|
||
]
|
||
}
|
||
}
|
||
]
|
||
}
|
||
]
|
||
}
|