Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Upgrade Rancher su NetApp HCI

Collaboratori
PDF

Per aggiornare il software Rancher, è possibile utilizzare l'interfaccia utente di NetApp Hybrid Cloud Control (HCC) o L'API REST. HCC offre un semplice processo di aggiornamento dei componenti dell'implementazione di Rancher, tra cui il server Rancher, RKE (Rubernetes Engine) Rancher e il sistema operativo del nodo del cluster di gestione (per gli aggiornamenti di sicurezza). In alternativa, è possibile utilizzare l'API per automatizzare gli aggiornamenti.

Gli aggiornamenti sono disponibili per componente invece che per pacchetto cumulativo. Di conseguenza, alcuni aggiornamenti dei componenti, come il sistema operativo Ubuntu, sono disponibili con cadenza più rapida. Gli aggiornamenti interessano solo l'istanza del server Rancher e il cluster di gestione su cui è distribuito Rancher Server. Gli aggiornamenti al sistema operativo Ubuntu del nodo del cluster di gestione sono solo per patch di sicurezza critiche e non aggiornano il sistema operativo. I cluster di utenti non possono essere aggiornati da NetApp Hybrid Cloud Control.

Di cosa hai bisogno

  • Privilegi di amministratore: Si dispone delle autorizzazioni di amministratore del cluster di storage per eseguire l'aggiornamento.

  • Servizi di gestione: Hai aggiornato il tuo bundle di servizi di gestione alla versione più recente.

Importante È necessario eseguire l'aggiornamento al bundle di servizi di gestione più recente 2.17 o successivo per la funzionalità Rancher.

  • Porte di sistema: Se si utilizza NetApp Hybrid Cloud Control per gli aggiornamenti, si è assicurati che le porte necessarie siano aperte. Per ulteriori informazioni, vedere "Porte di rete" .

  • Contratto di licenza con l'utente finale (EULA): A partire dai servizi di gestione 2.20.69, è necessario accettare e salvare l'EULA prima di utilizzare l'interfaccia utente o l'API di NetApp Hybrid Cloud Control per aggiornare un'implementazione di Rancher:

    1. Aprire l'indirizzo IP del nodo di gestione in un browser Web:

      https://<ManagementNodeIP>

    2. Accedere a NetApp Hybrid Cloud Control fornendo le credenziali di amministratore del cluster di storage.

    3. Selezionare Upgrade (Aggiorna) nella parte superiore destra dell'interfaccia.

    4. Viene visualizzato il EULA. Scorrere verso il basso, selezionare Accetto per aggiornamenti correnti e futuri e selezionare Salva.

Opzioni di upgrade

Scegliere uno dei seguenti processi di aggiornamento:

Utilizza l'interfaccia utente di NetApp Hybrid Cloud Control per aggiornare un'implementazione di Rancher

Utilizzando l'interfaccia utente di NetApp Hybrid Cloud Control, puoi aggiornare uno qualsiasi di questi componenti nella tua implementazione di Rancher:

  • Server del rancher

  • Rancher Kubernetes Engine (RKE)

  • Aggiornamenti di sicurezza del sistema operativo del nodo

Di cosa hai bisogno

  • Una buona connessione a Internet. Non sono disponibili aggiornamenti del sito scuro.

Fasi

  1. Aprire l'indirizzo IP del nodo di gestione in un browser Web:

    https://<ManagementNodeIP>

  2. Accedere a NetApp Hybrid Cloud Control fornendo le credenziali di amministratore del cluster di storage.

  3. Selezionare Upgrade (Aggiorna) nella parte superiore destra dell'interfaccia.

  4. Nella pagina Upgrades, selezionare Rancher.

  5. Selezionare il menu azioni del software che si desidera aggiornare.

    • Server del rancher

    • Rancher Kubernetes Engine (RKE)

    • Aggiornamenti di sicurezza del sistema operativo del nodo

  6. Selezionare Upgrade per gli aggiornamenti del server Rancher o RKE o Apply Upgrade per gli aggiornamenti di sicurezza del sistema operativo Node.

    Nota Per il sistema operativo del nodo, gli aggiornamenti automatici delle patch di sicurezza vengono eseguiti quotidianamente, ma il nodo non viene riavviato automaticamente. Applicando gli aggiornamenti, si riavvia ogni nodo per rendere effettive le modifiche di protezione.

