Skip to main content

Préparation de la mise à niveau d’Elasticsearch dans GitHub Enterprise Server 3.13

Dans le cadre de la mise à niveau de GitHub Enterprise Server vers la version 3.13 ou ultérieure, le service Elasticsearch est mis à niveau.

Vue d’ensemble

Elasticsearch (ES) alimente la fonctionnalité de recherche sur votre instance GitHub Enterprise Server. Pour bénéficier des avantages liés à des performances et à une sécurité accrues, la version Elasticsearch de l’appliance sera mise à niveau de 5.6.16 à 8.7.0 lorsque vous mettez à niveau votre instance vers la version 3.13 ou ultérieure.

Les sections suivantes aident les administrateurs à préparer et surveiller la mise à niveau d’Elasticsearch. Les points clés sont les suivants :

  • La mise à niveau dégrade temporairement l’expérience des fonctionnalités de recherche et du journal d’audit.
  • Si vous mettez à niveau une instance dans une configuration de cluster, vous devez exécuter un script pour préparer votre cluster à la mise à niveau d’ES. Consulter « Mise à niveau d’un cluster ».
  • Pour les sauvegardes, tous les clients doivent prendre un instantané de leur instance une fois la mise à niveau terminée.

Impact sur la recherche et les journaux d’audit

Tous les index de recherche seront reconstruits après la mise à niveau vers ES8. Les utilisateurs connaissent une expérience de recherche détériorée pendant la reconstruction, mais l’instance est normalement censée être fonctionnelle et disponible. Le processus de reconstruction d’index dépend de la taille du jeu de données et peut prendre de quelques heures à quelques jours.

Les journaux d’audit ne seront pas disponibles immédiatement après la mise à niveau et la migration de tous les journaux d’audit peut prendre plusieurs heures.

Nous vous recommandons vivement d’effectuer une sauvegarde (à l’aide backup-utils) immédiatement après l’achèvement de la reconstruction d’index et d’utiliser cet instantané pour toutes les restaurations futures. Consulter « Configuration des sauvegardes sur votre instance ». Si vous restaurez une sauvegarde à partir d’une instance exécutant GitHub Enterprise Server 3.11 ou 3.12, tout contenu qui s’appuie sur ES ne sera disponible qu’une fois les index ES migrés et reconstruits sur l’instance 3.13.

Surveillance de la mise à niveau d’Elasticsearch

Vous pouvez surveiller la progression de la mise à niveau d’ES dans le tableau de bord d’administration du site.

  1. Dans le coin supérieur droit de n’importe quelle page, cliquez sur .
  2. Dans la barre latérale gauche, cliquez sur Rechercher des index.

Une fois la reconstruction d’index terminée, tous les index de recherche doivent être en vert et afficher « 100 % ».

Modification du nombre de réparateurs

Par défaut, le nombre de réparateurs d’index est défini sur le nombre de cœurs d’unité centrale divisé par 8 (avec une limite supérieure de 8). Pour accélérer la reconstruction d’index, vous pouvez ajuster le nombre de réparateurs. Toutefois, avant de le faire, vous devez tenir compte de l’impact potentiel sur la charge.

  1. Connexion SSH à votre instance GitHub Enterprise Server. Si votre instance comprend plusieurs nœuds, par exemple si la haute disponibilité ou la géoréplication sont configurées, connectez-vous via SSH au nœud principal. Si vous utilisez un cluster, vous pouvez vous connecter via SSH à n’importe quel nœud. Remplacez HOSTNAME par le nom d’hôte de votre instance, le nom d’hôte ou l’adresse IP d’un nœud. Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».

    Shell
    ssh -p 122 admin@HOSTNAME
    
  2. Pour modifier le nombre de réparateurs, saisissez la commande suivante.

    Shell
    ghe-config app.github.es-workers NUMBER-OF-WORKERS
    
  3. Exécutez ghe-config-apply.

Vous pouvez également ajuster le nombre de réparateurs pour les reconstructions d’index individuelles dans la section « Index de recherche » du tableau de bord d’administration du site. Consultez la section « Surveillance de la mise à niveau d’Elasticsearch ».