Files

219 lines
10 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"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."
}
]
}
}
]
}
]
}