Aggiornamento a una nuova versione principale
Quando le principali versioni del database raggiungono la fine del ciclo di vita (EOL), l'aggiornamento alla versione successiva disponibile garantisce un supporto continuo e prestazioni ottimali. Redis i dettagli sulla versione possono essere trovati nel catalogo, con il plug-in Cloud Databases CLI o attraverso l'API Cloud Databases.
Percorso di aggiornamento semplice
Poiché la maggior parte degli utilizzi di Databases for Redis fungono da cache in cui i dati tendono ad essere transitori, è meglio creare una nuova distribuzione. In questo semplice metodo, esegui il provisioning di una nuova distribuzione utilizzando la versione più recente di Databases for Redis e quindi punta la tua applicazione alla nuova distribuzione. In questo modo la cache viene creata direttamente tramite l'utilizzo iniziale.
Come eseguire l'aggiornamento a una nuova versione principale
Prepararsi per l'esecuzione e quindi migrare alla versione più recente prima della data EOL. Per ulteriori informazioni, vedere Criteri di versionamento.
Il rollback delle versioni non è supportato.
Eseguire l'aggiornamento all'ultima versione di Redis disponibile per Databases for Redis. Trova la versione più recente dalla pagina del catalogo, dal comando del plug-in della CLI Cloud Databases ibmcloud cdb deployables-showo dall'endpoint Cloud Databases API /deployables.
L'aggiornamento viene gestito ripristinando un backup dei tuoi dati in una nuova distribuzione. Il ripristino da un backup ha diversi vantaggi:
- Il database originale rimane in esecuzione e il lavoro di produzione può non essere interrotto.
- Puoi verificare il nuovo database all'esterno della produzione e agire su ogni incompatibilità dell'applicazione.
- L'intero processo può essere ripetuto in qualsiasi momento.
- Un nuovo ripristino riduce la probabilità che gli artefatti non necessari della versione precedente del database vengano trasferiti nel nuovo database.
Percorsi di aggiornamento
| Versione corrente | Percorso di aggiornamento della versione principale |
|---|---|
| Databases for Redis V7.2 | -> Databases for Redis V8.2 |
Aggiornamento utilizzando l'interfaccia utente
Per i nuovi modelli di hosting, l'aggiornamento a una nuova versione principale è attualmente disponibile tramite la CLI e l'API.
Aggiornare a una nuova versione quando si ripristina un backup dalla scheda Backup e ripristino nella pagina Panoramica dell'installazione client. Fare clic su Ripristina backup nel menu di overflow o nella riga della tabella espansa del backup scelto. Si apre la pagina di ripristino del provisioning, dove è possibile selezionare le opzioni per la nuova distribuzione. Una delle opzioni è la Versione del database, che viene popolata automaticamente con le versioni disponibili. Selezionare una versione e fare clic su Ripristina backup per avviare il processo di fornitura e ripristino.
Aggiornamento utilizzando la CLI
Quando esegui l'upgrade e il ripristino dal backup tramite la CLI IBM Cloud, utilizza il comando di provisioning dal controller della risorsa.
ibmcloud resource service-instance-create <INSTANCE-NAME> <SERVICE-ID> <SERVICE-PLAN-ID> <REGION>
I parametri service-name, service-id, service-plan-id e region sono tutti obbligatori. Fornisci anche a -p i parametri di versione e ID backup in un oggetto JSON. La nuova distribuzione
viene ridimensionata automaticamente con lo stesso disco e la stessa memoria della distribuzione di origine al momento del backup.
L'elenco dei backup e degli ID di backup per un'installazione client può essere recuperato con il seguente comando.
ibmcloud cdb deployment-backups-list <INSTANCE_NAME_OR_CRN> --json
Utilizzare l'ID del backup scelto come parametro nel comando del controllore delle risorse, come mostrato di seguito.
ibmcloud resource service-instance-create example-upgrade databases-for-redis standard us-south \
-p \ '{
"backup_id": "crn:v1:bluemix:public:databases-for-redis:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
"version":"7.2"
}'
Aggiornamento utilizzando l'API
In modo simile al provisioning tramite l'API, devi completare la procedura richiesta per utilizzare l'API del controller delle risorse prima di poterla utilizzare per eseguire l'aggiornamento da un backup. Invia quindi all'API una richiesta POST. I parametri name, target, resource_group, resource_plan_id, backup_id,
service_endpoints e version sono tutti necessari. La nuova distribuzione ha la stessa assegnazione di memoria e disco della distribuzione di origine al momento del backup.
L'elenco dei backup e degli ID di backup per un'installazione client può essere recuperato utilizzando la seguente richiesta API.
curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/backups
-H 'Authorization: Bearer <token>' \
Utilizzare l'ID del backup scelto nella richiesta API del controller delle risorse, come nell'esempio seguente.
curl -X POST \
https://resource-controller.cloud.ibm.com/v2/resource_instances \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"name": "new-instance-name",
"target": "us-south",
"resource_group": "5g9f447903254bb58972a2f3f5a4c711",
"resource_plan_id": "databases-for-redis-standard",
"parameters":{
"backup_id": "crn:v1:bluemix:public:databases-for-redis:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
"service_endpoints": "private",
"version": "7.2"
}
}'
Backup e ripristino: esempio
Completare la seguente procedura di backup e ripristino su richiesta per eseguire l'aggiornamento. Questo esempio illustra i passaggi per l'aggiornamento alla versione più recente.
Per creare un backup manuale nell'interfaccia utente:
- Vai alla scheda Backup e ripristino dell'istanza Databases for Redis
- Fare clic su Crea backup: viene visualizzato un messaggio che indica che è in corso un backup e un backup su richiesta viene aggiunto all'elenco dei backup disponibili. Il backup su richiesta è visibile nella pagina di panoramica, nel pannello delle attività recenti.
Per ripristinare un backup in una nuova istanza del servizio:
-
Passare alla scheda Backup e ripristino
-
Fare clic sulla riga corrispondente per espandere le opzioni del backup on-demand che si desidera ripristinare
-
Fare clic su Ripristina backup, per essere reindirizzati alla pagina di ripristino dell'istanza.
-
Nella pagina Ripristino, è possibile modificare il nome del servizio della nuova istanza, la regione e i valori di allocazione delle risorse. Per impostazione predefinita, la nuova istanza viene ridimensionata automaticamente alla stessa assegnazione di disco e memoria dell'istanza di origine al momento del backup da cui si sta eseguendo il ripristino. In Configurazione del servizio, selezionare l'ultima versione disponibile come Versione del database.
-
Fare clic su Ripristina backup.
Mantenere "appendonly=yes" durante il ripristino del backup. Passare alla modalità cache solo al termine del ripristino per evitare la perdita di dati.
Una volta terminato il provisioning della nuova istanza, i tuoi dati nel file di backup vengono ripristinati nella nuova istanza. La nuova istanza aggiornata è accessibile dall'elenco delle risorse.
Non eliminare l'istanza di origine durante il ripristino del backup. Prima di eliminare la vecchia istanza, attendere che venga eseguito il provisioning della nuova istanza e che il backup venga ripristinato. L'eliminazione di un'istanza elimina anche i relativi backup.
Aggiornamento forzato
Se si sceglie di non eseguire l'aggiornamento utilizzando il ripristino e l'aggiornamento, Databases for Redis verrà aggiornato forzatamente alla versione principale successiva al termine del ciclo di vita della versione.
Se si richiede la migrazione dei dati
Per una guida sulla migrazione, vedi Migrating to Databases for Redis.