Saltar a contenido

Instalación en Openshift

Requisitos previos

  • Disponer de un clúster Openshift listo.
  • Estar conectado al clúster mediante la línea de comandos.
  • Disponer de una máquina con oc y helm instalados.

Instalar las herramientas necesarias

En la máquina o VM que utilizará para administrar el clúster:

Configuración inicial

En los charts que descargará hay disponible un archivo README.md que describe los parámetros básicos del proyecto:

  • Cree un proyecto llamado latence. Se puede utilizar otro nombre, pero entonces los archivos yaml deberán modificarse en consecuencia.
oc new-project latence
  • Cree una serviceaccount con permiso para contenedores privilegiados.
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

Instalar el Analyzer en Openshift

Obtener los archivos necesarios

  • Descargue el archivo zip que contiene los charts:
wget https://api.latence.ca/software/openshift-analyzer-helm.zip
  • Descomprima los archivos:
unzip openshift-analyzer-helm.zip

Instalar el Analyzer

  • Deberemos modificar 2 parámetros en nuestro archivo values.yaml:
    1) La Licencia de Latencetech.
    2) La dirección IP que utilizará el servicio Kafka.

  • Averigüe el rango de IP de su clúster con:

oc get svc
  • En este ejemplo, utilizaremos la IP de clúster 172.30.0.1.
  • Modificaremos el archivo values.yaml definiendo la dirección IP de kafka como 172.30.0.23.

Este es el aspecto que tiene ahora la sección de la dirección IP modificada:

kafka:
    enabled: true
    pvcSize: 2Gi
    svcPort: 12092
    ingressEnabled: true
    svcClusterIp: "172.30.0.23"
    zookeeperEndpoint: "zookeeper"
  • Una vez definidas la licencia y la IP, podemos instalar el Analyzer ejecutando este comando:
helm install analyzer openshift-analyzer-helm/
  • Espere 60-75 segundos para que se desplieguen todos los servicios y pods.
  • Puede comprobar el estado del despliegue ejecutando:
oc get all
  • Si ha establecido el flag deployLoadBalancer del archivo values.yaml en true, puede obtener la dirección IP externa con:
oc get svc

Si ha activado el Load Balancer desde el archivo values.yaml, obtendrá 2 direcciones externas:

  • una para Grafana e Influxdb
  • una para Kafka, que deberá utilizarse en la configuración del qos-agent

API

Si la API no funciona, elimine el configmap y vuelva a lanzarla

oc delete cm org-config

helm uninstall analyzer openshift-analyzer-helm/

helm install analyzer openshift-analyzer-helm/

Para obtener su clave API, puede consultar los registros del contenedor latencetech_api con:

oc logs <pod ID>

Instalar el Reflector en Openshift

Obtener los archivos necesarios

Descargue el archivo zip que contiene los charts:

wget https://api.latence.ca/software/openshift-reflector-helm.zip
  • Descomprima los archivos:
unzip openshift-reflector-helm.zip

Instalar el Reflector

  • Deberemos modificar 1 parámetro en nuestro archivo values.yaml:
    1) La Licencia de Latencetech.

  • Puede modificar el LTI_reflector_id, pero dejarlo en 1 también funcionará

  • Una vez definidos todos los parámetros, podemos instalar el reflector ejecutando este comando:
helm install reflector openshift-reflector-helm/
  • Puede comprobar el estado del despliegue ejecutando:
oc get all
  • El reflector-load-balancer será la IP externa que utilizará con su QoS-Agent.

Instalar el Agent en Openshift

Obtener los archivos necesarios

Descargue el archivo zip que contiene los charts:

wget https://api.latence.ca/software/openshift-agent-helm.zip
  • Descomprima los archivos:
unzip openshift-agent-helm.zip

Instalar el Agent

  • Deberemos modificar 4 parámetros obligatorios en nuestro archivo values.yaml:
    1) La Licencia de Latencetech.
    2) El ID del Agent (un número entero).
    3) El ID del Customer (un número entero).
    4) La dirección IP del Reflector (puede ser un FQDN)
    5) La dirección IP del Analyzer (debe estar 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"
  • También podemos modificar la sección de metadatos; estos datos se mostrarán en el Analyzer y le permitirán supervisar su agente con mayor facilidad.
####### 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
  • Puede modificar los demás parámetros pertenecientes al qos-agent en la sección siguiente.
  • Una vez definidos todos los parámetros, podemos instalar el agente ejecutando este comando:
helm install agent openshift-agent-helm/
  • Puede comprobar el estado del despliegue ejecutando:
oc get all