Gestión del agente Monitoring en Red Hat OpenShift utilizando un gráfico HELM

Puede utilizar un diagrama de Helm para instalar, actualizar y suprimir un agente de Monitoring en un clúster de Kubernetes.

Antes de empezar

Instale la última versión de la versión 3 de Helm CLI en su máquina local.

Helm es un gestor de paquetes Kubernetes que utiliza gráficos Helm para definir, instalar y actualizar aplicaciones Kubernetes complejas en su clúster. Los diagramas de Helm empaquetan las especificaciones para generar archivos YAML para los recursos de Kubernetes que crean la app. Estos recursos de Kubernetes se aplican automáticamente en el clúster y Helm les asigna una versión. También puede utilizar Helm para especificar y empaquetar su propia app y dejar que Helm genere los archivos YAML para los recursos de Kubernetes.
Compruebe que tiene acceso y permisos para desplegar el agente Monitoring en el clúster.
Verifique que el espacio de nombres de ibm-observe esté disponible en el clúster. El agente se despliega en este espacio de nombres.

Desplegar un agente

Realice los pasos siguientes para desplegar un agente utilizando Helm:

Paso 1. Configurar el repositorio Sysdig Helm

Añada el repositorio de Helm de Monitoring a la instancia de Helm.

Complete los pasossiguientes:

Establezca el contexto del clúster.

obmcloud ks cluster config --cluster <CLUSTER_NAME>

Añada el repositorio Helm.

helm repo add sysdig https://charts.sysdig.com

Actualice los repositorios para recuperar las versiones más recientes de todos los diagramas de Helm.
```
helm repo update
```
Lista los gráficos Helm que están actualmente disponibles para el repositorio Sysdig.
```
helm search repo sysdig
```
Verifique que se lista el Helm sysdig/sysdig-deploy.

si obtiene el siguiente error:

helm repo add sysdig https://charts.sysdig.com    --debug
Error: context deadline exceeded
helm.go:84: [debug] context deadline exceeded

Ejecute el mandato siguiente e inténtelo de nuevo.

rm $HOME/Library/Preferences/helm/repositories.lock

Paso 2. Crear el archivo yaml de valores

Defina un archivo yaml e incluya los valores para desplegar el agente Monitoring y los componentes Workload Protection que tiene previsto desplegar. Por ejemplo, asigne el nombre agent-values-monitor-secure.yaml al archivo.

El siguiente yaml es una plantilla que puede utilizar para configurar el agente Monitoring y los componentes Workload Protection. Puede personalizar el archivo eliminando o comentando con # las secciones que no son necesarias para el despliegue del agente.

global:
  clusterConfig:
    name: CLUSTER_NAME
  sysdig:
    accessKey: MONITORING_INSTANCE_ACCESS_KEY
    secureAPIToken: SECURE_TOKEN
  kspm:
    deploy: true
agent:
  image:
    tag: AGENT_TAG
    registry: icr.io
  slim:
    enabled: true
    image:
      repository: ext/sysdig/agent-slim
    kmoduleImage:
      repository: ext/sysdig/agent-kmodule
  collectorSettings:
    collectorHost: INGESTION_ENDPOINT    # for example, ingest.eu-gb.monitoring.cloud.ibm.com
nodeAnalyzer:
  nodeAnalyzer:
    deploy: true
    apiEndpoint: API_ENDPOINT   # for example, eu-gb.monitoring.cloud.ibm.com
    benchmarkRunner:
      deploy: false
kspmCollector:
  apiEndpoint: API_ENDPOINT    # for example, eu-gb.monitoring.cloud.ibm.com
admissionController:
  enabled: true
  sysdig:
    url: WEB_UI_ENDPOINT    # for example, https://ingest.eu-gb.monitoring.cloud.ibm.com
  clusterName: CLUSTER_NAME

Donde

