Mise à niveau de l'édition personnalisée en ligne

Vous pouvez mettre à niveau Custom Edition en ligne à l'aide du plug-in kubectl.

Le plug-in Instana kubectl et l'opérateur Instana Enterprise sont toujours commercialisés ensemble. Les mises à jour du backend d' Instana sont indépendantes des versions de l'opérateur Instana Enterprise.

Vous pouvez utiliser le plug-in Instana kubectl pour vérifier les versions prises en charge du backend Instana et mettre à jour le backend si nécessaire.

Pour connaître les exigences spécifiques à la version pour la mise à niveau, consultez les notes de mise à niveau.

Prérequis

Assurez-vous que les conditions préalables suivantes sont remplies avant de mettre à niveau Instana :

  • Le cluster dispose d'une capacité suffisante. Si le cluster approche de sa capacité maximale, ajoutez un nœud supplémentaire pour éviter que les pods restent bloqués dans l'état « En attente ».
  • Les nœuds de l' Elasticsearch disposent d'un espace disque suffisant. Si l'utilisation du disque dépasse 80 %, les nœuds d' Elasticsearch s passent automatiquement en mode lecture seule, ce qui peut entraîner le blocage ou l'échec silencieux de la mise à niveau.

Procédure

Pour mettre à niveau Custom Edition en ligne, procédez comme suit :

  1. Vérifiez si les versions du magasin de données sont compatibles avec la version d' Instana vers laquelle vous souhaitez effectuer la mise à niveau. Pour les versions du magasin de données, consultez la section Mise à niveau des opérateurs de magasins de données tiers.

  2. Si la version de votre magasin de données n'est pas compatible, mettez à niveau les magasins de données. Pour mettre à niveau les magasins de données, consultez la section Mise à niveau des opérateurs de magasins de données tiers.

  3. Mise à niveau d' Instana Opérateur d'entreprise.

    1. Installez la version cible du plug-in Instana kubectl. Le plug-in Instana kubectl et l'opérateur Instana Enterprise Operator sont versionnés ensemble. Installez donc la version du plug-in qui correspond à la version de l'opérateur que vous installez. Pour plus d'informations, consultez la section Installation du plug-in kubectl d' Instana.

    2. Mettez à niveau l'opérateur où le nouvel opérateur est appliqué avec une version backend d' Instana par défaut. Voir Appliquer directement les manifestes.

      • Assurez-vous d'appliquer ou de générer de nouveaux manifestes d' YAML. Ne mettez pas à jour directement la version de l'image dans les manifestes existants d' YAML. Si vous mettez à jour la version de l'image dans les manifestes existants d' YAML, vous risquez de passer à côté des mises à jour du CRD ( CustomResourceDefinition ) ou d'autres modifications pouvant entraîner des erreurs imprévisibles.

      • Pour passer à une version spécifique, vous devrez peut-être effectuer certaines actions supplémentaires. Consultez les notes de mise à niveau. Lorsque vous ignorez une version, veillez à prendre en compte les notes de mise à niveau (y compris celles concernant la version ignorée et la version cible).

  4. Mise à niveau du backend d' Instana :

    Remarque : à partir de la version 1.0.0, vous pouvez mettre à niveau le backend Instana lorsque de nouvelles versions sont disponibles. Toutes les commandes ont un indicateur --download-key facultatif. Si vous ne spécifiez pas l'indicateur, la clé de téléchargement de l'installation existante est utilisée.
    1. Recherchez les versions disponibles du backend d' Instana s qui sont compatibles avec l 'édition personnalisée installée.

      kubectl-instana versions identify 
       
    2. Mettre à jour la version du backend. Effectuez l'une des étapes suivantes.

      • Sélectionnez une version à mettre à niveau :

        kubectl-instana versions update 
         

        Toutes les versions de mise à niveau prises en charge sont affichées. Vous pouvez sélectionner une version.

      • Spécifiez une version à mettre à niveau :

        kubectl-instana versions update --instana-version 3.xxx.xxx-0
         

        Vous pouvez également configurer la version du backend vers laquelle vous souhaitez effectuer la mise à niveau dans la spécification principale et appliquer la spécification comme indiqué dans l'exemple suivant.

        ...
        spec:
          imageConfig:
            tag: 3.xxx.xxx-0
        ...
         
    3. Vérifiez la mise à niveau du backend d' Instana :

      kubectl get core -n instana-core
       
      kubectl get units -n instana-units