Viene visualizzato un banner che indica che l'aggiornamento del componente è stato eseguito correttamente. Potrebbe esserci un ritardo di 15 minuti prima che l'interfaccia utente di NetApp Hybrid Cloud Control mostri il numero di versione aggiornato.

Utilizza l'API di controllo del cloud ibrido di NetApp per aggiornare un'implementazione di Rancher

È possibile utilizzare le API per aggiornare uno qualsiasi di questi componenti nella distribuzione di Rancher:

  • Server del rancher

  • Rancher Kubernetes Engine (RKE)

  • Sistema operativo Node (per gli aggiornamenti di sicurezza)

È possibile utilizzare uno strumento di automazione di propria scelta per eseguire le API o L'interfaccia utente REST API disponibile sul nodo di gestione.

Opzioni

Upgrade di Rancher Server

Comandi API

  1. Avviare la richiesta di aggiornamento delle versioni dell'elenco:

    curl -X POST "https://<ManagementNodeIP>/k8sdeployer/1/upgrade/rancher-versions" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Nota È possibile trovare il bearer ${TOKEN} utilizzato dal comando API quando si "autorizzare". Il bearer ${TOKEN} è nella risposta curl.

  2. Ottenere lo stato dell'attività utilizzando l'ID attività del comando precedente e copiare il numero di versione più recente dalla risposta:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"

  3. Avviare la richiesta di upgrade del server Rancher:

    curl -X PUT "https://<mNodeIP>/k8sdeployer/1/upgrade/rancher/<version number>" -H "accept: application/json" -H "Authorization: Bearer"

  4. Ottenere lo stato del task utilizzando l'ID del task dalla risposta del comando di upgrade:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
FASI DELL'INTERFACCIA UTENTE API REST

  1. Aprire l'interfaccia utente REST API del nodo di gestione sul nodo di gestione:

    https://<ManagementNodeIP>/k8sdeployer/api/

  2. Selezionare autorizzare e completare le seguenti operazioni:

    1. Inserire il nome utente e la password del cluster.

    2. Immettere l'ID client come mnode-client.

    3. Selezionare autorizzare per avviare una sessione.

    4. Chiudere la finestra di autorizzazione.

  3. Verificare la disponibilità del pacchetto di aggiornamento più recente:

    1. Dall'interfaccia utente API REST, eseguire POST /upgrade​/rancher-versions.

    2. Dalla risposta, copiare l'ID attività.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

  4. Dalla risposta /task​/{taskID}, copiare l'ultimo numero di versione che si desidera utilizzare per l'aggiornamento.

  5. Eseguire l'aggiornamento di Rancher Server:

    1. Dall'interfaccia utente API REST, eseguire PUT /upgrade​/rancher​/{version} con il numero di versione più recente del passaggio precedente.

    2. Dalla risposta, copiare l'ID attività.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

L'aggiornamento è stato completato correttamente quando l' PercentComplete indica 100 e results indica il numero della versione aggiornata.

Aggiornamento RKE

Comandi API

  1. Avviare la richiesta di aggiornamento delle versioni dell'elenco:

    curl -X POST "https://<mNodeIP>/k8sdeployer/1/upgrade/rke-versions" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Nota È possibile trovare il bearer ${TOKEN} utilizzato dal comando API quando si "autorizzare". Il bearer ${TOKEN} è nella risposta curl.

  2. Ottenere lo stato dell'attività utilizzando l'ID attività del comando precedente e copiare il numero di versione più recente dalla risposta:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"

  3. Avviare la richiesta di aggiornamento RKE

    curl -X PUT "https://<mNodeIP>/k8sdeployer/1/upgrade/rke/<version number>" -H "accept: application/json" -H "Authorization: Bearer"

  4. Ottenere lo stato del task utilizzando l'ID del task dalla risposta del comando di upgrade:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
