HCL Commerce Version 9.1.10.0 or later

Gestionnaire HCL Cache

Le gestionnaire HCL Cache fournit un ensemble d'interfaces REST pour interagir avec le cache, des métriques de surveillance supplémentaires et un ensemble d'utilitaires.



Interfaces REST

Outre les API permettant d'effacer et d'invalider les données en cache, le gestionnaire de cache inclut des API qui peuvent être utilisées pour extraire les détails d'entrée de cache et de dépendance pour les informations de débogage.

Emission d'une suppression du cache sur baseCache :

curl -X 'DELETE' 'https://cache.demoqalive.hcl.com/cm/cache/clear?cache=baseCache' 
Table 1. API REST d'informations Redis :
Méthode Chemin Description
GET /cache/health-check Contrôle d'intégrité du service
GET /cache/redisNodeInfo Informations de topologie Redis
Table 2. Invalider et effacer l'API REST :API permettant d'effacer et d'invalider les caches :
Méthode Chemin Description
DELETE /cache/invalidate Invalide par ID de dépendance
DELETE /cache/clear Efface les caches spécifiés
DELETE /cache/clearall Efface tous les caches enregistrés
DELETE /cache/clearRegistry Effacer le registre
DELETE /cache/publishInvalidation Emet un ID d'invalidation (PUBSUB) dans les caches locaux, mais n'efface pas le cache distant (à des fins de débogage)
Table 3. API REST d'informations de cache :Les API suivantes sont utilisées pour la surveillance ou le débogage :
Méthode Chemin Description
GET /cache Renvoie une liste de tous les caches enregistrés et des tailles actuelles
GET /cache/size Taille distante du cache
GET /cache/id/byDependency Renvoie une liste d'ID de cache associés à un ID de dépendance (pour le débogage)
GET /cache/id/byIds Renvoie les détails de l'entrée de cache pour l'ID spécifié (pour le débogage)

Installation du gestionnaire de cache

Le pod du gestionnaire de cache doit être activé lors de l'installation dans values.yaml en le configurant avec enabled: true.

cacheApp:
  name: cache-app
  enabled: true

Pour la haute disponibilité, vous pouvez choisir d'exécuter des pods de gestionnaire de cache redondants.

Accès au gestionnaire de cache

Vous pouvez accéder au gestionnaire de cache avec port-forwarding ou en activant Ingress. L'API Swagger est disponible sous le chemin /openapi/ui/#/.

Transfert de port
  1. Démarrez le transfert de port vers le service Gestionnaire de cache.
    kubectl port-forward -n commerce service/demoqalivecache-app 40901:40901
  2. Accédez à HCL Cache Manager Swagger/API à l'aide de localhost et du chemin /openapi/ui/#/.
    https://localhost:40901/openapi/ui/#/
Ingress
L'accès à Ingress peut éventuellement être activé dans values.yaml pour les environnements de création et de production. Les nœuds finaux du gestionnaire de cache n'implémentent pas l'authentification. Activez uniquement l'accès via des définitions d'entrée internes et restreintes.
  cache:
    auth:
      enabled: true
      domain: cache.{{ $.Values.common.tenant }}{{ $.Values.common.environmentName }}auth{{ $.Values.common.externalDomain }}
    live:
      enabled: true
      domain: cache.{{ $.Values.common.tenant }}{{ $.Values.common.environmentName }}live{{ $.Values.common.externalDomain }}

Surveillance

Le gestionnaire HCL Cache met à disposition des API distantes uniquement supplémentaires, qui sont utilisées à partir du tableau de bord HCL Cache - Remote :

Mesure Utilisation
hclcache_cache_size_current{ scope="remote" } Taille du cache distant dans les entrées
hclcache_cache_size_maintenance Nombre de clés arrivées à expiration en attente de maintenance
hclcache_cache_remote_node_mapping Mappage entre les nœuds HCL Cache et Redis
Pour plus de détails, voir Surveillance.

Utilitaires

Le pod du gestionnaire de cache met également à disposition un certain nombre d'utilitaires de cache pour les tests de performance, le débogage et la configuration. Ils sont disponibles sous le répertoire /SETUP/hcl-cache/utilities. Pour plus d'informations, voir Utilities.md