Installer un cluster multinodal sur Ubuntu

Nous nous référons à ce répertoire comme pa-download-dir dans ce guide.

Le lot d’installation de Paragon Automation se compose des scripts et fichiers TAR suivants pour installer chacun des modules composants :

• davinci.tar.gz, qui est le fichier d’installation principal.

• infra.tar, qui installe les composants de l’infrastructure Kubernetes, notamment Docker et Helm.

• ems.tar, qui installe le composant de base de la plateforme.

• northstar.tar, qui installe le Paragon Pathfinder et Paragon Planner composants.

• healthbot.tar, qui installe le composant Paragon Insights.

• paragon_ui.tar, qui installe le composant Paragon Automation interface utilisateur.

• addons.tar, qui installe des composants d’infrastructure qui ne font pas partie de l’installation de base de Kubernetes. Les composants de l’infrastructure comprennent IAM, Kafka, ZooKeeper, cert-manager, Ambassador, Postgres, Metrics, Kubernetes Dashboard, Open Distro for Elasticsearch, Fluentd, Reloader, ArangoDB et Argo.

• helm-charts.tar, qui contient toutes les cartes de barre nécessaires à l’installation.

• rke2-packages.tgz, qui installe les composants Kubernetes basés sur RKE2.
• 3rdparty.tar.gz, qui installe les utilitaires tiers requis.

• rhel-84-airgap.tar.gz, qui installe les Paragon Automation à l’aide de la méthode de l’entrefer uniquement sur les nœuds dont le système d’exploitation de base est Red Hat Enterprise Linux (RHEL). Vous pouvez choisir de supprimer ce fichier si vous n’installez pas Paragon Automation à l’aide de la méthode air-gap sur un système d’exploitation de base RHEL.

• run qui exécute l’image du programme d’installation.

Maintenant que vous avez téléchargé le logiciel, vous êtes prêt à installer Paragon Automation.

config-dir répertoire défini par l’utilisateur sur l’hôte de contrôle qui contient les informations de configuration d’une installation particulière. La init commande crée automatiquement le répertoire s’il n’existe pas. Vous pouvez également créer le répertoire avant d’exécuter la init commande.

Assurez-vous d’inclure le point et la barre oblique (./) avec la run commande.

Si vous utilisez le même hôte de contrôle pour gérer plusieurs installations de Paragon Automation, vous pouvez différencier les installations en utilisant des répertoires de configuration nommés différemment.

Copiez la clé privée que vous avez générée dans Configurer l’authentification du client SSH dans le répertoire config-dir défini par l’utilisateur. Le programme d’installation permet au conteneur Docker d’accéder au config-dir répertoire. La clé SSH doit être disponible dans le répertoire pour que l’hôte de contrôle puisse se connecter aux nœuds de cluster.

Assurez-vous d’inclure le point (.) à la fin de la commande de copie (cp).

1. Personnalisez le fichier d’inventaire à l’aide de la inv commande :

   Le tableau suivant répertorie les options de configuration que la inv commande vous invite à saisir.

   Tableau 1 : inv Options de commande

   Description	des invites de commande inv
   Nœuds principaux Kubernetes	Saisissez les adresses IP des nœuds principaux de Kubernetes.
   Nœuds de travail Kubernetes	Entrez les adresses IP des nœuds de travail Kubernetes.
   Nœuds de stockage locaux	Définissez les nœuds disposant d’espace disque disponible pour les applications. Les nœuds de stockage locaux sont préremplis avec les adresses IP des nœuds principal et de travail. Vous pouvez modifier ces adresses. Entrez les adresses IP des nœuds sur lesquels vous souhaitez exécuter des applications nécessitant un stockage local. Des services tels que Postgres, ZooKeeper et Kafka utilisent un stockage local ou de l’espace disque partitionné dans des volumes d’exportation/locaux. Par défaut, les nœuds de travail disposent d’un stockage local. Si vous n’ajoutez pas de nœuds principaux ici, vous pouvez exécuter uniquement les applications qui ne nécessitent pas de stockage local sur les nœuds principaux. Remarque : Le stockage local est différent du stockage Ceph.
   Nom d'utilisateur des nœuds Kubernetes (par exemple, root)	Configurez le compte d’utilisateur et les méthodes d’authentification pour authentifier le programme d’installation auprès des nœuds de cluster. Le compte d’utilisateur doit être root ou, dans le cas d’utilisateurs non root, le compte doit disposer de privilèges de superutilisateur (sudo).
   Fichier de clé privée SSH (facultatif)	Si vous avez choisi ssh-key l’authentification, pour que l’hôte de contrôle s’authentifie auprès des nœuds pendant le processus d’installation, configurez le répertoire ( config-dir ) où se trouve le ansible_ssh_private_key_file et le fichier id_rsa comme « {{ config-dir }}/id_rsa ».
   Mot de passe des nœuds Kubernetes (facultatif)	Si vous avez choisi l’authentification par mot de passe pour que l’hôte de contrôle s’authentifie auprès des nœuds pendant le processus d’installation, entrez directement le mot de passe d’authentification. AVERTISSEMENT : le mot de passe est écrit en texte clair. Nous vous déconseillons d’utiliser cette option pour l’authentification.
   Nom du cluster Kubernetes (facultatif)	Saisissez un nom pour votre cluster Kubernetes.
   Écrire un fichier d’inventaire ?	Cliquez sur ce bouton Yes pour enregistrer les informations d’inventaire.

   Par exemple :