CLUSTER_NAME es el nombre del clúster donde está desplegando el agente.
MONITORING_INSTANCE_ACCESS_KEY es la clave de acceso de instancia de Monitoring.
SECURE_TOKEN es la señal de API segura.
AGENT_TAG es la versión del agente que planea desplegar.
INGESTION_ENDPOINT es el punto final de ingestión de la instancia.
API_ENDPOINT es el punto final de API de intance.
WEB_UI_ENDPOINT es el punto final de interfaz de usuario web de la instancia.

Ejemplo de archivo yaml de valores para desplegar el agente

Por ejemplo, consulte el ejemplo siguiente de un archivo de valores que despliega solo el agente Monitoring:

global:
  clusterConfig:
    name: mycluster-au-syd
  sysdig:
    accessKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    secureAPIToken: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  kspm:
    deploy: true
agent:
  image:
    registry: icr.io
  slim:
    enabled: true
    image:
      repository: ext/sysdig/agent-slim
    kmoduleImage:
      repository: ext/sysdig/agent-kmodule
  collectorSettings:
    collectorHost: ingest.au-syd.monitoring.cloud.ibm.com

Ejemplo de archivo yaml de valores para desplegar el agente y Node Analyzer

Por ejemplo, consulte el ejemplo siguiente de un archivo de valores que despliega el agente Monitoring y el componente Node Analyzer:

global:
  clusterConfig:
    name: mycluster-au-syd
  sysdig:
    accessKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    secureAPIToken: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  kspm:
    deploy: true
agent:
  image:
    registry: icr.io
  slim:
    enabled: true
    image:
      repository: ext/sysdig/agent-slim
    kmoduleImage:
      repository: ext/sysdig/agent-kmodule
  collectorSettings:
    collectorHost: ingest.au-syd.monitoring.cloud.ibm.com
nodeAnalyzer:
  nodeAnalyzer:
    deploy: true
    apiEndpoint: API_ENDPOINT   # for example, eu-gb.monitoring.cloud.ibm.com
    benchmarkRunner:
      deploy: false

Paso 3. Instalar la gráfica de Helm

Para desplegar el agente, los componentes Workload Protection, o ambos, debe instalar el gráfico sysdig/sysdig-deploy y utilizar el archivo yaml de variables que ha configurado en el paso anterior.

Ejecute el mandato siguiente para instalar el agente utilizando el diagrama de Helm:

helm install -n ibm-observe sysdig-agent sysdig/sysdig-deploy -f agent-values-monitor-secure.yaml

Si encuentra el siguiente error: Error: INSTALLATION FAILED: Kubernetes cluster unreachable: xxxxxx failed to refresh token: oauth2: cannot fetch token: 400 Bad Request, establezca el contexto de clúster e inténtelo de nuevo.

Actualizar un agente

Para actualizar la versión del agente utilizando Helm, realice los pasos siguientes:

Actualice el gráfico.
```
helm repo update
```
Busque el archivo yaml de valores que ha utilizado para desplegar el agente y modifique agent.image.tag con la versión del agente que desea desplegar.

Actualice el agente.

helm upgrade -n ibm-observe sysdig-agent sysdig/sysdig-deploy -f agent-values-monitor-secure.yaml

Eliminar un agente

Para suprimir el agente utilizando Helm, debe desinstalar el diagrama.

Complete los pasossiguientes:

Enumera las cartas que están instaladas.

helm list -n ibm-observe

La salida del comando enumera los gráficos de la siguiente manera:

NAME        	NAMESPACE  	REVISION	UPDATED                             	STATUS  	CHART              	APP VERSION
sysdig-agent	ibm-observe	1       	2023-03-24 15:02:58.408108 +0100 CET	deployed	sysdig-deploy-1.6.3

Desinstale el gráfico.
```
helm delete sysdig-agent  -n ibm-observe
```
En términos de Helm, sysdig-agent es el nombre del release de teh.

Si olvida incluir el espacio de nombres en el mandato, obtendrá el error folloqing: Error: uninstall: Release not loaded: sysdig-agent: release: not found.