View a markdown version of this page

Manutenzione dei cluster elastici di Amazon DocumentDB - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Manutenzione dei cluster elastici di Amazon DocumentDB

Periodicamente, Amazon DocumentDB esegue la manutenzione sulle risorse dei cluster elastici di Amazon DocumentDB. La manutenzione comporta spesso aggiornamenti al motore del database (manutenzione elastica del cluster) o al sistema operativo sottostante del cluster elastico (aggiornamenti del sistema operativo). Gli aggiornamenti del motore di database sono patch obbligatorie e includono correzioni di sicurezza, correzioni di bug e miglioramenti al motore di database. Sebbene la maggior parte delle patch del sistema operativo siano opzionali, se non le applichi per un po' di tempo, la patch potrebbe essere obbligatoria e applicata automaticamente per mantenere il livello di sicurezza. Applica gli aggiornamenti del sistema operativo ai tuoi cluster elastici Amazon DocumentDB non appena sono disponibili.

Le patch del motore di database richiedono la disattivazione dei cluster elastici Amazon DocumentDB per un breve periodo. Una volta disponibili, queste patch vengono automaticamente programmate per essere applicate durante una prossima finestra di manutenzione programmata del cluster elastico Amazon DocumentDB.

I cluster elastici hanno le rispettive finestre di manutenzione. Le modifiche ai cluster elastici che hai scelto di non applicare immediatamente vengono applicate durante la finestra di manutenzione. Per impostazione predefinita, quando si crea un cluster elastico, Amazon DocumentDB assegna una finestra di manutenzione per il cluster elastico. Puoi scegliere la finestra di manutenzione quando crei un cluster elastico. che può anche essere modificata in qualsiasi momento per adeguarsi alla pianificazione o alle prassi del business. In genere è consigliabile scegliere finestre di manutenzione con impatto minimo sull'applicazione (per esempio, in serata o nel week end).

Visualizzazione delle azioni di manutenzione del cluster elastico in sospeso

Puoi verificare se è disponibile un aggiornamento di manutenzione per il tuo cluster elastico utilizzando. AWS CLI

Se è disponibile un aggiornamento, puoi scegliere una di queste operazioni:

  • Rimanda un'azione di manutenzione attualmente pianificata per la prossima finestra di manutenzione (solo per le patch del sistema operativo).

  • Applica immediatamente le operazioni di manutenzione.

  • Pianificare le operazioni di manutenzione perché vengano avviate durante la successiva finestra di manutenzione.

  • Pianifica l'avvio delle azioni di manutenzione durante la finestra di applicazione selezionata.

La finestra di manutenzione determina l'avvio delle operazioni in sospeso, ma non limita il tempo di esecuzione totale di tali operazioni.

Utilizzate la seguente AWS CLI operazione per determinare quali azioni di manutenzione sono in sospeso. Elenca tutte le azioni di manutenzione in sospeso:

aws docdb-elastic list-pending-maintenance-actions

L'output di questa operazione è simile al seguente (formato JSON):

{ 'ResourcePendingMaintenanceActions': [ { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] }, ], 'NextToken': 'string' }

Ottieni un'eventuale azione di manutenzione in sospeso su un determinato: resourceArn

aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' } ] } }

Parametri:

  • ResourceArn—L'Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.

  • Action—L'azione di manutenzione in sospeso applicata alla risorsa.

    Valori validi:

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • AutoAppliedAfterDate—Prima finestra di manutenzione dopo questa data. NEXT_MAINTENANCE OPT_INviene ignorato in questo caso.

  • ForcedApplyDate—Applicato indipendentemente dalla finestra di manutenzione. IMMEDIATE OPT_INviene ignorato in questo caso.

  • OptInStatus—Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo IMMEDIATE non può essere annullata.

    Valori validi:

    • IMMEDIATE—Applica immediatamente l'azione di manutenzione.

    • NEXT_MAINTENANCE—Applica l'azione di manutenzione durante la successiva finestra di manutenzione della risorsa.

    • APPLY_ON—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla prossima finestra di manutenzione per la risorsa.

    • UNDO_OPT_IN—Annulla qualsiasi richiesta esistente NEXT_MAINTENANCE o APPLY_ON facoltativa.

  • CurrentApplyDate—Visualizzato se il tipo di opt-in è. APPLY_ON

  • Description—Una descrizione dell'opzione per l'azione di manutenzione.

Aggiornamenti del motore Elastic Cluster

Con Amazon DocumentDB, puoi scegliere quando applicare le operazioni di manutenzione. Puoi decidere quando Amazon DocumentDB applica gli aggiornamenti utilizzando. AWS CLI

Applica azioni di manutenzione in sospeso:

aws docdb-elastic apply-pending-maintenance-action --resource-arn string-arn --apply-action string-enum --opt-in-type string-enum [--apply-on string-date-range]

Parametri:

  • --resource-arn—L'Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.

  • --apply-action—L'azione di manutenzione in sospeso da applicare a questa risorsa.

    Valori validi:

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • --opt-in-type—Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo IMMEDIATE non può essere annullata.

    Valori validi:

    • IMMEDIATE—Applica immediatamente l'azione di manutenzione.

    • NEXT_MAINTENANCE—Applica l'azione di manutenzione durante la successiva finestra di manutenzione della risorsa.

    • APPLY_ON—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla prossima finestra di manutenzione per la risorsa.

    • UNDO_OPT_IN—Annulla qualsiasi richiesta esistente NEXT_MAINTENANCE o APPLY_ON facoltativa.

  • [--apply-on]—Obbligatorio se il tipo di opt-in è. APPLY_ON Formato: yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm (Questa opzione utilizza l'ora UTC. L'ora di inizio può essere in qualsiasi momento futuro, compresa tra un minimo di 30 minuti e un massimo di 14 giorni, oppure la force/apply data dell'azione pendente, a seconda di quale sia la precedente. La finestra temporale dall'inizio alla fine può durare da un minimo di 30 minuti a un massimo di 8 ore.)