2. Vous pouvez également personnaliser le fichier d’inventaire manuellement à l’aide d’un éditeur de texte.

   Modifiez les groupes suivants dans le fichier d’inventaire .

   1. Ajoutez les adresses IP des nœuds principal et de travail Kubernetes du cluster.

      Le master groupe identifie les nœuds principaux et le node groupe identifie les nœuds de travail. Vous ne pouvez pas avoir la même adresse IP dans les deux master groupes and node .

      Pour créer une configuration de nœud multi-principal, répertoriez les adresses ou les noms d’hôte de tous les nœuds qui agiront en tant que nœuds principaux dans le master groupe. Ajoutez les adresses ou les noms d’hôte des nœuds qui agiront en tant que travailleurs dans le node groupe.

   2. Définissez les nœuds qui disposent d’espace disque disponible pour les applications du local_storage_nodes:children groupe.

   3. Configurez le compte d’utilisateur et les méthodes d’authentification pour authentifier le programme d’installation sur l’hôte de contrôle Ansible avec les nœuds de cluster sous le vars groupe.

   4. (Facultatif) Spécifiez un nom pour votre cluster Kubernetes dans le kubernetes_cluster_name groupe.

La conf commande exécute un assistant d’installation interactif qui vous permet de choisir les composants à installer et de configurer une configuration de base de Paragon Automation. La commande remplit le fichier config.yml avec votre configuration d’entrée. Pour une configuration avancée, vous devez modifier le fichier config.yml manuellement.

Entrez les informations demandées par l’assistant. Utilisez les touches du curseur pour déplacer le curseur, utilisez la touche espace pour sélectionner une option et utilisez la a touche ou i pour basculer la sélection ou la suppression de toutes les options. Appuyez sur Entrée pour passer à l’option de configuration suivante. Vous pouvez ignorer les options de configuration en saisissant un point (.). Vous pouvez saisir à nouveau tous vos choix en quittant l’assistant et en recommençant depuis le début. Le programme d’installation vous permet de quitter l’assistant après avoir enregistré les choix que vous avez déjà effectués ou de recommencer depuis le début. Vous ne pouvez pas revenir en arrière et rétablir les choix que vous avez déjà effectués dans le workflow actuel sans quitter et redémarrer complètement l’assistant.

Le tableau suivant répertorie les options de configuration que la conf commande vous invite à saisir :

[edit groups northstar]
root@system# show protocols bgp group northstar
type internal;
family traffic-engineering {
    unicast;
}
export TE;
allow 10.xx.43.0/24;

[edit groups northstar]
root@system# show policy-options policy-statement TE
from family traffic-engineering;
then accept;

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set 
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS allow 10.x.43.1
set protocols bgp group BGP-LS allow 10.x.43.2
set protocols bgp group BGP-LS allow 10.x.43.3
set protocols bgp group BGP-LS export TE

