Entity name change
While adding the NetScaler entities, the NetScaler Ingress Controller maintains unique names per Ingress, service or namespace. Sometimes, it results in NetScaler entities with large names even exceeding the name limits in NetScaler.
Now, the naming format in the NetScaler Ingress Controller is updated to shorten the entity names. In the updated naming format, a part of the entity name is hashed and all the necessary information is provided as part of the entity comments.
After this update, the comments available on
lbvserver and servicegroup entity names provides all the necessary details like the ingress name, ingress port, service name, service port, and the namespace of the application.
Format for comments
Ingress:
ing:<ingress-name>,ingport:<ingress-port>,ns:<k8s-namespace>,svc:<k8s-servicename>,svcport:<k8s-serviceport>
Service of
type LoadBalancer: lbsvc:<k8s-servicename>,svcport:<k8s-serviceport>,ns:<k8s-namespace>
The following table explains the entity name changes introduced with the NetScaler Ingress Controller version 1.12.
| Entity | Old naming format | New naming format | Description/Comments |
|---|---|---|---|
csvserver (ingress) |
k8s-192.2.170.67_80_http |
k8s-192.2.170.67_80_http |
no changes |
csvserver (type LoadBalancer) |
k8s-apache_default_80_svc |
k8s-apache_80_default_svc |
Now, the port is followed by a namespace |
lbvserver (type LoadBalancer) |
k8s-apache_default_80_svc_k8s-apache_default_80_svc |
k8s-apache_80_lbv_wlikeqxno5vunbthsoj4lxegk7cddh6p Comment: lbsvc:apache,svcport:80,ns:default |
The comment for type LoadBalancer is now different |
servicegroup (type LoadBalancer) |
k8s-apache_default_80_svc_k8s-apache_default_80_svc |
k8s-apache_80_sgp_wlikeqxno5vunbthsoj4lxegk7cddh6p |
The suffix sgp is added |
cspolicy or csaction or responder policy |
k8s-web-ingress_default_443_k8s-frontend_default_80_svc |
k8s-frontend_80_csp_267pneiak5rw6hoygvrqrzpm4k6thz2p |
Moved service-name, service-port to the beginning, added suffix of cs, hashed ingress-name, ingress-port, and namespace |
lbvserver (ingress) |
k8s-web-ingress_default_443_k8s-frontend_default_80_svc |
k8s-frontend_80_lbv_267pneiak5rw6hoygvrqrzpm4k6thz2p Comment: ing:web-ingress,ingport:5080,ns:default,svc:frontend,svcport:80 |
Suffix lbv and comment added to the entity |
servicegroup (ingress) |
k8s-web-ingress_default_443_k8s-frontend_default_80_svc |
k8s-frontend_80_sgp_267pneiak5rw6hoygvrqrzpm4k6thz2p |
Suffix sgp is added. |
lbvserver (UDP) |
k8s-web-ingress_default_9053-udp_k8s-bind_default_53-udp_svc |
k8s-bind_53-udp_lbv_uyomblblagixrtw3cxrf23tak6wkpfmw |
-udp is still appended to the port as earlier. |
When you upgrade from an older version of the NetScaler Ingress Controller to the latest version, the NetScaler Ingress Controller renames all the entities with the new naming format. However, the NetScaler Ingress Controller does not handle the downgrade from the latest version to an older version.