L'output di questa operazione è simile al seguente (formato JSON):

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'SECURITY_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'IMMEDIATE', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } }

Parametri:

  • ResourceArn—L'Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.

  • Action—L'azione di manutenzione in sospeso applicata alla risorsa.

    Valori validi:

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • AutoAppliedAfterDate—Prima finestra di manutenzione dopo questa data. NEXT_MAINTENANCE OPT_INviene ignorato in questo caso.

  • ForcedApplyDate—Applicato indipendentemente dalla finestra di manutenzione. IMMEDIATE OPT_INviene ignorato in questo caso.

  • OptInStatus—Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo IMMEDIATE non può essere annullata.

    Valori validi:

    • IMMEDIATE—Applica immediatamente l'azione di manutenzione.

    • NEXT_MAINTENANCE—Applica l'azione di manutenzione durante la successiva finestra di manutenzione della risorsa.

    • APPLY_ON—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla prossima finestra di manutenzione per la risorsa.

    • UNDO_OPT_IN—Annulla qualsiasi richiesta esistente NEXT_MAINTENANCE o APPLY_ON facoltativa.

  • CurrentApplyDate—Visualizzato se il tipo di opt-in è. APPLY_ON

  • Description—Una descrizione dell'opzione per l'azione di manutenzione.

Date di applicazione

Ogni operazione di manutenzione ha una rispettiva data di applicazione che è possibile trovare nella descrizione delle operazioni di manutenzione in attesa. Quando si legge l'output delle azioni di manutenzione in sospeso dal AWS CLI, vengono elencate tre date:

  • CurrentApplyDate—La data in cui l'azione di manutenzione verrà applicata immediatamente o durante la successiva finestra di manutenzione. Se la manutenzione è facoltativa, questo valore può essere nullo.

  • ForcedApplyDate—La data in cui la manutenzione verrà applicata automaticamente, indipendentemente dalla finestra di manutenzione.

  • AutoAppliedAfterDate—La data dopo la quale la manutenzione verrà applicata durante la finestra di manutenzione del cluster.

User-created azioni di manutenzione

In qualità di utente del cluster Amazon DocumentDBElastic, puoi avviare gli aggiornamenti delle configurazioni dei tuoi cluster.

Aggiornamento della password primaria del cluster

aws docdb-elastic update-cluster --cluster-arn string-arn [--admin-user-password string] [--auth-type string-enum] [--apply-method string-enum] [--apply-on string-date-range] #... other parameters of the API that follow here are not relevant for this configuration

Parametri:

  • --cluster-arn—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui verrà applicata l'azione di manutenzione.

  • [--admin-user-password]—La password associata all'utente amministratore.

  • [--auth-type]—Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono PLAIN_TEXT o. SECRET_ARN

  • [--apply-method]—Un valore che specifica il tipo di metodo da applicare. I valori consentiti sono IMMEDIATE e APPLY_ON. Il valore predefinito è “IMMEDIATE”.

  • [--apply-on]—Obbligatorio se lo è. apply-method APPLY_ON Formato: yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm (Questa opzione utilizza l'ora UTC. L'ora di inizio può essere in qualsiasi momento futuro, da un minimo di 30 minuti a un massimo di 14 giorni. La finestra temporale dall'inizio alla fine può durare da un minimo di 30 minuti a un massimo di 8 ore.)

L'output di questa operazione è simile al seguente (formato JSON):

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'MASTER_USER_PASSWORD_UPDATE', 'OptInStatus': 'APPLY_ON', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } }

Modifica delle finestre di manutenzione di Amazon DocumentDB

La finestra di manutenzione deve essere eseguita nel momento di utilizzo più basso e quindi potrebbe essere necessario cambiarla di tanto in tanto. Il cluster elastico non è disponibile durante questo periodo solo se vengono applicate modifiche al sistema (ad esempio una modifica delle operazioni di archiviazione su scala) che richiedono un'interruzione. Non è disponibile solo per il tempo minimo necessario per apportare le modifiche necessarie.

L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di 8 ore per ciascuna regione Amazon Web Services, che si verifica in un giorno della settimana casuale.

Per modificare la finestra di manutenzione, consulta. Modifica delle configurazioni dei cluster elastici

Aggiornamenti del sistema operativo Elastic Cluster

I cluster elastici Amazon DocumentDB richiedono occasionalmente aggiornamenti del sistema operativo. Amazon DocumentDB aggiorna il sistema operativo a una versione più recente per migliorare le prestazioni del database e il livello generale di sicurezza dei clienti. Gli aggiornamenti del sistema operativo non modificano la versione del motore di cluster di un cluster elastico Amazon DocumentDB.

La maggior parte degli aggiornamenti del sistema operativo per i cluster elastici Amazon DocumentDB sono opzionali e non hanno una data fissa per applicarli. Tuttavia, se non applichi questi aggiornamenti per un po' di tempo, potrebbero diventare obbligatori e applicati automaticamente durante la finestra di manutenzione dei cluster. Questo serve a mantenere il livello di sicurezza del database. Per evitare tempi di inattività imprevisti, applica gli aggiornamenti del sistema operativo al cluster elastico Amazon DocumentDB non appena sono disponibili e imposta la finestra di manutenzione del cluster in un momento adatto alle tue esigenze aziendali.