{
  "meta": {
    "title": "OCI manager Apps | ProxMenux",
    "description": "Ejecuta imágenes OCI oficiales como contenedores LXC nativos de Proxmox VE, con datos persistentes, acceso a dispositivos, aplicaciones con varios contenedores y actualizaciones transaccionales."
  },
  "header": {
    "title": "OCI manager Apps",
    "description": "Las imágenes OCI oficiales se ejecutan como contenedores LXC nativos de Proxmox VE. Se utiliza la misma imagen que publica su desarrollador; ProxMenux reproduce el entorno que Docker Compose habría creado a su alrededor.",
    "section": "OCI manager Apps"
  },
  "sections": [
    {
      "id": "model",
      "blocks": [
        {
          "calloutInfo": {
            "title": "Una imagen OCI, un LXC nativo",
            "body": "No se ejecuta Docker Engine dentro de los contenedores. Proxmox VE importa el sistema de archivos de la imagen y sus metadatos OCI; la aplicación pasa a ser el proceso principal de un LXC nativo, administrado con las mismas herramientas que cualquier otro contenedor del nodo."
          }
        },
        {
          "flow": {
            "nodes": [
              {
                "label": "Origen",
                "detail": "Imagen OCI\nCompose y documentación"
              },
              {
                "label": "ProxMenux",
                "detail": "Contrato JSON\nvalidación y planificación"
              },
              {
                "label": "Proxmox VE",
                "detail": "LXC nativo\nvolúmenes y dispositivos"
              }
            ],
            "caption": "Se utiliza la aplicación original; su entorno se define de forma declarativa y se reproduce."
          }
        }
      ]
    },
    {
      "id": "where",
      "title": "Dónde encontrarlo",
      "intro": "OCI manager Apps se abre desde la opción <strong>OCI manager Apps (Technology Preview)</strong> del menú principal de ProxMenux, en el nodo Proxmox y como root. La primera pantalla ofrece:",
      "blocks": [
        {
          "list": {
            "items": [
              "<strong>Buscar aplicaciones</strong>: busca por nombre en todo el catálogo.",
              "<strong>Todas las aplicaciones</strong>: muestra el catálogo completo y su número de aplicaciones.",
              "<strong>Gestionar aplicaciones OCI instaladas</strong>: actualiza, modifica, elimina o recupera las aplicaciones que ya has instalado.",
              "<strong>Cuentas de registros</strong>: administra las cuentas utilizadas para instalar y actualizar imágenes de registros privados.",
              "<strong>Instalar una imagen que no esté en el catálogo</strong>: adapta un archivo Compose, un comando <code>docker run</code> o una referencia de imagen.",
              "Las categorías del catálogo, cada una con su número de aplicaciones."
            ]
          }
        },
        {
          "figure": {
            "src": "/oci-manager/main-menu.png",
            "alt": "Pantalla principal de OCI manager Apps con búsqueda, listado completo, gestión de aplicaciones, imágenes fuera del catálogo y categorías.",
            "caption": "Pantalla principal de OCI manager Apps."
          }
        },
        {
          "p": "Al seleccionar una aplicación se muestran su descripción, la imagen que utiliza y dos modos de instalación. <strong>Instalar con ajustes predeterminados</strong> solo pregunta lo esencial de cada instalación: almacenamiento, ubicación de los datos, dirección y arranque. <strong>Instalar con ajustes avanzados</strong> recorre todas las decisiones en orden: VMID y recursos, almacenamiento de cada ruta, puente de red y dispositivos."
        },
        {
          "p": "Las aplicaciones que se han probado realmente muestran <strong>Verificado</strong> en esa vista y una marca ✓ en las listas, tanto si la prueba se hizo en el laboratorio de ProxMenux como si la realizó la comunidad."
        }
      ]
    },
    {
      "id": "beta",
      "title": "Por qué lleva la etiqueta Technology Preview",
      "blocks": [
        {
          "p": "OCI manager Apps mantiene la etiqueta <strong>Technology Preview</strong> que Proxmox VE asigna a los contenedores de aplicaciones creados a partir de imágenes OCI, cuyo soporte se introdujo en Proxmox VE 9.1. La etiqueta se refiere a la tecnología sobre la que funciona OCI manager Apps, no al motor de ProxMenux: el comportamiento de estos contenedores puede cambiar entre versiones de Proxmox VE. Se mantendrá hasta que Proxmox VE considere estable ese soporte."
        },
        {
          "p": "El motor de OCI manager Apps se prueba en el laboratorio de ProxMenux: instalación, actualización, modificación, recreación, backups, restauración, migración y vigilancia. Cada aplicación se verifica por separado. Las que se han probado realmente muestran <strong>Verificado</strong> y llevan un ✓ en las listas."
        }
      ]
    },
    {
      "id": "translation",
      "title": "Cómo describe Docker los requisitos y cómo los aplica OCI manager Apps",
      "blocks": [
        {
          "table": {
            "headers": [
              "Requisito",
              "Cómo lo expresa Docker",
              "Cómo lo aplica OCI manager Apps"
            ],
            "rows": [
              [
                "Ejecutar la aplicación",
                "<code>image</code>, <code>entrypoint</code>, <code>command</code>",
                "El rootfs de la imagen OCI y el proceso principal del LXC"
              ],
              [
                "Conservar la configuración",
                "<code>volumes: /config</code>",
                "Un volumen persistente <code>mpN</code> incluido en el backup, o bien un directorio del host."
              ],
              [
                "Publicar el servicio",
                "<code>ports</code>",
                "Una dirección propia para el LXC y la URL de acceso al servicio."
              ],
              [
                "Usar hardware",
                "<code>devices</code>, <code>group_add</code>",
                "Entradas <code>devN</code> con el GID efectivo del host y un perfil validado."
              ],
              [
                "Conectar las dependencias",
                "<code>networks</code>, <code>depends_on</code>",
                "Un puente de red privado, direcciones fijas, orden de arranque y comprobaciones de estado."
              ],
              [
                "Actualizar",
                "Descargar con <code>pull</code> y recrear",
                "Un rootfs nuevo que mantiene el mismo contrato de persistencia."
              ]
            ]
          }
        }
      ]
    },
    {
      "id": "kept",
      "title": "Qué se conserva y qué cambia",
      "blocks": [
        {
          "cards": {
            "items": [
              {
                "icon": "archive",
                "title": "Se conserva",
                "body": "La imagen oficial, sus rutas internas, su entorno, su proceso de arranque y su documentación de uso."
              },
              {
                "icon": "boxes",
                "title": "Se adapta",
                "body": "El entorno de ejecución: la red, la persistencia, los dispositivos, los permisos y las dependencias utilizan los mecanismos nativos de LXC de Proxmox VE."
              },
              {
                "icon": "shield",
                "title": "Sin equivalente",
                "body": "Una opción de Compose sin una equivalencia segura se registra como un impedimento para la instalación. Las plantillas con impedimentos no se ofrecen para instalar, y las opciones sensibles requieren confirmación durante el asistente."
              },
              {
                "icon": "refresh",
                "title": "Se registra",
                "body": "El digest de la imagen, los recursos, las rutas, la red, los dispositivos y la pertenencia a una pila se guardan en el contrato de la instancia. Las actualizaciones y recreaciones reproducen ese contrato."
              }
            ]
          }
        }
      ]
    },
    {
      "id": "pages",
      "title": "Páginas de esta sección",
      "blocks": [
        {
          "next": {
            "items": [
              {
                "label": "Cómo se adapta una imagen OCI",
                "href": "/docs/oci-manager/architecture",
                "tail": "De la imagen y su archivo Compose a un LXC nativo."
              },
              {
                "label": "Instalar una imagen que no esté en el catálogo",
                "href": "/docs/oci-manager/custom-image",
                "tail": "Un archivo Compose, un comando docker run o una referencia de imagen."
              },
              {
                "label": "Datos, rutas y red",
                "href": "/docs/oci-manager/storage-network",
                "tail": "Volúmenes del contenedor, directorios del host, montajes con rclone y direcciones."
              },
              {
                "label": "Dispositivos y aceleración",
                "href": "/docs/oci-manager/hardware",
                "tail": "GPU, NVIDIA, Coral, USB y otros dispositivos."
              },
              {
                "label": "Aplicaciones con varios contenedores",
                "href": "/docs/oci-manager/stacks",
                "tail": "Aplicación, base de datos y caché en varios LXC coordinados."
              },
              {
                "label": "Instalar una aplicación y proponerla al catálogo",
                "href": "/docs/oci-manager/contribute-app",
                "tail": "instrucciones para el agente, pruebas y pull request."
              },
              {
                "label": "Instalar, actualizar y modificar",
                "href": "/docs/oci-manager/lifecycle",
                "tail": "El contrato de la instancia y sus operaciones."
              },
              {
                "label": "En ProxMenux Monitor",
                "href": "/docs/oci-manager/monitor",
                "tail": "Versiones, actualizaciones, salida de consola y terminal."
              }
            ]
          }
        }
      ]
    }
  ]
}