ProxMenux/web/messages/fr/docs/oci-manager/index.json

{
  "meta": {
    "title": "OCI manager Apps | ProxMenux",
    "description": "Exécutez des images OCI officielles dans des conteneurs LXC natifs de Proxmox VE, avec des données persistantes, l’accès aux périphériques, des applications à plusieurs conteneurs et des mises à jour transactionnelles."
  },
  "header": {
    "title": "OCI manager Apps",
    "description": "Les images OCI officielles s’exécutent dans des conteneurs LXC natifs de Proxmox VE. L’image reste celle publiée par son mainteneur ; ProxMenux reproduit l’environnement que Docker Compose aurait créé autour d’elle.",
    "section": "OCI manager Apps"
  },
  "sections": [
    {
      "id": "model",
      "blocks": [
        {
          "calloutInfo": {
            "title": "Une image OCI, un LXC natif",
            "body": "Aucun moteur Docker ne s’exécute dans les conteneurs. Proxmox VE importe le système de fichiers de l’image et ses métadonnées OCI. L’application devient le processus principal d’un LXC natif, administré avec les mêmes outils que les autres conteneurs du nœud."
          }
        },
        {
          "flow": {
            "nodes": [
              {
                "label": "Source",
                "detail": "Image OCI\nCompose et documentation"
              },
              {
                "label": "ProxMenux",
                "detail": "Contrat JSON\nvalidation et planification"
              },
              {
                "label": "Proxmox VE",
                "detail": "LXC natif\nvolumes et périphériques"
              }
            ],
            "caption": "L’application d’origine est conservée : son environnement est décrit de façon déclarative, puis reproduit."
          }
        }
      ]
    },
    {
      "id": "where",
      "title": "Où le trouver",
      "intro": "Sur le nœud Proxmox, en tant que root, ouvrez <strong>OCI manager Apps (Technology Preview)</strong> dans le menu principal de ProxMenux. Le premier écran propose :",
      "blocks": [
        {
          "list": {
            "items": [
              "<strong>Rechercher des applications</strong> : rechercher par nom dans tout le catalogue.",
              "<strong>Toutes les applications</strong> : afficher le catalogue complet et le nombre d’applications.",
              "<strong>Gérer les applications OCI installées</strong> : mettre à jour, modifier, supprimer ou récupérer les applications déjà installées.",
              "<strong>Comptes de registres</strong> : gérer les comptes utilisés pour installer et mettre à jour des images provenant de registres privés.",
              "<strong>Installer une image absente du catalogue</strong> : adapter un fichier Compose, une commande <code>docker run</code> ou une référence d’image.",
              "Les catégories du catalogue, chacune avec son nombre d’applications."
            ]
          }
        },
        {
          "figure": {
            "src": "/oci-manager/main-menu.png",
            "alt": "Écran principal d’OCI manager Apps avec recherche, catalogue complet, gestion des applications, images hors catalogue et catégories.",
            "caption": "Écran principal d’OCI manager Apps."
          }
        },
        {
          "p": "La sélection d’une application affiche sa description, l’image utilisée et deux modes d’installation. <strong>Installer avec les paramètres par défaut</strong> ne application que les choix essentiels : stockage, emplacement des données, adresse et démarrage. <strong>Installer avec les paramètres avancés</strong> présente toutes les décisions dans l’ordre : VMID et ressources, stockage de chaque chemin, pont réseau et périphériques."
        },
        {
          "p": "Les applications effectivement testées affichent <strong>Vérifié</strong> dans cette vue et portent un ✓ dans les listes, que le test ait été effectué dans le laboratoire ProxMenux ou par la communauté."
        }
      ]
    },
    {
      "id": "beta",
      "title": "Pourquoi le label Technology Preview est conservé",
      "blocks": [
        {
          "p": "OCI manager Apps conserve le label <strong>Technology Preview</strong> que Proxmox VE attribue aux conteneurs d’applications créés à partir d’images OCI, dont la prise en charge a été introduite dans Proxmox VE 9.1. Ce label concerne la technologie sur laquelle repose OCI manager Apps, et non le moteur de ProxMenux : le comportement de ces conteneurs peut encore changer entre les versions de Proxmox VE. Le label restera en place jusqu’à ce que Proxmox VE considère cette prise en charge comme stable."
        },
        {
          "p": "Le moteur d’OCI manager Apps est testé dans le laboratoire ProxMenux : installation, mise à jour, modification, recréation, sauvegarde, restauration, migration et watchdog. Chaque application est vérifiée séparément. Celles qui ont été effectivement testées affichent <strong>Vérifié</strong> et portent un ✓ dans les listes."
        }
      ]
    },
    {
      "id": "translation",
      "title": "Comment Docker décrit les besoins et comment OCI manager Apps les applique",
      "blocks": [
        {
          "table": {
            "headers": [
              "Besoin",
              "Expression dans Docker",
              "Mise en œuvre par OCI manager Apps"
            ],
            "rows": [
              [
                "Exécuter l’application",
                "<code>image</code>, <code>entrypoint</code>, <code>command</code>",
                "Le rootfs OCI et le processus principal du LXC"
              ],
              [
                "Conserver la configuration",
                "<code>volumes: /config</code>",
                "Un volume persistant <code>mpN</code> inclus dans la sauvegarde, ou un répertoire de l’hôte."
              ],
              [
                "Rendre le service accessible",
                "<code>ports</code>",
                "Une adresse propre au LXC et l’URL d’accès au service."
              ],
              [
                "Utiliser du matériel",
                "<code>devices</code>, <code>group_add</code>",
                "Des entrées <code>devN</code> avec le GID effectif de l’hôte et un profil validé."
              ],
              [
                "Relier les dépendances",
                "<code>networks</code>, <code>depends_on</code>",
                "Un pont réseau privé, des adresses fixes, un ordre de démarrage et des contrôles de bon fonctionnement."
              ],
              [
                "Mettre à jour",
                "Télécharger avec <code>pull</code> et recréer",
                "Un nouveau rootfs avec le même contrat de persistance."
              ]
            ]
          }
        }
      ]
    },
    {
      "id": "kept",
      "title": "Ce qui est conservé et ce qui change",
      "blocks": [
        {
          "cards": {
            "items": [
              {
                "icon": "archive",
                "title": "Conservé",
                "body": "L’image officielle, ses chemins internes, son environnement, son processus de démarrage et sa documentation d’utilisation."
              },
              {
                "icon": "boxes",
                "title": "Adapté",
                "body": "L’environnement d’exécution : le réseau, la persistance, les périphériques, les permissions et les dépendances utilisent les mécanismes LXC natifs de Proxmox VE."
              },
              {
                "icon": "shield",
                "title": "Sans équivalent",
                "body": "Une option Compose sans équivalent sûr est signalée comme un point bloquant. Les modèles comportant des points bloquants ne sont pas proposés à l’installation, et les options sensibles doivent être confirmées pendant l’assistant."
              },
              {
                "icon": "refresh",
                "title": "Enregistré",
                "body": "Le digest de l’image, les ressources, les chemins, le réseau, les périphériques et l’appartenance à une pile sont enregistrés dans le contrat de l’instance. Les mises à jour et les recréations reproduisent ce contrat."
              }
            ]
          }
        }
      ]
    },
    {
      "id": "pages",
      "title": "Pages de cette section",
      "blocks": [
        {
          "next": {
            "items": [
              {
                "label": "Comment une image OCI est adaptée",
                "href": "/docs/oci-manager/architecture",
                "tail": "De l’image et de son fichier Compose à un LXC natif."
              },
              {
                "label": "Installer une image absente du catalogue",
                "href": "/docs/oci-manager/custom-image",
                "tail": "Un fichier Compose, une commande docker run ou une référence d’image."
              },
              {
                "label": "Données, chemins et réseau",
                "href": "/docs/oci-manager/storage-network",
                "tail": "Volumes du conteneur, répertoires de l’hôte, montages rclone et adresses."
              },
              {
                "label": "Périphériques et accélération",
                "href": "/docs/oci-manager/hardware",
                "tail": "GPU, NVIDIA, Coral, USB et autres périphériques."
              },
              {
                "label": "Applications à plusieurs conteneurs",
                "href": "/docs/oci-manager/stacks",
                "tail": "Application, base de données et cache dans des LXC coordonnés."
              },
              {
                "label": "Installer une application et contribuer au catalogue",
                "href": "/docs/oci-manager/contribute-app",
                "tail": "instructions pour l’agent, tests et demande de fusion."
              },
              {
                "label": "Installer, mettre à jour et modifier",
                "href": "/docs/oci-manager/lifecycle",
                "tail": "Le contrat de l’instance et ses opérations."
              },
              {
                "label": "Dans ProxMenux Monitor",
                "href": "/docs/oci-manager/monitor",
                "tail": "Versions, mises à jour, sortie console et terminal."
              }
            ]
          }
        }
      ]
    }
  ]
}