[edit protocols bgp group BGP-LS]
root@vmx101# show | display set
set protocols bgp group BGP-LS family traffic-engineering unicast
set protocols bgp group BGP-LS peer-as 11
set protocols bgp group BGP-LS neighbor 10.xx.43.1
set protocols bgp group BGP-LS neighbor 10.xx.43.2
set protocols bgp group BGP-LS neighbor 10.xx.43.3
set protocols bgp group BGP-LS passive
set protocols bgp group BGP-LS export TE

set protocols rsvp interface interface.unit

set protocols isis interface interface.unit
set protocols isis traffic-engineering igp-topology
Or
set protocols ospf area area interface interface.unit
set protocols ospf traffic-engineering igp-topology

set protocols mpls interface interface.unit
set protocols mpls traffic-engineering database import igp-topology

Le fichier config.yml se compose d’une section essentielle au début du fichier qui correspond aux options de configuration que l’assistant d’installation vous invite à saisir. Le fichier contient également une longue liste de sections sous la section essentielle qui vous permet d’entrer des valeurs de configuration complexes directement dans le fichier.

Vous pouvez configurer les options suivantes :

• (Facultatif) Définissez le grafana_admin_password mot de passe pour vous connecter à l’application Grafana. Grafana est un outil de visualisation couramment utilisé pour visualiser et analyser des données provenant de diverses sources, y compris les journaux.

  Par défaut, le nom d’utilisateur est préconfiguré en tant qu’administrateur dans # grafana_admin_user: admin. Utilisez admin comme nom d’utilisateur et le mot de passe que vous configurez pour vous connecter à Grafana.

  Si vous ne configurez pas le mot de grafana_admin_password passe, le programme d’installation génère un mot de passe aléatoire. Vous pouvez récupérer le mot de passe à l’aide de la commande :

  # kubectl get secret -n kube-system grafana -o jsonpath={..grafana-password} | base64 -d

• Définissez l’option de configuration sur true pour la iam_skip_mail_verification gestion des utilisateurs sans SMTP par Identity and Access Management (IAM). Par défaut, cette option est définie sur false pour la gestion des utilisateurs avec SMTP. Vous devez configurer SMTP dans Paragon Automation afin de pouvoir avertir les utilisateurs de Paragon Automation lorsque leur compte est créé, activé ou verrouillé, ou lorsque le mot de passe de leur compte est modifié.

• Configurez l’option callback_vip avec une adresse IP différente de celle de l’adresse IP virtuelle (VIP) du contrôleur entrant. Vous pouvez utiliser une adresse IP du pool d’adresses VIP MetalLB. Vous configurez cette adresse IP pour permettre la séparation du trafic de gestion et de données des interfaces ascendantes et nord. Par défaut, callback_vip est affectée la même adresse ou l’une des adresses du contrôleur entrant.

Enregistrez et quittez le fichier une fois que vous avez terminé de le modifier.

Par défaut, Ambassador utilise un certificat généré localement et signé par l’AC interne au cluster Kubernetes.

Le temps d’installation pour installer le cluster configuré dépend de la complexité du cluster. Une installation d’installation de base prend au moins 45 minutes.

Le programme d’installation vérifie la synchronisation NTP au début de l’installation. Si les horloges ne sont pas synchronisées, l’installation échoue.

Pour les déploiements à plusieurs nœuds principaux uniquement, le programme d’installation vérifie à la fois le processeur et la mémoire de chaque serveur, ainsi que le nombre total de processeurs et de mémoire disponibles par cluster. Si les conditions suivantes ne sont pas remplies, l’installation échoue.

• CPU minimum par cluster : 20 CPU

• Mémoire minimale par cluster : 32 Go

• CPU minimum par nœud : 4 CPU

• Mémoire minimale par nœud : 6 Go

Pour désactiver la vérification du processeur et de la mémoire, utilisez la commande suivante et réexécutez le déploiement.

# ./run -c config-dir deploy -e ignore_iops_check=yes

Utilisez un éditeur de texte pour configurer les informations recommandées suivantes pour Paragon Insights dans les fichiers limits.conf et sysctl.conf . Ces valeurs définissent les limites de mémoire souple et dure pour les exigences de mémoire DB entrantes. Si vous ne définissez pas ces limites, vous pouvez voir des erreurs telles que « mémoire insuffisante » ou « trop de fichiers ouverts » en raison des limites système par défaut.

Répétez cette étape pour tous les nœuds de travail.