Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Rancher mise à niveau sur NetApp HCI

Contributeurs

Pour mettre à niveau le logiciel Rancher, vous pouvez utiliser l'interface utilisateur et l'API REST de NetApp Hybrid Cloud Control (HCC). HCC offre un processus simple de mise à niveau des composants de votre déploiement Rancher, y compris le serveur Rancher, le moteur Kubernetes Rancher (RKE) et l'OS de nœuds du cluster de gestion (pour les mises à jour de sécurité). Vous pouvez également utiliser l'API pour automatiser les mises à niveau.

Les mises à niveau sont disponibles par composant au lieu d'un package cumulatif. En tant que telles, certaines mises à niveau de composants telles que le système d'exploitation Ubuntu sont disponibles dans une cadence plus rapide. Les mises à niveau n'affectent que votre instance de serveur Rancher et le cluster de gestion sur lequel Rancher Server est déployé. Les mises à niveau vers le système d'exploitation Ubuntu du nœud de cluster de gestion ne concernent que les correctifs de sécurité critiques et ne mettent pas à niveau le système d'exploitation. Les clusters d'utilisateurs ne peuvent pas être mis à niveau à partir de NetApp Hybrid Cloud Control.

Ce dont vous avez besoin
  • Privilèges d'administrateur : vous disposez des autorisations d'administrateur du cluster de stockage pour effectuer la mise à niveau.

  • Services de gestion: Vous avez mis à jour votre bundle de services de gestion à la dernière version.

Important Vous devez effectuer une mise à niveau vers les derniers packs de services de gestion 2.17 ou version ultérieure pour bénéficier des fonctionnalités Rancher.
  • Ports système : si vous utilisez le contrôle du cloud hybride NetApp pour les mises à niveau, vous avez vérifié que les ports nécessaires sont ouverts. Voir "Ports réseau" pour en savoir plus.

  • Contrat de licence utilisateur final (CLUF) : à partir des services de gestion 2.20.69, vous devez accepter et enregistrer le CLUF avant d'utiliser l'interface utilisateur ou l'API de contrôle de cloud hybride NetApp pour mettre à niveau un déploiement Rancher :

    1. Ouvrez l'adresse IP du nœud de gestion dans un navigateur Web :

      https://<ManagementNodeIP>
    2. Connectez-vous au contrôle de cloud hybride NetApp en fournissant les identifiants de l'administrateur du cluster de stockage.

    3. Sélectionnez Upgrade en haut à droite de l'interface.

    4. Le CLUF s'affiche. Faites défiler vers le bas, sélectionnez J'accepte les mises à jour actuelles et futures, puis sélectionnez Enregistrer.

Options de mise à niveau

Choisissez l'un des processus de mise à niveau suivants :

Utilisez l'interface utilisateur de contrôle de cloud hybride NetApp pour mettre à niveau un déploiement Rancher

Grâce à l'interface utilisateur de contrôle des clouds hybrides NetApp, vous pouvez mettre à niveau tous ces composants dans votre déploiement Rancher :

  • Serveur de rancher

  • Rancher Kubernetes Engine (RKE)

  • Mises à jour de sécurité du système d'exploitation des nœuds

Ce dont vous avez besoin
  • Une bonne connexion Internet. Les mises à niveau des sites sombres (mises à niveau sur un site sans connectivité externe) ne sont pas disponibles.

Étapes
  1. Ouvrez l'adresse IP du nœud de gestion dans un navigateur Web :

    https://<ManagementNodeIP>
  2. Connectez-vous au contrôle de cloud hybride NetApp en fournissant les identifiants de l'administrateur du cluster de stockage.

  3. Sélectionnez Upgrade en haut à droite de l'interface.

  4. Sur la page mises à niveau, sélectionnez Rancher.

  5. Sélectionnez le menu actions pour le logiciel que vous souhaitez mettre à niveau.

    • Serveur de rancher

    • Rancher Kubernetes Engine (RKE)

    • Mises à jour de sécurité du système d'exploitation des nœuds

  6. Sélectionnez Upgrade pour les mises à niveau Rancher Server ou RKE ou Apply Upgrade pour les mises à jour de sécurité des systèmes d'exploitation de nœud.

    Remarque Pour le système d'exploitation de nœud, les mises à niveau sans surveillance des correctifs de sécurité sont exécutées quotidiennement, mais le nœud n'est pas redémarré automatiquement. En appliquant des mises à niveau, vous redémarrez chaque nœud pour que les mises à jour de sécurité prennent effet.

