mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-10-08 22:46:41 +00:00
feat(oci): a notification for Modify, and the documentation under the same name
This commit is contained in:
MacRimi
@@ -89,7 +89,7 @@
|
||||
"ociStorageNetwork": "Data, paths and networking",
|
||||
"ociHardware": "Devices and acceleration",
|
||||
"ociStacks": "Multi-container applications",
|
||||
"ociLifecycle": "Install, update and recreate",
|
||||
"ociLifecycle": "Install, update and modify",
|
||||
"ociMonitor": "In ProxMenux Monitor",
|
||||
"proxmenuxScripts": "ProxMenux Scripts",
|
||||
"postInstallScript": "Post-Install Script",
|
||||
|
||||
@@ -55,7 +55,7 @@
|
||||
"table": {
|
||||
"headers": ["Read from the image", "Not in the image", "Consequence"],
|
||||
"rows": [
|
||||
["<code>Entrypoint</code>, <code>Cmd</code>, <code>User</code>, <code>WorkingDir</code> and embedded environment", "Variables that only appear in the documentation", "They are added during the installation or a recreation"],
|
||||
["<code>Entrypoint</code>, <code>Cmd</code>, <code>User</code>, <code>WorkingDir</code> and embedded environment", "Variables that only appear in the documentation", "They are added during the installation or with Modify"],
|
||||
["Volumes declared by the image", "Host directories that only a Compose file names", "Additional paths are added before installing"],
|
||||
["<code>EXPOSE</code> ports", "The URL, protocol or functional healthcheck", "The port and the way the service is checked are confirmed"],
|
||||
["Architectures and digest in the registry", "Devices, privileges or external dependencies", "None of them is enabled without a definition that asks for it"]
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
"items": [
|
||||
"<strong>Search applications</strong> — search by name across the catalog.",
|
||||
"<strong>All applications</strong> — the complete catalog, with the number of applications.",
|
||||
"<strong>Manage installed OCI applications</strong> — update, recreate, remove or recover what was installed.",
|
||||
"<strong>Manage installed OCI applications</strong> — update, modify, remove or recover what was installed.",
|
||||
"<strong>Install an image that is not in the catalog</strong> — translate a Compose file, a <code>docker run</code> command or an image reference.",
|
||||
"The catalog categories, each with its number of applications."
|
||||
]
|
||||
@@ -108,7 +108,7 @@
|
||||
{ "label": "Data, paths and networking", "href": "/docs/oci-manager/storage-network", "tail": "container disks, host directories, Rclone mounts and addresses." },
|
||||
{ "label": "Devices and acceleration", "href": "/docs/oci-manager/hardware", "tail": "GPU, NVIDIA, Coral, USB and other devices." },
|
||||
{ "label": "Multi-container applications", "href": "/docs/oci-manager/stacks", "tail": "application, database and cache as coordinated LXCs." },
|
||||
{ "label": "Install, update and recreate", "href": "/docs/oci-manager/lifecycle", "tail": "the instance contract and its operations." },
|
||||
{ "label": "Install, update and modify", "href": "/docs/oci-manager/lifecycle", "tail": "the instance contract and its operations." },
|
||||
{ "label": "In ProxMenux Monitor", "href": "/docs/oci-manager/monitor", "tail": "versions, updates, console output and terminal." }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Install, update and recreate | ProxMenux",
|
||||
"description": "The instance contract of an OCI container and the operations that use it: update, recreate, remove, recovery of an interrupted operation and recovery after a restore on this or another host."
|
||||
"title": "Install, update and modify | ProxMenux",
|
||||
"description": "The instance contract of an OCI container and the operations that use it: update, modify, remove, recovery of an interrupted operation and recovery after a restore on this or another host."
|
||||
},
|
||||
"header": {
|
||||
"title": "Install, update and recreate",
|
||||
"title": "Install, update and modify",
|
||||
"description": "Each instance keeps a reproducible contract, so its rootfs can be replaced without losing configuration or persistent data.",
|
||||
"section": "OCI manager Apps"
|
||||
},
|
||||
@@ -22,14 +22,14 @@
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "A copy of the contract travels inside the container, in <code>/.proxmenux/oci-record.json</code>, readable only by root of the container, so a backup of the container always carries the contract it had at that moment. A second copy is kept in <code>/etc/pve/priv/proxmenux/oci</code>, which every node of a cluster shares and only root of the host reads. Both are written after every installation, update and recreation."
|
||||
"p": "A copy of the contract travels inside the container, in <code>/.proxmenux/oci-record.json</code>, readable only by root of the container, so a backup of the container always carries the contract it had at that moment. A second copy is kept in <code>/etc/pve/priv/proxmenux/oci</code>, which every node of a cluster shares and only root of the host reads. Both are written after every installation, update and change."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "manage",
|
||||
"title": "Manage installed OCI applications",
|
||||
"intro": "This option of the main screen lists the registered instances with their application and image. Each one is checked against its contract before any action; a CT that no longer matches its record is neither modified nor deleted. The same update and recreation are offered in the Updates tab of <monitorLink>ProxMenux Monitor</monitorLink>.",
|
||||
"intro": "This option of the main screen lists the registered instances with their application and image. Each one is checked against its contract before any action; a CT that no longer matches its record is neither modified nor deleted. The same update and the same editor are offered in the Updates tab of <monitorLink>ProxMenux Monitor</monitorLink>.",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
@@ -45,7 +45,7 @@
|
||||
"Contract, container disks, host directories, network and devices"
|
||||
],
|
||||
[
|
||||
"Recreate: edit resources, network, paths and GPU",
|
||||
"Modify: edit resources, network, paths and GPU",
|
||||
"The editor opens with the current contract; the CT is rebuilt with the changes",
|
||||
"The data of container disks and host directories"
|
||||
],
|
||||
@@ -58,12 +58,12 @@
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "For a multi-container application the menu offers <strong>Update every container of the application</strong>, <strong>Recreate</strong> and the removal. Recreate adds or removes the extra paths and devices of the application container without rebuilding anything and, in Immich, changes what runs recognition."
|
||||
"p": "For a multi-container application the menu offers <strong>Update every container of the application</strong>, <strong>Modify extra paths and devices</strong>, <strong>Recreate every container with its saved configuration</strong> and the removal. Modify adds or removes the extra paths and devices of the application container without rebuilding anything and, in Immich, changes what runs recognition. Recreate rebuilds every container from the image it was installed with, without looking for a newer one."
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/oci-manager/manage-menu.png",
|
||||
"alt": "List of installed OCI applications and the update, recreate and remove options",
|
||||
"alt": "List of installed OCI applications and the update, modify and remove options",
|
||||
"caption": "Manage installed OCI applications."
|
||||
}
|
||||
}
|
||||
@@ -126,7 +126,7 @@
|
||||
{
|
||||
"id": "recovery",
|
||||
"title": "Recovering an interrupted operation",
|
||||
"intro": "Update and recreation use a persistent transaction. If the process, the terminal or the node is interrupted after the CT stops, the operation is not taken as finished.",
|
||||
"intro": "An update and a change use a persistent transaction. If the process, the terminal or the node is interrupted after the CT stops, the operation is not taken as finished.",
|
||||
"blocks": [
|
||||
{
|
||||
"steps": {
|
||||
|
||||
@@ -31,7 +31,7 @@
|
||||
],
|
||||
[
|
||||
"Updates",
|
||||
"The image is updated or the container recreated, with the same flow as the OCI menu"
|
||||
"The image is updated or the application modified, with the same flow as the OCI menu"
|
||||
],
|
||||
[
|
||||
"Mounts",
|
||||
@@ -107,8 +107,8 @@
|
||||
"The update of <lifecycleLink>Manage installed OCI applications</lifecycleLink> for this container, in the Monitor terminal. It can run whether or not there is a new image; with none, nothing is changed. In a multi-container application it updates every member."
|
||||
],
|
||||
[
|
||||
"Recreate",
|
||||
"The recreation editor (resources, network, paths and GPU). In a multi-container application it adds or removes the extra paths and devices of the application container and, in Immich, changes what runs recognition."
|
||||
"Modify",
|
||||
"The editor of the application (resources, network, paths and GPU). In a multi-container application it adds or removes the extra paths and devices of the application container and, in Immich, changes what runs recognition."
|
||||
],
|
||||
[
|
||||
"Recover",
|
||||
@@ -116,7 +116,7 @@
|
||||
],
|
||||
[
|
||||
"Recover (restored container)",
|
||||
"Shown for a container restored from a backup that has no contract on this host, under <strong>Restored OCI application</strong>. Opens the <lifecycleLink>recovery</lifecycleLink> in the Monitor terminal; Update and Recreate appear once it is registered."
|
||||
"Shown for a container restored from a backup that has no contract on this host, under <strong>Restored OCI application</strong>. Opens the <lifecycleLink>recovery</lifecycleLink> in the Monitor terminal; Update and Modify appear once it is registered."
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
@@ -295,7 +295,7 @@
|
||||
{
|
||||
"id": "manage",
|
||||
"title": "Managing an installed stack",
|
||||
"intro": "In <strong>Manage installed OCI applications</strong>, any member leads to the whole stack. The menu of a stack offers <strong>Update every container of the application</strong>, <strong>Recreate: add or remove extra paths and devices</strong> and <strong>Remove: delete the application and its containers</strong>.",
|
||||
"intro": "In <strong>Manage installed OCI applications</strong>, any member leads to the whole stack. The menu of a stack offers <strong>Update every container of the application</strong>, <strong>Modify extra paths and devices</strong>, <strong>Recreate every container with its saved configuration</strong> and <strong>Remove: delete the application and its containers</strong>. Recreate rebuilds every container from the image it was installed with, by its saved digest and without looking for a newer one, with the same steps as an update; it is offered for the stacks that can be updated.",
|
||||
"blocks": [
|
||||
{
|
||||
"steps": {
|
||||
@@ -330,7 +330,7 @@
|
||||
{
|
||||
"table": {
|
||||
"headers": [
|
||||
"Recreate",
|
||||
"Modify",
|
||||
"What changes",
|
||||
"What is kept"
|
||||
],
|
||||
|
||||
@@ -89,7 +89,7 @@
|
||||
"ociStorageNetwork": "Datos, rutas y red",
|
||||
"ociHardware": "Dispositivos y aceleración",
|
||||
"ociStacks": "Aplicaciones multicontenedor",
|
||||
"ociLifecycle": "Instalar, actualizar y recrear",
|
||||
"ociLifecycle": "Instalar, actualizar y modificar",
|
||||
"ociMonitor": "En ProxMenux Monitor",
|
||||
"proxmenuxScripts": "ProxMenux Scripts",
|
||||
"postInstallScript": "Script Post-instalación",
|
||||
|
||||
@@ -55,7 +55,7 @@
|
||||
"table": {
|
||||
"headers": ["Se lee de la imagen", "No está en la imagen", "Consecuencia"],
|
||||
"rows": [
|
||||
["<code>Entrypoint</code>, <code>Cmd</code>, <code>User</code>, <code>WorkingDir</code> y entorno integrado", "Variables que solo aparecen en la documentación", "Se añaden durante la instalación o una recreación"],
|
||||
["<code>Entrypoint</code>, <code>Cmd</code>, <code>User</code>, <code>WorkingDir</code> y entorno integrado", "Variables que solo aparecen en la documentación", "Se añaden durante la instalación o con Modificar"],
|
||||
["Volúmenes declarados por la imagen", "Directorios del host que solo nombra un archivo Compose", "Las rutas adicionales se añaden antes de instalar"],
|
||||
["Puertos <code>EXPOSE</code>", "La URL, el protocolo o un healthcheck funcional", "Se confirman el puerto y la forma de comprobar el servicio"],
|
||||
["Arquitecturas y digest del registro", "Dispositivos, privilegios o dependencias externas", "Ninguno se activa sin una definición que lo pida"]
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
"items": [
|
||||
"<strong>Buscar aplicaciones</strong>: búsqueda por nombre en todo el catálogo.",
|
||||
"<strong>Todas las aplicaciones</strong>: el catálogo completo, con el número de aplicaciones.",
|
||||
"<strong>Gestionar aplicaciones OCI instaladas</strong>: actualizar, recrear, eliminar o recuperar lo instalado.",
|
||||
"<strong>Gestionar aplicaciones OCI instaladas</strong>: actualizar, modificar, eliminar o recuperar lo instalado.",
|
||||
"<strong>Instalar una imagen que no está en el catálogo</strong>: traducción de 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."
|
||||
]
|
||||
@@ -108,7 +108,7 @@
|
||||
{ "label": "Datos, rutas y red", "href": "/docs/oci-manager/storage-network", "tail": "discos del contenedor, directorios del host, montajes Rclone y direcciones." },
|
||||
{ "label": "Dispositivos y aceleración", "href": "/docs/oci-manager/hardware", "tail": "GPU, NVIDIA, Coral, USB y otros dispositivos." },
|
||||
{ "label": "Aplicaciones multicontenedor", "href": "/docs/oci-manager/stacks", "tail": "aplicación, base de datos y caché como LXC coordinados." },
|
||||
{ "label": "Instalar, actualizar y recrear", "href": "/docs/oci-manager/lifecycle", "tail": "el contrato de la instancia y sus operaciones." },
|
||||
{ "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." }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Instalar, actualizar y recrear | ProxMenux",
|
||||
"description": "El contrato de instancia de un contenedor OCI y las operaciones que lo usan: actualizar, recrear, eliminar, recuperar una operación interrumpida y recuperar tras una restauración en este u otro host."
|
||||
"title": "Instalar, actualizar y modificar | ProxMenux",
|
||||
"description": "El contrato de instancia de un contenedor OCI y las operaciones que lo usan: actualizar, modificar, eliminar, recuperar una operación interrumpida y recuperar tras una restauración en este u otro host."
|
||||
},
|
||||
"header": {
|
||||
"title": "Instalar, actualizar y recrear",
|
||||
"title": "Instalar, actualizar y modificar",
|
||||
"description": "Cada instancia conserva un contrato reproducible, de modo que su rootfs puede sustituirse sin perder la configuración ni los datos persistentes.",
|
||||
"section": "OCI manager Apps"
|
||||
},
|
||||
@@ -22,14 +22,14 @@
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Una copia del contrato viaja dentro del contenedor, en <code>/.proxmenux/oci-record.json</code>, legible solo por root del contenedor, así que un backup del contenedor lleva siempre el contrato que tenía en ese momento. Una segunda copia se guarda en <code>/etc/pve/priv/proxmenux/oci</code>, que comparten todos los nodos de un clúster y solo lee root del host. Las dos se escriben tras cada instalación, actualización y recreación."
|
||||
"p": "Una copia del contrato viaja dentro del contenedor, en <code>/.proxmenux/oci-record.json</code>, legible solo por root del contenedor, así que un backup del contenedor lleva siempre el contrato que tenía en ese momento. Una segunda copia se guarda en <code>/etc/pve/priv/proxmenux/oci</code>, que comparten todos los nodos de un clúster y solo lee root del host. Las dos se escriben tras cada instalación, actualización y modificación."
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "manage",
|
||||
"title": "Gestionar aplicaciones OCI instaladas",
|
||||
"intro": "Esta opción de la pantalla principal enumera las instancias registradas con su aplicación y su imagen. Cada una se contrasta con su contrato antes de cualquier acción; un CT que ya no coincide con su registro no se modifica ni se elimina. La misma actualización y la misma recreación se ofrecen en la pestaña Actualizaciones de <monitorLink>ProxMenux Monitor</monitorLink>.",
|
||||
"intro": "Esta opción de la pantalla principal enumera las instancias registradas con su aplicación y su imagen. Cada una se contrasta con su contrato antes de cualquier acción; un CT que ya no coincide con su registro no se modifica ni se elimina. La misma actualización y el mismo editor se ofrecen en la pestaña Actualizaciones de <monitorLink>ProxMenux Monitor</monitorLink>.",
|
||||
"blocks": [
|
||||
{
|
||||
"table": {
|
||||
@@ -45,7 +45,7 @@
|
||||
"Contrato, discos del contenedor, directorios del host, red y dispositivos"
|
||||
],
|
||||
[
|
||||
"Recrear: editar recursos, red, rutas y GPU",
|
||||
"Modificar: editar recursos, red, rutas y GPU",
|
||||
"El editor se abre con el contrato actual; el CT se reconstruye con los cambios",
|
||||
"Los datos de los discos del contenedor y de los directorios del host"
|
||||
],
|
||||
@@ -58,12 +58,12 @@
|
||||
}
|
||||
},
|
||||
{
|
||||
"p": "Para una aplicación multicontenedor el menú ofrece <strong>Actualizar cada contenedor de la aplicación</strong>, <strong>Recrear</strong> y la eliminación. Recrear añade o elimina las rutas y los dispositivos extra del contenedor de la aplicación sin reconstruir nada y, en Immich, cambia qué ejecuta el reconocimiento."
|
||||
"p": "Para una aplicación multicontenedor el menú ofrece <strong>Actualizar cada contenedor de la aplicación</strong>, <strong>Modificar rutas extra y dispositivos</strong>, <strong>Recrear todos los contenedores con su configuración guardada</strong> y la eliminación. Modificar añade o elimina las rutas y los dispositivos extra del contenedor de la aplicación sin reconstruir nada y, en Immich, cambia qué ejecuta el reconocimiento. Recrear reconstruye cada contenedor desde la imagen con la que se instaló, sin buscar una más nueva."
|
||||
},
|
||||
{
|
||||
"figure": {
|
||||
"src": "/oci-manager/manage-menu.png",
|
||||
"alt": "Lista de aplicaciones OCI instaladas y las opciones de actualizar, recrear y eliminar",
|
||||
"alt": "Lista de aplicaciones OCI instaladas y las opciones de actualizar, modificar y eliminar",
|
||||
"caption": "Gestionar aplicaciones OCI instaladas."
|
||||
}
|
||||
}
|
||||
@@ -126,7 +126,7 @@
|
||||
{
|
||||
"id": "recovery",
|
||||
"title": "Recuperar una operación interrumpida",
|
||||
"intro": "La actualización y la recreación usan una transacción persistente. Si el proceso, la terminal o el nodo se interrumpen después de detener el CT, la operación no se da por terminada.",
|
||||
"intro": "La actualización y la modificación usan una transacción persistente. Si el proceso, la terminal o el nodo se interrumpen después de detener el CT, la operación no se da por terminada.",
|
||||
"blocks": [
|
||||
{
|
||||
"steps": {
|
||||
|
||||
@@ -31,7 +31,7 @@
|
||||
],
|
||||
[
|
||||
"Actualizaciones",
|
||||
"Se actualiza la imagen o se recrea el contenedor, con el mismo recorrido que el menú OCI"
|
||||
"Se actualiza la imagen o se modifica la aplicación, con el mismo recorrido que el menú OCI"
|
||||
],
|
||||
[
|
||||
"Montajes",
|
||||
@@ -107,8 +107,8 @@
|
||||
"La actualización de <lifecycleLink>Gestionar aplicaciones OCI instaladas</lifecycleLink> para este contenedor, en la terminal del Monitor. Puede ejecutarse haya o no imagen nueva; sin ella, no cambia nada. En una aplicación multicontenedor actualiza todos los miembros."
|
||||
],
|
||||
[
|
||||
"Recrear",
|
||||
"El editor de la recreación (recursos, red, rutas y GPU). En una aplicación multicontenedor añade o elimina las rutas y los dispositivos extra del contenedor de la aplicación y, en Immich, cambia qué ejecuta el reconocimiento."
|
||||
"Modificar",
|
||||
"El editor de la aplicación (recursos, red, rutas y GPU). En una aplicación multicontenedor añade o elimina las rutas y los dispositivos extra del contenedor de la aplicación y, en Immich, cambia qué ejecuta el reconocimiento."
|
||||
],
|
||||
[
|
||||
"Recuperar",
|
||||
@@ -116,7 +116,7 @@
|
||||
],
|
||||
[
|
||||
"Recuperar (contenedor restaurado)",
|
||||
"Aparece en un contenedor restaurado desde un backup que no tiene contrato en este host, bajo <strong>Aplicación OCI restaurada</strong>. Abre la <lifecycleLink>recuperación</lifecycleLink> en el terminal del Monitor; Actualizar y Recrear aparecen cuando queda registrado."
|
||||
"Aparece en un contenedor restaurado desde un backup que no tiene contrato en este host, bajo <strong>Aplicación OCI restaurada</strong>. Abre la <lifecycleLink>recuperación</lifecycleLink> en el terminal del Monitor; Actualizar y Modificar aparecen cuando queda registrado."
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
@@ -171,7 +171,7 @@
|
||||
{
|
||||
"id": "manage",
|
||||
"title": "Gestión de una pila instalada",
|
||||
"intro": "En <strong>Gestionar aplicaciones OCI instaladas</strong>, cualquier miembro lleva a la pila completa. El menú de una pila ofrece <strong>Actualizar cada contenedor de la aplicación</strong>, <strong>Recrear: añadir o eliminar rutas y dispositivos extra</strong> y <strong>Eliminar: la aplicación y sus contenedores</strong>.",
|
||||
"intro": "En <strong>Gestionar aplicaciones OCI instaladas</strong>, cualquier miembro lleva a la pila completa. El menú de una pila ofrece <strong>Actualizar cada contenedor de la aplicación</strong>, <strong>Modificar rutas extra y dispositivos</strong>, <strong>Recrear todos los contenedores con su configuración guardada</strong> y <strong>Eliminar: la aplicación y sus contenedores</strong>. Recrear reconstruye cada contenedor desde la imagen con la que se instaló, por su digest guardado y sin buscar una más nueva, con los mismos pasos que una actualización; se ofrece en las pilas que se pueden actualizar.",
|
||||
"blocks": [
|
||||
{
|
||||
"steps": {
|
||||
@@ -187,7 +187,7 @@
|
||||
},
|
||||
{
|
||||
"table": {
|
||||
"headers": ["Recrear", "Qué cambia", "Qué se conserva"],
|
||||
"headers": ["Modificar", "Qué cambia", "Qué se conserva"],
|
||||
"rows": [
|
||||
["Rutas y dispositivos extra", "Se añaden al contenedor de la aplicación o se eliminan de él, y el contenedor se reinicia. No se reconstruye nada", "Los datos de la aplicación, su base de datos y los demás contenedores"],
|
||||
["Qué ejecuta el reconocimiento (Immich)", "El contenedor Machine learning toma la imagen y los dispositivos de la CPU o de una GPU del host. Toda la aplicación se detiene y se actualiza, como en una actualización", "La caché de modelos, la biblioteca y la base de datos. Si algo falla, se restauran los contenedores y la opción anteriores"]
|
||||
|
||||
Reference in New Issue
Block a user