ProxMenux/web/messages/it/docs/oci-manager/monitor.json

{
  "meta": {
    "title": "Contenitori OCI in ProxMenux Monitor | ProxMenux",
    "description": "Ciò che ProxMenux Monitor mostra per un contenitore installato da OCI manager Apps: versioni di applicazione e immagine, nuove immagini, uscita console e terminale Proxmox VE."
  },
  "header": {
    "title": "In ProxMenux Monitor",
    "description": "Un contenitore installato da OCI manager Apps appare in VMs & LXCs come qualsiasi altro LXC. Il suo modal legge il record di installazione: versioni di applicazione e immagine, nuove immagini, uscita console e terminale.",
    "section": "OCI manager Apps"
  },
  "sections": [
    {
      "id": "intro",
      "blocks": [
        {
          "calloutInfo": {
            "title": "Il record è la fonte",
            "body": "OCI manager Apps sa cosa ha installato e da dove viene. Il Monitor legge quel record di installazione invece di interrogare il container, quindi i dati sono gli stessi se il contenitore è in esecuzione o interrotto."
          }
        },
        {
          "table": {
            "headers": [
              "Scheda",
              "Quali cambiamenti per un contenitore OCI"
            ],
            "rows": [
              [
                "Stato",
                "Un commutatore <strong>Watchdog</strong> sotto Start al boot: l'applicazione viene riavviata quando si ferma da sola"
              ],
              [
                "App",
                "L'applicazione è identificata dal record, e gli aggiornamenti sono tracciati dall'immagine"
              ],
              [
                "Aggiornamenti",
                "L'immagine viene aggiornata o l'applicazione modificata, con lo stesso flusso del menu OCI"
              ],
              [
                "Montaggi",
                "Dischi del container e directory dell’host, con il relativo utilizzo"
              ],
              [
                "Log",
                "Solo per contenitori OCI: l'uscita della console dell'applicazione"
              ]
            ]
          }
        }
      ]
    },
    {
      "id": "app",
      "title": "App",
      "intro": "La scheda <appLink>App</appLink> offre l'applicazione installata come rilevamento, con il nome, il logo, la porta e lo schema del record. Registrandolo si apre l'editor con il metodo <strong>Immagine OCI (installata da ProxMenux)</strong>, che non ha bisogno di configurazione.",
      "blocks": [
        {
          "cards": {
            "items": [
              {
                "icon": "boxes",
                "title": "Applicazione",
                "body": "La versione dell'applicazione all'interno dell'immagine, letta dall'immagine stessa: il suo ambiente o la sua etichetta <code>org.opencontainers.image.version</code>. È informativo."
              },
              {
                "icon": "archive",
                "title": "Immagine",
                "body": "La data di creazione e digest dell'immagine installata. L'aggiornamento si decide qui: il digest installato viene confrontato con quello che il registro pubblica oggi per lo stesso tag."
              }
            ]
          }
        },
        {
          "list": {
            "items": [
              "Quando il registro pubblica un nuovo digest, la scheda mostra <strong>Nuova immagine</strong> con la sua data e digest, anche se la versione dell'applicazione al suo interno non è cambiata: una ricostruzione su una base aggiornata è un aggiornamento.",
              "Quando i digest coincidono, la scheda mostra <strong>Versione</strong>.",
              "La scheda si collega al repository dell'immagine: il suo progetto GitHub, o la sua pagina Hub Docker per un'immagine ufficiale.",
              "Il collegamento di accesso utilizza l'indirizzo LAN del contenitore, anche per il membro principale di un'applicazione multi-container, che ha un secondo indirizzo sulla sua rete privata.",
              "Il pulsante <strong>Aggiorna dati</strong> rilegge il record dell’installazione e il registro delle immagini. Non vengono proposte opzioni per cercare o registrare altre applicazioni: il container contiene esattamente l’applicazione descritta nel suo record."
            ]
          }
        },
        {
          "figure": {
            "src": "/oci-manager/monitor-app-tab.png",
            "alt": "Scheda App di un contenitore OCI con la versione dell'applicazione, l'immagine e il link del repository",
            "caption": "Scheda app di un contenitore installato da OCI manager Apps."
          }
        },
        {
          "p": "Il controllo viene eseguito una volta al giorno con i controlli di aggiornamento del Monitor e <strong>Aggiorna dati</strong> lo esegue subito. Una nuova immagine viene inviata come notifica attraverso i canali configurati in <notificationsLink>Notifiche</notificationsLink>. L'aggiornamento viene applicato dalla scheda Aggiornamenti."
        }
      ]
    },
    {
      "id": "updates",
      "title": "Aggiornamenti",
      "intro": "Per un contenitore installato da OCI manager Apps la scheda Aggiornamenti mostra l'applicazione con la sua immagine installata e, quando il registro pubblica una, la nuova immagine, nello stesso formato di qualsiasi altra applicazione. Gli strumenti di aggiornamento di pacchetti e applicazioni di un normale LXC non appaiono.",
      "blocks": [
        {
          "table": {
            "headers": [
              "Pulsante",
              "Che cosa si apre"
            ],
            "rows": [
              [
                "Aggiornamento",
                "L’aggiornamento di <lifecycleLink>Gestisci applicazioni OCI installate</lifecycleLink> per questo container, nel terminale di Monitor. Può essere eseguito anche senza una nuova immagine; in quel caso non cambia nulla. In un’applicazione composta da più container aggiorna tutti i membri."
              ],
              [
                "Modifica",
                "L'editor dell'applicazione (risorse, rete, percorsi e GPU). In un'applicazione multi-container aggiunge o rimuove i percorsi e i dispositivi aggiuntivi del contenitore di applicazione e, in Immich, cambia ciò che esegue il riconoscimento."
              ],
              [
                "Recupera",
                "Sostituisce l'aggiornamento quando un'operazione sul contenitore è stata interrotta e apre il suo recupero."
              ],
              [
                "Recupera (container ripristinato)",
                "Mostrato per un container ripristinato da un backup che non ha un contratto su questo host, sotto <strong>Applicazione OCI ripristinata</strong>. Apre il <lifecycleLink>recupero</lifecycleLink> nel terminale di Monitor; Aggiorna e Modifica compaiono dopo la registrazione."
              ]
            ]
          }
        },
        {
          "p": "Modifiche esterne, directory dell’host e applicazioni composte da più container vengono gestite come nel menu OCI. Per queste applicazioni, pulsanti e opzioni compaiono solo nel container principale. Gli altri membri mostrano la propria immagine, una nota che rimanda al principale per gli aggiornamenti e un pulsante per aprirlo. Alla chiusura del terminale vengono riletti l’immagine, il record e i montaggi."
        },
        {
          "table": {
            "headers": [
              "Opzione",
              "Comportamento"
            ],
            "rows": [
              [
                "Conserva il backup eseguito prima dell'aggiornamento",
                "Ogni aggiornamento esegue il backup del container per ripristinarlo se l'aggiornamento non riesce. Con questa opzione, lo stesso backup viene mantenuto nello storage scelto e compare tra i backup del CT; su Proxmox Backup Server viene scritto un backup prima dell'aggiornamento."
              ],
              [
                "Aggiornamenti pianificati",
                "L’immagine viene aggiornata all’ora scelta solo se il registro ne pubblica una nuova, con la possibilità di attendere che abbia 1, 3, 7 o 14 giorni. Un container modificato al di fuori di ProxMenux viene saltato e segnalato."
              ]
            ]
          }
        }
      ]
    },
    {
      "id": "logs",
      "title": "Log",
      "intro": "La scheda Logs appare solo per i contenitori installati da OCI manager Apps, tra Mounts e Backups. Mostra l'uscita standard e l'errore del processo principale dell'immagine, la stessa uscita mostra <code>docker logs</code> per un contenitore Docker.",
      "blocks": [
        {
          "list": {
            "items": [
              "L'output viene mantenuto sull'host in <code>/var/log/proxmenux/oci/VMID.console.log</code> (mode 0600), dal primo avvio e attraverso riavviamenti, in modo da poter essere letto con il contenitore fermato.",
              "Il file viene ruotato a 10 MB, mantenendo tre copie compresse (<code>/etc/logrotate.d/proxmenux-oci</code>).",
              "Ogni avvio del contenitore è contrassegnato nell'uscita. La scheda mostra l'output dall'ultimo avvio per impostazione predefinita; <strong>Cronologia completa</strong> mostra anche quelli precedenti.",
              "Quando l'applicazione viene rimossa, la sua uscita viene rimossa con essa.",
              "Vengono mostrate le ultime 100, 500 o 1000 righe. Mentre il container è in esecuzione, le nuove righe sono seguite in tempo reale; scorrere verso l’alto mette in pausa il seguito e <strong>Segui</strong> lo riprende.",
              "Un filtro mostra solo le linee che contengono un testo e <strong>Scarica</strong> salva le linee caricate.",
              "I codici a colori sono rimossi e una linea che una barra di avanzamento ridisegna è mostrata nel suo stato finale.",
              "La scheda legge il file a ogni apertura; non usa una copia in cache."
            ]
          }
        },
        {
          "calloutInfo": {
            "title": "credenziali di primo avviamento",
            "body": "Le immagini che stampano una password generata sul loro primo inizio lo lasciano in questa uscita, come fa <code>docker logs</code>. L'installatore lo legge da lì per mostrarlo nel suo riassunto."
          }
        },
        {
          "figure": {
            "src": "/oci-manager/monitor-logs-tab.png",
            "alt": "Scheda di log con l'uscita della console di un contenitore OCI, il selettore della linea, il filtro e il pulsante seguente",
            "caption": "Uscita console di un contenitore OCI."
          }
        }
      ]
    },
    {
      "id": "terminal",
      "title": "Console Proxmox VE",
      "blocks": [
        {
          "p": "Un'immagine OCI esegue il proprio processo come PID 1 e nessun servizio di login, quindi la console predefinita di un LXC aprirebbe un terminale in cui nulla risponde. I contenitori installati da OCI manager Apps sono creati con <code>cmode: shell</code>: la console Proxmox VE apre una shell con <code>lxc-attach</code>, l'equivalente di <code>docker exec</code>, con l'applicazione in esecuzione intatta."
        },
        {
          "list": {
            "items": [
              "La shell è quella assegnata a root nell’immagine da <code>/etc/passwd</code>. Se root non ha una shell o l’immagine non ne include alcuna, viene mantenuta la console predefinita.",
              "La shell viene eseguita come root all'interno del contenitore, senza una password. Chi può aprirlo è deciso dal permesso <code>VM.Console</code> di Proxmox VE.",
              "Il terminale del Monitor entra nel contenitore con <code>pct enter</code>, che funziona allo stesso modo."
            ]
          }
        }
      ]
    },
    {
      "id": "mounts",
      "title": "Montaggi",
      "blocks": [
        {
          "p": "La scheda <mountsLink>Mounts</mountsLink> elenca i dischi container e le directory host del contenitore. L'uso di un disco contenitore su blocco di archiviazione come LVM-thin è letto dal filesystem del disco, che è montato solo all'interno del contenitore."
        }
      ]
    }
  ]
}