Documentazione dell'infrastruttura Oracle Cloud

Riparazione senza cessazione

La riparazione non terminata (NTR) in OCI consente la manutenzione e la riparazione di componenti hardware o software di base senza la necessità di arrestare o evacuare le istanze in esecuzione.

Importante

NTR è supportato solo sulle forme Bare Metal.

Questo approccio è in contrasto con i metodi tradizionali Terminazione riparazione (TR), che richiedono l'interruzione dell'istanza prima di procedere con la manutenzione. NTR riduce al minimo le interruzioni del servizio e migliora la disponibilità delle applicazioni su OCI. NTR comprende i seguenti tipi di manutenzione:

  • Riparazioni dei tempi di inattività: le istanze vengono arrestate prima della manutenzione. Il processo richiede l'arresto o il reboot dell'host durante la manutenzione.
    • Azione istanza: STOP
  • Riparazioni in tempo reale: la manutenzione viene eseguita mentre le istanze rimangono operative. Le istanze rimangono in esecuzione, senza necessità di interruzione o spegnimento durante la manutenzione.
    • Azione istanza: NONE
  • Riparazione in background live: un caso d'uso in cui non è necessaria alcuna azione dell'utente e OCI crea un evento di manutenzione ed esegue la riparazione in background.
    • Azione istanza: NONE
Importante

Avvio della manutenzione: la manutenzione NTR inizia quando viene raggiunta la finestra dell'ora di inizio pianificata. Pianificare la manutenzione al momento desiderato per l'avvio della manutenzione.

Eventi di manutenzione

OCI fornisce eventi di manutenzione per gestire i processi di manutenzione dell'infrastruttura.

Gli eventi di manutenzione vengono creati quando l'istanza o l'host richiede manutenzione. Gli eventi notificano agli utenti le attività di manutenzione imminenti che interessano le proprie istanze. Gli eventi di manutenzione vengono visualizzati nella risorsa Gestione istanze in OCI Console. Inoltre, è possibile gestire gli eventi di manutenzione utilizzando l'interfaccia CLI o gli SDK. Tutte le interfacce consentono agli utenti di ripianificare le finestre di manutenzione, monitorare lo stato di avanzamento della manutenzione ed eseguire le necessarie azioni di pre-manutenzione o successive alla manutenzione.

Ad esempio, il collegamento seguente fornisce un esempio di classe evento di manutenzione definita in Python. InstanceMaintenanceEvent: https://docs.oracle.com/iaas/tools/python/latest/api/core/models/oci.core.models.InstanceMaintenanceEvent.html.

Interruzione riparazione

Storicamente, la risoluzione di Repair (TR) è l'unico metodo che OCI utilizza per eseguire riparazioni sull'hardware o sul software di base di un'istanza.

Questo processo richiede l'evacuazione e la cessazione dell'istanza interessata prima che possano iniziare le riparazioni. La manutenzione TR inizia quando il cliente termina l'istanza. Quindi, la manutenzione viene eseguita senza dover ripianificare la manutenzione.

Gestione degli eventi NTR mediante l'interfaccia CLI

Nella procedura riportata di seguito viene fornito un esempio di gestione degli eventi di manutenzione tramite un intero processo di manutenzione mediante l'interfaccia CLI.

Trova fase

Identificare i prossimi eventi di manutenzione dell'istanza.

Elenca eventi di manutenzione

oci compute instance-maintenance-event list --compartment-id <compartment-id>

Sostituire <compartment-id> con l'OCID del compartimento.

Esempio:

oci compute instance-maintenance-event list --compartment-id ocid1.tenancy.oc1..

Output di esempio:

{
  "data": [
    {
      "alternative-resolution-actions": [],
      "can-reschedule": true,
      "compartment-id": "ocid1.tenancy.oc1..",
      "correlation-token": "",
      "created-by": "SYSTEM",
      "defined-tags": {
        "Oracle-Tags": {
          "CreatedBy": "",
          "CreatedOn": "2026-01-29T21:51:09.112Z"
        }
      },
      "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
      "display-name": "LIVE_HOST_MAINTENANCE",
      "estimated-duration": "null",
      "freeform-tags": {},
      "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
      "instance-action": "NONE",
      "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
      "lifecycle-state": "SUCCEEDED",
      "maintenance-category": "FLEXIBLE",
      "maintenance-reason": "HARDWARE_REPLACEMENT",
      "start-window-duration": "null",
      "time-created": "2026-01-29T21:48:21.731000+00:00",
      "time-finished": "2026-01-29T23:10:42.551000+00:00",
      "time-hard-due-date": "2036-02-24T21:47:40.815000+00:00",
      "time-started": "2026-01-29T22:20:49.835000+00:00",
      "time-window-start": "2026-01-29T22:10:00+00:00"
    },
    {
      "alternative-resolution-actions": [],
      "can-reschedule": true,
      "compartment-id": "ocid1.tenancy.oc1..",
      "correlation-token": "",
      "created-by": "SYSTEM",
      "defined-tags": {},
      "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
      "display-name": "LIVE_HOST_MAINTENANCE",
      "estimated-duration": "null",
      "freeform-tags": {},
      "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
      "instance-action": "NONE",
      "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
      "lifecycle-state": "SCHEDULED",
      "maintenance-category": "FLEXIBLE",
      "maintenance-reason": "HARDWARE_REPLACEMENT",
      "start-window-duration": "null",
      "time-created": "2026-01-30T22:26:28.438000+00:00",
      "time-finished": null,
      "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
      "time-started": null,
      "time-window-start": "2036-02-11T22:25:53.697000+00:00"
    }
  ]
}