Une bannière s'affiche pour indiquer que la mise à niveau du composant a réussi. Un délai de 2 minutes peut s'avérer nécessaire avant que l'interface utilisateur de NetApp Hybrid Cloud Control affiche le numéro de version mis à jour.

Utilisez l'API de contrôle de cloud hybride NetApp pour mettre à niveau un déploiement Rancher

Vous pouvez utiliser des API pour mettre à niveau tous ces composants dans votre déploiement Rancher :

  • Serveur de rancher

  • Rancher Kubernetes Engine (RKE)

  • Nœud OS (pour les mises à jour de sécurité)

Vous pouvez utiliser un outil d'automatisation de votre choix pour exécuter les API ou l'interface utilisateur de l'API REST disponible sur le nœud de gestion.

Options

Mettre à niveau Rancher Server

Commandes d'API
  1. Lancez la demande de mise à niveau de la liste :

    curl -X POST "https://<managementNodeIP>/k8sdeployer/1/upgrade/rancher-versions" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Remarque Vous pouvez trouver le porteur ${TOKEN} Utilisé par la commande API lorsque vous "autoriser". Le porteur ${TOKEN} est dans la réponse curl.
  2. Obtenir l'état de la tâche à l'aide de l'ID de tâche de la commande précédente et copier le numéro de version le plus récent de la réponse :

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
  3. Lancez une demande de mise à niveau de serveur Rancher :

    curl -X PUT "https://<mNodeIP>/k8sdeployer/1/upgrade/rancher/<version number>" -H "accept: application/json" -H "Authorization: Bearer"
  4. Obtenir le statut de la tâche à l'aide de l'ID de tâche à partir de la réponse de la commande de

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
ÉTAPES DE L'INTERFACE UTILISATEUR DE L'API REST
  1. Ouvrez l'interface de l'API REST du nœud de gestion sur le nœud de gestion :

    https://<ManagementNodeIP>/k8sdeployer/api/
  2. Sélectionnez Authorise et procédez comme suit :

    1. Saisissez le nom d'utilisateur et le mot de passe du cluster.

    2. Saisissez l'ID client en tant que mnode-client.

    3. Sélectionnez Autoriser pour démarrer une session.

    4. Fermez la fenêtre d'autorisation.

  3. Recherchez la dernière mise à niveau :

    1. À partir de l'interface utilisateur de l'API REST, exécutez POST /upgrade​/rancher-versions.

    2. Dans la réponse, copiez l'ID de tâche.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

  4. À partir de la réponse /task​/{taskID}, copiez le numéro de version le plus récent que vous souhaitez utiliser pour la mise à niveau.

  5. Exécutez la mise à niveau Rancher Server :

    1. À partir de l'interface utilisateur de l'API REST, exécutez PUT /upgrade​/rancher​/{version} avec le numéro de version le plus récent de l'étape précédente.

    2. Dans la réponse, copiez l'ID de tâche.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

La mise à niveau a réussi une fois que l' PercentComplete indique 100 et results indique le numéro de version mis à niveau.

Mise à niveau de la télécommande RKE

Commandes d'API
  1. Lancez la demande de mise à niveau de la liste :

    curl -X POST "https://<mNodeIP>/k8sdeployer/1/upgrade/rke-versions" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Remarque Vous pouvez trouver le porteur ${TOKEN} Utilisé par la commande API lorsque vous "autoriser". Le porteur ${TOKEN} est dans la réponse curl.
  2. Obtenir l'état de la tâche à l'aide de l'ID de tâche de la commande précédente et copier le numéro de version le plus récent de la réponse :

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
  3. Lancez la demande de mise à niveau de la télécommande de télédéverrouillage

    curl -X PUT "https://<mNodeIP>/k8sdeployer/1/upgrade/rke/<version number>" -H "accept: application/json" -H "Authorization: Bearer"
  4. Obtenir le statut de la tâche à l'aide de l'ID de tâche à partir de la réponse de la commande de

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
ÉTAPES DE L'INTERFACE UTILISATEUR DE L'API REST
  1. Ouvrez l'interface de l'API REST du nœud de gestion sur le nœud de gestion :

    https://<ManagementNodeIP>/k8sdeployer/api/
  2. Sélectionnez Authorise et procédez comme suit :

    1. Saisissez le nom d'utilisateur et le mot de passe du cluster.

    2. Saisissez l'ID client en tant que mnode-client.

    3. Sélectionnez Autoriser pour démarrer une session.

    4. Fermez la fenêtre d'autorisation.

  3. Recherchez la dernière mise à niveau :

    1. À partir de l'interface utilisateur de l'API REST, exécutez POST /upgrade​/rke-versions.

    2. Dans la réponse, copiez l'ID de tâche.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

  4. À partir de la réponse /task​/{taskID}, copiez le numéro de version le plus récent que vous souhaitez utiliser pour la mise à niveau.

  5. Exécutez la mise à jour RKE :

    1. À partir de l'interface utilisateur de l'API REST, exécutez PUT /upgrade/rke/{version} avec le numéro de version le plus récent de l'étape précédente.

    2. Copiez l'ID de tâche depuis la réponse.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

