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

{
  "meta": {
    "title": "Comment une image OCI est adaptée | ProxMenux",
    "description": "Du dépôt de l’image et de son fichier Compose à un modèle vérifiable, un plan de déploiement et un LXC natif de Proxmox VE, sans Docker à l’intérieur."
  },
  "header": {
    "title": "Comment une image OCI est adaptée",
    "description": "Du dépôt de l’image et de son fichier Compose à un modèle vérifiable, un plan de déploiement et un LXC natif, sans installer Docker à l’intérieur.",
    "section": "OCI manager Apps"
  },
  "sections": [
    {
      "id": "pipeline",
      "title": "Le processus d’adaptation",
      "blocks": [
        {
          "mermaid": {
            "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": "Dépôt de l’image",
              "converter": "Convertisseur",
              "template": "Modèle JSON",
              "blockers": "Aucun point bloquant ?",
              "no": "Non",
              "yes": "Oui",
              "review": "Révision / overlay",
              "plan": "Plan de déploiement",
              "lxc": "LXC natif"
            }
          }
        },
        {
          "p": "Le convertisseur lit l’image et le fichier Compose publiés par le projet, puis produit un modèle JSON. Si des exigences n’ont pas pu être adaptées et bloquent l’installation, le modèle est révisé avant sa publication dans le catalogue. Un fichier d’ajustements vérifiés, appelé overlay, permet de résoudre ces points. Seuls les modèles sans point bloquant sont proposés à l’installation."
        }
      ]
    },
    {
      "id": "template",
      "title": "Ce que conserve le modèle",
      "blocks": [
        {
          "cards": {
            "items": [
              {
                "icon": "archive",
                "title": "Identité de l’image",
                "body": "Dépôt, tag mis à jour en continu, architecture, digest résolu et révision de la source."
              },
              {
                "icon": "braces",
                "title": "Contrat du conteneur",
                "body": "Entrypoint, Cmd, environnement, utilisateur, répertoire de travail, signal d’arrêt, ports et volumes."
              },
              {
                "icon": "layers",
                "title": "Adaptation à Proxmox VE",
                "body": "Ressources, sécurité, points de montage, périphériques, sysctls, contrôles de bon fonctionnement et adaptations nécessaires pour chacun, avec leur justification."
              },
              {
                "icon": "shield",
                "title": "Compatibilité",
                "body": "Clés prises en charge, exigences non adaptées qui bloquent l’installation et état de chaque validation."
              }
            ]
          }
        }
      ]
    },
    {
      "id": "sources",
      "title": "OCI fournit le processus ; Compose fournit l’environnement",
      "blocks": [
        {
          "table": {
            "headers": [
              "Source",
              "Exemple",
              "Résultat natif"
            ],
            "rows": [
              [
                "Métadonnées OCI",
                "<code>Entrypoint</code>, <code>Cmd</code>, <code>User</code>",
                "Proxmox VE les importe à la création du CT"
              ],
              [
                "Docker Compose",
                "<code>environment</code>, <code>volumes</code>, <code>devices</code>",
                "Entrées d’environnement LXC, <code>mpN</code> et <code>devN</code>"
              ],
              [
                "Profil ProxMenux",
                "GPU, contrôle de bon fonctionnement, identifiants",
                "Questions et adaptations vérifiées"
              ],
              [
                "Utilisateur",
                "VMID, stockage, réseau",
                "Le contrat de l’instance"
              ]
            ]
          }
        }
      ]
    },
    {
      "id": "install",
      "title": "Ce qui se passe pendant l’installation",
      "blocks": [
        {
          "steps": {
            "items": [
              {
                "title": "Résoudre la référence",
                "body": "Le registre est interrogé, l’architecture de l’hôte est sélectionnée et le digest exact désigné par le tag mis à jour en continu est fixé."
              },
              {
                "title": "Télécharger et vérifier",
                "body": "Skopeo télécharge l’image sous forme d’archive OCI. Avant toute création, chaque couche est vérifiée à l’aide de son digest, puis décompressée. Si le téléchargement est endommagé, il est tenté une seconde fois avant l’arrêt de l’installation."
              },
              {
                "title": "Créer le système de fichiers",
                "body": "<code>pct create</code> crée le rootfs à partir de l’archive et conserve les métadonnées officielles du processus de l’image."
              },
              {
                "title": "Raccorder les ressources",
                "body": "Les volumes, le réseau, l’environnement, les périphériques et les profils de sécurité déclarés sont appliqués."
              },
              {
                "title": "Console",
                "body": "La sortie console du conteneur est conservée sur l’hôte. La console de Proxmox VE ouvre un shell si l’image en contient un."
              },
              {
                "title": "Vérifier",
                "body": "Au premier démarrage, l’installation attend l’attribution d’une adresse et la réponse du service. En cas d’échec, elle n’est pas signalée comme réussie."
              },
              {
                "title": "Enregistrer la configuration",
                "body": "La configuration effective est enregistrée dans le contrat de l’instance utilisé lors des mises à jour et des recréations."
              }
            ]
          }
        }
      ]
    },
    {
      "id": "example",
      "title": "Exemple : une image avec /config et /downloads",
      "intro": "Une définition Compose courante et la configuration Proxmox VE qui en résulte. Les chemins attendus par l’application ne changent pas.",
      "blocks": [
        {
          "codeGrid": {
            "items": [
              {
                "title": "Docker Compose",
                "code": "image: lscr.io/linuxserver/example:latest\nenvironment:\n  - PUID=1000\n  - PGID=1000\nvolumes:\n  - config:/config\n  - /srv/downloads:/downloads\nports:\n  - 8080:8080"
              },
              {
                "title": "/etc/pve/lxc/VMID.conf (extrait)",
                "code": "entrypoint: /init\nmp0: local-lvm:vm-VMID-disk-1,mp=/config,backup=1,size=8G\nmp1: /srv/downloads,mp=/downloads\nnet0: name=eth0,bridge=vmbr0,ip=dhcp,type=veth\nlxc.environment.runtime: PUID=1000\nlxc.environment.runtime: PGID=1000"
              }
            ]
          }
        },
        {
          "p": "<code>mp0</code> est un second disque appartenant au conteneur, nommé <code>vm-VMID-disk-N</code> sur le stockage sélectionné. Il est monté dans <code>/config</code> et, avec <code>backup=1</code>, inclus dans la sauvegarde du conteneur. <code>mp1</code> ne crée aucun disque : il monte le répertoire de l’hôte <code>/srv/downloads</code> dans <code>/downloads</code> à l’intérieur du LXC. Le port 8080 n’est pas redirigé : le LXC possède sa propre adresse et le service y répond."
        }
      ]
    }
  ]
}