Esecuzione di un aggiornamento della patch alla versione del motore di un cluster

In questa sezione, spiegheremo come distribuire un aggiornamento di patch utilizzando AWS Management Console o il AWS CLI. Un aggiornamento patch è un aggiornamento all'interno della stessa versione del motore (ad esempio, l'aggiornamento di una versione del motore 3.6 a una versione più recente del motore 3.6). Puoi aggiornarlo immediatamente o durante la prossima finestra di manutenzione del cluster. Per determinare se il motore necessita di un aggiornamento, consultaDeterminazione della manutenzione in sospeso. Tieni presente che quando applichi l'aggiornamento, il cluster subirà dei tempi di inattività.

Nota

Se stai cercando di eseguire l'aggiornamento da una versione principale del motore a un'altra, ad esempio dalla 3.6 alla 5.0, consulta una delle due versioni oppureAggiornamento immediato della versione principale di Amazon DocumentDB. Aggiornamento del cluster Amazon DocumentDB tramite AWS Database Migration Service Un aggiornamento immediato della versione principale supporta solo docdb 5.0 come versione del motore di destinazione.

Esistono due requisiti di configurazione per ottenere gli ultimi aggiornamenti delle patch per la versione del motore di un cluster:

• Lo stato del cluster deve essere disponibile.

• Il cluster deve eseguire una versione precedente del motore.

Using the AWS Management Console

La procedura seguente applica gli aggiornamenti delle patch alla versione del motore del cluster utilizzando la console. Hai la possibilità di eseguire l'aggiornamento immediatamente o durante la prossima finestra di manutenzione del cluster.

1. Accedi a e apri AWS Management Console la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com/docdb.

2. Nel pannello di navigazione scegliere Clusters (Cluster). Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera aggiornare. Lo stato del cluster deve essere disponibile.

   Suggerimento

   Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu () nell'angolo in alto a sinistra della pagina.

3. Nel menu Actions (Operazioni) scegliere una delle opzioni indicate di seguito. Queste opzioni di menu sono selezionabili solo se sul cluster scelto non è in esecuzione la versione più recente del motore.

   

   • Aggiorna ora: avvia immediatamente il processo di aggiornamento. Il cluster sarà temporaneamente offline durante l'aggiornamento alla versione più recente del motore.

   • Aggiorna alla finestra successiva: avvia il processo di aggiornamento durante la successiva finestra di manutenzione del cluster. Il cluster sarà temporaneamente offline durante l'aggiornamento del cluster alla versione più recente del motore.

4. Quando si apre la finestra di conferma, scegliere una delle seguenti opzioni:

   • Aggiornamento: per aggiornare il cluster alla versione più recente del motore in base alla pianificazione scelta nel passaggio precedente.

   • Annulla: per annullare l'aggiornamento del motore del cluster e continuare con la versione corrente del motore del cluster.

Using the AWS CLI

È possibile applicare gli aggiornamenti delle patch al cluster utilizzando l'apply-pending-maintenance-actionoperazione AWS CLI and con i seguenti parametri.

Parametri

• --resource-identifier: obbligatorio. L'ARN del cluster Amazon DocumentDB che intendi aggiornare.

• --apply-action: obbligatorio. Sono consentiti i seguenti valori. Per aggiornare la versione del motore di un cluster, utilizzare db-upgrade.

  • db-upgrade

  • system-update

• --opt-in-type: obbligatorio. Sono consentiti i seguenti valori.

  • immediate—Applica immediatamente l'azione di manutenzione.

  • next-maintenance—Applica l'azione di manutenzione durante la finestra di manutenzione successiva.

  • undo-opt-in—Annulla tutte le richieste di next-maintenance opt-in esistenti.

La seguente patch di esempio aggiorna la versione del motore sample-cluster alla versione 4.0.0.

Per Linux, macOS o Unix:

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

Per Windows:

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

L'aspetto dell'output di questa operazione è simile al seguente.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}