FASI DELL'INTERFACCIA UTENTE API REST

  1. Aprire l'interfaccia utente REST API del nodo di gestione sul nodo di gestione:

    https://<ManagementNodeIP>/k8sdeployer/api/

  2. Selezionare autorizzare e completare le seguenti operazioni:

    1. Inserire il nome utente e la password del cluster.

    2. Immettere l'ID client come mnode-client.

    3. Selezionare autorizzare per avviare una sessione.

    4. Chiudere la finestra di autorizzazione.

  3. Verificare la disponibilità del pacchetto di aggiornamento più recente:

    1. Dall'interfaccia utente API REST, eseguire POST /upgrade​/rke-versions.

    2. Dalla risposta, copiare l'ID attività.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

  4. Dalla risposta /task​/{taskID}, copiare l'ultimo numero di versione che si desidera utilizzare per l'aggiornamento.

  5. Eseguire l'aggiornamento RKE:

    1. Dall'interfaccia utente API REST, eseguire PUT /upgrade/rke/{version} con il numero di versione più recente del passaggio precedente.

    2. Copiare l'ID attività dalla risposta.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

L'aggiornamento è stato completato correttamente quando l' PercentComplete indica 100 e results indica il numero della versione aggiornata.

Applicare gli aggiornamenti di sicurezza del sistema operativo del nodo

Comandi API

  1. Avviare la richiesta di verifica degli aggiornamenti:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/upgrade/checkNodeUpdates" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Nota È possibile trovare il bearer ${TOKEN} utilizzato dal comando API quando si "autorizzare". Il bearer ${TOKEN} è nella risposta curl.

  2. Ottenere lo stato dell'attività utilizzando l'ID attività del comando precedente e verificare che sia disponibile un numero di versione più recente dalla risposta:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"

  3. Applicare gli aggiornamenti del nodo:

    curl -X POST "https://<mNodeIP>/k8sdeployer/1/upgrade/applyNodeUpdates" -H "accept: application/json" -H "Authorization: Bearer"
    Nota Per il sistema operativo del nodo, gli aggiornamenti automatici delle patch di sicurezza vengono eseguiti quotidianamente, ma il nodo non viene riavviato automaticamente. Applicando gli aggiornamenti, ogni nodo viene riavviato in sequenza per rendere effettive le modifiche di protezione.

  4. Ottenere lo stato dell'attività utilizzando l'ID attività dalla risposta di aggiornamento applyNodeUpdates:

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
FASI DELL'INTERFACCIA UTENTE API REST

  1. Aprire l'interfaccia utente REST API del nodo di gestione sul nodo di gestione:

    https://<ManagementNodeIP>/k8sdeployer/api/

  2. Selezionare autorizzare e completare le seguenti operazioni:

    1. Inserire il nome utente e la password del cluster.

    2. Immettere l'ID client come mnode-client.

    3. Selezionare autorizzare per avviare una sessione.

    4. Chiudere la finestra di autorizzazione.

  3. Verificare se è disponibile un pacchetto di aggiornamento:

    1. Dall'interfaccia utente API REST, eseguire GET /upgrade/checkNodeUpdates.

    2. Dalla risposta, copiare l'ID attività.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

    4. Dalla risposta /task​/{taskID}, verificare che vi sia un numero di versione più recente di quello attualmente applicato ai nodi.

  4. Applicare gli aggiornamenti del sistema operativo del nodo:

    Nota Per il sistema operativo del nodo, gli aggiornamenti automatici delle patch di sicurezza vengono eseguiti quotidianamente, ma il nodo non viene riavviato automaticamente. Applicando gli aggiornamenti, ogni nodo viene riavviato in sequenza per rendere effettive le modifiche di protezione.

    1. Dall'interfaccia utente API REST, eseguire POST /upgrade​/applyNodeUpdates.

    2. Dalla risposta, copiare l'ID attività.

    3. Eseguire GET /task​/{taskID} con l'ID attività del passaggio precedente.

    4. Dalla risposta /task​/{taskID}, verificare che l'aggiornamento sia stato applicato.

L'aggiornamento è stato completato correttamente quando l' PercentComplete indica 100 e results indica il numero della versione aggiornata.

Trova ulteriori informazioni