Recupera dettagli evento manutenzione istanza

Visualizzare un evento di manutenzione specifico.

oci compute instance-maintenance-event get --instance-maintenance-event-id <instance-maintenance-event-id>

Sostituire <instance-maintenance-event-id> con l'OCID dell'evento specifico.

Esempio:

oci compute instance-maintenance-event get --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1...

Output di esempio:

{
  "data": {
    "additional-details": {
      "faultDetails": "[]",
      "repairDetails": "[]"
    },
    "alternative-resolution-actions": [],
    "can-delete-local-storage": false,
    "can-reschedule": true,
    "compartment-id": "ocid1.tenancy.oc1..",
    "correlation-token": "",
    "created-by": "SYSTEM",
    "defined-tags": {},
    "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
    "display-name": "LIVE_HOST_MAINTENANCE",
    "estimated-duration": "null",
    "freeform-tags": {},
    "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
    "instance-action": "NONE",
    "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
    "lifecycle-details": null,
    "lifecycle-state": "SCHEDULED",
    "maintenance-category": "FLEXIBLE",
    "maintenance-reason": "HARDWARE_REPLACEMENT",
    "start-window-duration": "null",
    "time-created": "2026-01-30T22:26:28.438000+00:00",
    "time-finished": null,
    "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
    "time-started": null,
    "time-window-start": "2036-02-11T22:25:53.697000+00:00"
  },
  "etag": ""
}

Fase pre-manutenzione

Riprogrammare la finestra dell'ora di inizio di un evento di manutenzione dell'istanza ed eseguire tutte le azioni necessarie prima della manutenzione.

Rischedula evento manutenzione istanza

oci compute instance-maintenance-event update --instance-maintenance-event-id <instance-maintenance-event-id> --time-window-start "<time-window-start>"

Sostituire <instance-maintenance-event-id> con OCID e <time-window-start> dell'evento con l'ora di inizio desiderata in formato ISO 8601.

Esempio:

oci compute instance-maintenance-event update --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1... --time-window-start "2026-01-30T22:40:53.697000+00:00"

Output di esempio:

{
    "opc-work-request-id": "ocid1.coreservicesworkrequest.oc1.ap-sydney-1..."
}
Importante

Assicurarsi che tutte le azioni precedenti alla manutenzione siano state completate prima della finestra dell'ora di inizio pianificata.

Fase di monitoraggio

La manutenzione inizia all'ora di inizio pianificata. Attendere il completamento della manutenzione.

Monitora stato evento manutenzione istanza

Monitorare lo stato di un evento di manutenzione durante l'esecuzione.

oci compute instance-maintenance-event get --instance-maintenance-event-id <instance-maintenance-event-id>

Sostituire <instance-maintenance-event-id> con l'OCID dell'evento.

Esempio:

oci compute instance-maintenance-event get --instance-maintenance-event-id ocid1.instancemaintenanceevent.oc1.ap-sydney-1...

Output di esempio:

{
  "data": {
    "additional-details": {
      "faultDetails": "[]",
      "repairDetails": "[]"
    },
    "alternative-resolution-actions": [],
    "can-delete-local-storage": false,
    "can-reschedule": true,
    "compartment-id": "ocid1.tenancy.oc1..",
    "correlation-token": "",
    "created-by": "SYSTEM",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "",
        "CreatedOn": "2026-01-30T22:39:54.637Z"
      }
    },
    "description": "Oracle scheduled a maintenance action for your instance that will be performed without any required downtime.",
    "display-name": "LIVE_HOST_MAINTENANCE",
    "estimated-duration": "null",
    "freeform-tags": {},
    "id": "ocid1.instancemaintenanceevent.oc1.ap-sydney-1.",
    "instance-action": "NONE",
    "instance-id": "ocid1.instance.oc1.ap-sydney-1.",
    "lifecycle-details": null,
    "lifecycle-state": "PROCESSING",
    "maintenance-category": "FLEXIBLE",
    "maintenance-reason": "HARDWARE_REPLACEMENT",
    "start-window-duration": "null",
    "time-created": "2026-01-30T22:26:28.438000+00:00",
    "time-finished": null,
    "time-hard-due-date": "2036-02-25T22:25:53.697000+00:00",
    "time-started": "2026-01-30T22:42:40.371000+00:00",
    "time-window-start": "2026-01-30T22:40:53.697000+00:00"
  },
  "etag": ""
}

Fase post-manutenzione

È possibile eseguire un'azione successiva alla manutenzione, se presente, una volta completati gli eventi di manutenzione dell'istanza.