La mise à niveau a réussi une fois que l' PercentComplete indique 100 et results indique le numéro de version mis à niveau.

Appliquer les mises à jour de sécurité du système d'exploitation des nœuds

Commandes d'API
  1. Lancez la demande de vérification des mises à niveau :

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/upgrade/checkNodeUpdates" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
    Remarque Vous pouvez trouver le porteur ${TOKEN} Utilisé par la commande API lorsque vous "autoriser". Le porteur ${TOKEN} est dans la réponse curl.
  2. Obtenir l'état de la tâche à l'aide de l'ID de tâche de la commande précédente et vérifier qu'un numéro de version plus récent est disponible à partir de la réponse :

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
  3. Appliquer les mises à jour du nœud :

    curl -X POST "https://<mNodeIP>/k8sdeployer/1/upgrade/applyNodeUpdates" -H "accept: application/json" -H "Authorization: Bearer"
    Remarque Pour le système d'exploitation de nœud, les mises à niveau sans surveillance des correctifs de sécurité sont exécutées quotidiennement, mais le nœud n'est pas redémarré automatiquement. En appliquant des mises à niveau, vous redémarrez chaque nœud de façon séquentielle afin que les mises à jour de sécurité prennent effet.
  4. Obtenir le statut de la tâche à l'aide de l'ID de tâche de la mise à niveau applyNodeUpdates réponse :

    curl -X GET "https://<mNodeIP>/k8sdeployer/1/task/<taskID>" -H "accept: application/json" -H "Authorization: Bearer ${TOKEN}"
ÉTAPES DE L'INTERFACE UTILISATEUR DE L'API REST
  1. Ouvrez l'interface de l'API REST du nœud de gestion sur le nœud de gestion :

    https://<ManagementNodeIP>/k8sdeployer/api/
  2. Sélectionnez Authorise et procédez comme suit :

    1. Saisissez le nom d'utilisateur et le mot de passe du cluster.

    2. Saisissez l'ID client en tant que mnode-client.

    3. Sélectionnez Autoriser pour démarrer une session.

    4. Fermez la fenêtre d'autorisation.

  3. Vérifiez si un package de mise à niveau est disponible :

    1. Dans l'interface utilisateur de l'API REST, exécutez GET /upgrade/checkNodeUpdates.

    2. Dans la réponse, copiez l'ID de tâche.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

    4. Dans la réponse /task​/{taskID}, vérifiez que le numéro de version est plus récent que celui actuellement appliqué à vos noeuds.

  4. Appliquer les mises à niveau du système d'exploitation des nœuds :

    Remarque Pour le système d'exploitation de nœud, les mises à niveau sans surveillance des correctifs de sécurité sont exécutées quotidiennement, mais le nœud n'est pas redémarré automatiquement. En appliquant des mises à niveau, vous redémarrez chaque nœud de façon séquentielle afin que les mises à jour de sécurité prennent effet.
    1. À partir de l'interface utilisateur de l'API REST, exécutez POST /upgrade​/applyNodeUpdates.

    2. Dans la réponse, copiez l'ID de tâche.

    3. Exécutez GET /task​/{taskID} avec l'ID de tâche de l'étape précédente.

    4. Dans la réponse /task​/{taskID}, vérifiez que la mise à niveau a été appliquée.

La mise à niveau a réussi une fois que l' PercentComplete indique 100 et results indique le numéro de version mis à niveau.

Trouvez plus d'informations