Aller au contenu

Installation Openshift

Prérequis

  • Avoir un cluster Openshift prêt.
  • Être connecté au cluster via la ligne de commande.
  • Avoir une machine avec oc et helm installés.

Installer les outils nécessaires

Sur la machine ou VM que vous utiliserez pour administrer le cluster :

Configuration initiale

Un fichier README.md est disponible dans les charts que vous téléchargerez pour décrire les paramètres de base du projet :

  • Créez un projet appelé latence. Un autre nom peut être utilisé mais les fichiers yaml devront alors être modifiés en conséquence.
oc new-project latence
  • Créez un serviceaccount avec permission pour les conteneurs privilégiés.
oc create serviceaccount -n latence privilegeduser
oc adm policy add-scc-to-user privileged -n latence -z privilegeduser
oc adm policy add-scc-to-user anyuid -z privilegeduser -n latence

Installer l'Analyzer sur Openshift

Obtenir les fichiers nécessaires

  • Téléchargez le fichier zip contenant les charts :
wget https://api.latence.ca/software/openshift-analyzer-helm.zip
  • Décompressez les fichiers :
unzip openshift-analyzer-helm.zip

Installer l'Analyzer

  • Nous devrons modifier 2 paramètres dans notre fichier values.yaml :
    1) La Licence Latencetech.
    2) L'adresse IP que le service Kafka utilisera.

  • Apprenez la plage d'IP de votre cluster avec :

oc get svc
  • Dans cet exemple, nous utiliserons l'IP de cluster 172.30.0.1.
  • Nous allons modifier le fichier values.yaml en définissant l'adresse IP kafka comme 172.30.0.23.

Voici à quoi ressemble maintenant la section de l'adresse IP modifiée :

kafka:
    enabled: true
    pvcSize: 2Gi
    svcPort: 12092
    ingressEnabled: true
    svcClusterIp: "172.30.0.23"
    zookeeperEndpoint: "zookeeper"
  • Une fois la licence et l'IP définies, nous pouvons installer l'Analyzer en exécutant cette commande :
helm install analyzer openshift-analyzer-helm/
  • Attendez 60-75 secondes pour que tous les services et pods soient déployés.
  • Vous pouvez vérifier l'état du déploiement en exécutant :
oc get all
  • Si vous avez défini le flag deployLoadBalancer dans le fichier values.yaml à true, vous pouvez obtenir l'adresse IP externe en faisant :
oc get svc

Si vous avez activé le Load Balancer depuis le fichier values.yaml, vous obtiendrez 2 adresses externes :

  • une pour Grafana et Influxdb
  • une pour Kafka qui devra être utilisée dans la configuration du qos-agent

API

Si l'API ne fonctionne pas, supprimez le configmap et relancez

oc delete cm org-config

helm uninstall analyzer openshift-analyzer-helm/

helm install analyzer openshift-analyzer-helm/

Pour obtenir votre clé API, vous pouvez consulter les logs du conteneur latencetech_api avec :

oc logs <pod ID>

Installer le Reflector sur Openshift

Obtenir les fichiers nécessaires

Téléchargez le fichier zip contenant les charts :

wget https://api.latence.ca/software/openshift-reflector-helm.zip
  • Décompressez les fichiers :
unzip openshift-reflector-helm.zip

Installer le Reflector

  • Nous devrons modifier 1 paramètre dans notre fichier values.yaml :
    1) La Licence Latencetech.

  • Vous pouvez modifier le LTI_reflector_id, mais le laisser à 1 fonctionnera également

  • Une fois tous les paramètres définis, nous pouvons installer le reflector en exécutant cette commande :
helm install reflector openshift-reflector-helm/
  • Vous pouvez vérifier l'état du déploiement en exécutant :
oc get all
  • Le reflector-load-balancer sera l'IP externe que vous utiliserez avec votre QoS-Agent.

Installer l'Agent sur Openshift

Obtenir les fichiers nécessaires

Téléchargez le fichier zip contenant les charts :

wget https://api.latence.ca/software/openshift-agent-helm.zip
  • Décompressez les fichiers :
unzip openshift-agent-helm.zip

Installer l'Agent

  • Nous devrons modifier 4 paramètres obligatoires dans notre fichier values.yaml :
    1) La Licence Latencetech.
    2) L'ID de l'Agent (un entier).
    3) L'ID du Customer (un entier).
    4) L'adresse IP du Reflector (peut être un FQDN)
    5) L'adresse IP de l'Analyzer (doit être en CIDR)
# Agent Environment Variables
agent:
    LTI_agent_id: "TO-BE-SET"
    LTI_customer_id: "TO-BE-SET"
    LTI_reflector: "TO-BE-SET"
    ANALYZER_IP: "TO-BE-SET"
  • Nous pouvons également modifier la section des métadonnées, ces données seront affichées sur l'Analyzer et vous permettront de surveiller plus facilement votre agent.
####### Metadata
    LTI_agent_name: "TO-BE-SET"
    LTI_agent_hardware: "TO-BE-SET"
    LTI_agent_net_type: "TO-BE-SET"
    LTI_agent_net_name: "TO-BE-SET"
    LTI_agent_address: "TO-BE-SET"
    LTI_agent_gps_pos: "TO-BE-SET"
    LTI_agent_details: "TO-BE-SET"
    LTI_agent_expected_application_latency: 30
    LTI_agent_expected_stability: 95
  • Vous pouvez modifier les autres paramètres appartenant au qos-agent dans la section qui suit.
  • Une fois tous les paramètres définis, nous pouvons installer l'agent en exécutant cette commande :
helm install agent openshift-agent-helm/
  • Vous pouvez vérifier l'état du déploiement en exécutant :
oc get all