Kubernetes: Ingress, Gateway API & Service Mesh: glossary
110 terms, in plain words, with where each one is taught.
- /dbg (/dbg backends)
- A debug tool inside the ingress-nginx controller pod that prints the backends nginx uses, including the pod addresses that are not in nginx.conf. Lesson 21.2
- ACME Challenge (challenges.acme.cert-manager.io)
- The cert-manager object for proving control of one name to the ACME server. Its reason field says what is blocking the certificate. Lesson 21.10
- ACME Order (orders.acme.cert-manager.io)
- The cert-manager object for one ACME order: the names asked for and, when done, the signed certificate. Lesson 21.10
- allowlist-source-range (whitelist-source-range)
- An ingress-nginx annotation that lets only clients from listed address ranges reach an Ingress; others get 403. It checks the address nginx sees, which is a node address unless the controller Service keeps client addresses (externalTrafficPolicy: Local). Lesson 21.2
- ambient mode (istio.io/dataplane-mode=ambient)
- Istio without sidecars: a ztunnel per node handles L4 (mTLS, identity) and optional waypoint proxies handle L7. Lesson 21.38
- app-root (permanent-redirect)
- ingress-nginx annotations that answer with a redirect: app-root sends requests for / to another path, permanent-redirect sends every request to another URL. Lesson 21.2
- appProtocol (kubernetes.io/h2c)
- A Service port field that tells proxies which protocol the backend speaks, such as kubernetes.io/h2c for plain-text HTTP/2. Lesson 21.20
- The Istio object that says who may call a workload: rules on source identity, namespace, method and path, with action ALLOW, DENY, AUDIT or CUSTOM. CUSTOM runs first, then DENY, then ALLOW: if any ALLOW policy selects the workload, a request must match one of them. Lesson 21.29
- auto mTLS
- Istio's default: a client sidecar uses mTLS whenever the server has a sidecar, with no configuration. Lesson 21.29
- backend-protocol (backend-protocol annotation)
- An ingress-nginx annotation that says which protocol the backend speaks (HTTP, HTTPS, GRPC). A backend that speaks HTTPS behind the default HTTP gives 502 errors. Lesson 21.3
- canary Ingress (canary annotations, canary-weight, canary-by-header)
- A second Ingress for the same host and path marked with the canary annotation. It takes a share of the traffic by weight, header or cookie instead of replacing the first one. Lesson 21.2
- Certificate (cert-manager) (Certificate resource, kind: Certificate)
- The cert-manager object that describes a certificate you want: names, issuer, duration and the Secret to store it in. cert-manager keeps that Secret valid. Lesson 21.10
- CertificateRequest
- A cert-manager object for one attempt to get a certificate: the CSR sent to the issuer and its answer. Each issuance or renewal creates a new one. Lesson 21.10
- circuit breaking (mesh) (connectionPool, http1MaxPendingRequests, maxConnections)
- DestinationRule connection pool limits: above them the client proxy fails requests at once (flag UO) instead of queueing them. Lesson 21.35
- ClusterIssuer
- A cert-manager issuer that the whole cluster can use. An Issuer only works in its own namespace. Lesson 21.10
- cmctl
- The cert-manager command line tool: status of a certificate and its chain, renew now, inspect a certificate Secret, check that the API is ready. Lesson 21.10
- Conflicted (Conflicted condition)
- A listener condition meaning two listeners on the same Gateway clash, for example the same port and hostname with different protocols. Lesson 21.19
- controller ConfigMap (ingress-nginx-controller ConfigMap)
- The ConfigMap that sets ingress-nginx's global defaults (timeouts, body size, log format) for every Ingress it serves. Annotations override it per Ingress. Lesson 21.2
- custom default backend (--default-backend-service)
- A Service the ingress controller sends requests to when no rule matches, instead of its own 404 page. Lesson 21.3
- DC
- Envoy response flag: the downstream (the client) closed the connection before the answer. Lesson 21.36
- default retry policy (retries.attempts, retryOn)
- Istio retries a request twice by default on connection failures and 503-type errors, unless a VirtualService sets its own retries. Lesson 21.35
- DestinationRule
- The Istio object that decides how to talk to a destination: subsets, load balancing, connection pool limits, outlier detection and TLS. Lesson 21.35
- DI (FI)
- Envoy response flags for injected faults: DI = the request was delayed, FI = it was aborted. Lesson 21.36
- DNS provider (external-dns provider)
- The DNS service external-dns writes to: a cloud DNS service, or a classic DNS server through rfc2136. Lesson 21.11
- DNS-01 (DNS-01 challenge, dns01)
- An ACME challenge where you prove you control a name by creating a TXT record for it. Needed for wildcard certificates. Lesson 21.10
- east-west traffic (east-west)
- Traffic between Services inside the cluster, from one workload to another. A service mesh is mostly about this direction. Lesson 21.1
- edge proxy (edge proxies)
- The proxy where outside traffic first enters the cluster: an ingress controller or a Gateway, usually behind a LoadBalancer Service. Lesson 21.1
- Envoy (Envoy proxy)
- An open source L7 proxy, configured over xDS. Istio's sidecars, ingress gateway and waypoints are all Envoy. Lesson 21.27
- Envoy cluster (outbound|, inbound|)
- Envoy's name for a group of endpoints it can send to. In Istio it is written outbound|PORT|SUBSET|FQDN, for example outbound|80|v2|reviews.shop.svc.cluster.local. Lesson 21.36
- external-dns (ExternalDNS)
- A controller that reads hostnames from Ingresses, Services and routes and writes matching DNS records to a DNS provider. Lesson 21.11
- fail closed (failurePolicy: Fail)
- A webhook setting where the API server refuses the request if the webhook cannot be reached. Istio's injection webhook does this, so new pods cannot be created while istiod is down. Lesson 21.28
- fault injection (fault delay, fault abort)
- A VirtualService feature that delays or fails a share of requests on purpose, to test how callers cope. Lesson 21.35
- filter_chain_not_found
- What the server's proxy logs when a plain-text client connects to a STRICT port: no listener filter chain accepts it, so the connection is reset. Lesson 21.29
- fortio
- A load-testing tool from the Istio project that prints latency percentiles and response codes. Lesson 21.37
- GAMMA
- The Gateway API initiative for mesh traffic: routes whose parent is a Service describe east-west routing in the same API as the edge. Lesson 21.38
- generated nginx.conf (/etc/nginx/nginx.conf, nginx -T)
- The nginx configuration file the ingress-nginx controller writes from all Ingresses, their annotations and its ConfigMap. It is what nginx actually runs.
kubectl exec -n ingress-nginx deploy/ingress-nginx-controller -- cat /etc/nginx/nginx.conf. Lesson 21.2 - GRPCRoute
- A Gateway API route for gRPC traffic, matching by gRPC service and method instead of path. The backend Service port needs appProtocol kubernetes.io/h2c (or the TLS variant). Lesson 21.20
- HTTP-01 (HTTP-01 challenge, http01)
- An ACME challenge where you prove you control a name by serving a token at http://<name>/.well-known/acme-challenge/<token>. It cannot issue wildcard certificates. Lesson 21.10
- ingress-nginx retirement
- The end of the community ingress-nginx project: announced 11 November 2025, maintained on a best-effort basis until March 2026, with no releases or security fixes after that. Lesson 21.2
- ingress-shim (cert-manager.io/cluster-issuer, cert-manager.io/issuer)
- The part of cert-manager that reads an annotation on an Ingress or Gateway and creates the Certificate for its TLS hosts for you. Lesson 21.10
- ingress2gateway
- A Kubernetes SIGs tool that reads Ingresses and prints the matching Gateway API objects, with warnings for what it cannot translate. It changes nothing itself. Lesson 21.21
- installation profile (istioctl profile, profile=default, profile=minimal)
- A preset of Istio components and settings for istioctl install: default, minimal, demo, ambient and others. Lesson 21.28
- Istio
- A widely used service mesh built on Envoy, run by its control plane istiod. Lesson 21.27
- Istio CNI (istio-cni)
- An Istio node agent that sets up the traffic redirection when a pod starts, so pods need no privileged istio-init container. Lesson 21.28
- istio_requests_total (istio_request_duration_milliseconds)
- The standard Istio request metrics every proxy reports, labelled by reporter, source, destination and response code. Lesson 21.37
- istio-init
- The init container Istio injects to set iptables rules that send the pod's traffic through the proxy (ports 15001 outbound, 15006 inbound). Lesson 21.28
- istio.io/rev (revision label)
- A namespace label that picks which Istio control plane revision injects its pods, used for canary upgrades of Istio itself. Lesson 21.28
- istioctl
- Istio's command line tool: install, analyze, proxy-status, proxy-config, describe. Lesson 21.28
- istioctl analyze (IST0101, IST0102, IST0103)
- An istioctl command that checks the cluster's Istio configuration for mistakes and prints coded messages, such as IST0101 for a reference to something that does not exist. Lesson 21.28
- istiod
- Istio's control plane: it turns Services and Istio objects into Envoy configuration, sends it to every proxy and signs workload certificates. Lesson 21.28
- Linkerd
- A service mesh with a smaller feature set and its own lightweight proxy, usually simpler to run than Istio. Lesson 21.38
- match precedence (route precedence)
- How Gateway API picks a rule: an exact path beats a prefix, a longer prefix beats a shorter one, then the method, then more header matches. Rule order only breaks ties. Lesson 21.20
- mesh control plane (control plane (mesh))
- In a service mesh, the component that configures every proxy and issues workload certificates. In Istio it is istiod. Lesson 21.27
- mesh data plane (data plane (mesh))
- In a service mesh, the proxies that carry the traffic: one next to each pod in sidecar mode. Lesson 21.27
- native sidecar (restartable init container, restartPolicy: Always)
- A container in initContainers with restartPolicy Always: it starts before the app containers, keeps running and stops after them. Lesson 21.28
- NC (cluster_not_found)
- Envoy response flag: the route points at a cluster that does not exist, often a subset no DestinationRule defines. Lesson 21.36
- NGINX Gateway Fabric (NGF, gateway.nginx.org)
- A Gateway API implementation built on nginx, with GatewayClass nginx. The lab's main Gateway controller. Lesson 21.19
- NoMatchingParent (NoMatchingListenerHostname)
- Route reasons: no listener has the sectionName or port the route asked for, or no listener hostname matches the route's hostnames. Lesson 21.19
- north-south traffic (north-south)
- Traffic that enters or leaves the cluster, such as users calling a website. It passes through an edge proxy. Lesson 21.1
- NotAllowedByListeners
- The reason a route gets when no listener of its Gateway admits routes from its namespace (allowedRoutes). Lesson 21.19
- NR (route_not_found)
- Envoy response flag: no route matched the request (or no filter chain matched the connection). Lesson 21.36
- outlier detection (outlierDetection, ejection)
- A DestinationRule setting that takes an endpoint out of the pool for a while after consecutive errors. Lesson 21.35
- Pebble
- A small ACME server made for testing. The lab uses it in place of Let's Encrypt. Lesson 21.10
- PeerAuthentication (STRICT, PERMISSIVE, peer authentication)
- The Istio object that says what a workload accepts: STRICT (mTLS only), PERMISSIVE (mTLS and plain text) or DISABLE. Workload beats namespace beats mesh-wide; portLevelMtls overrides one port. Lesson 21.29
- pilot-agent
- The process in the istio-proxy container that starts Envoy and manages its certificates;
pilot-agent request GET statsreads Envoy's counters. Lesson 21.36 - portLevelMtls
- A PeerAuthentication field that sets a different mode for one container port, such as PERMISSIVE on a port legacy clients still use. Lesson 21.29
- Programmed (Programmed condition)
- A Gateway or listener condition meaning the controller has configured the data plane for it: it has an address and is serving. Lesson 21.19
- proxy-config (istioctl proxy-config, istioctl pc)
- An istioctl command that shows what one proxy was told: its clusters, listeners, routes, endpoints and certificates. Lesson 21.36
- proxy-read-timeout (proxy-connect-timeout, proxy-send-timeout)
- ingress-nginx settings for how many seconds nginx waits for a backend to connect, accept data or answer. When the read timeout passes, the client gets a 504. The default is 60 seconds. Lesson 21.2
- proxy-status (istioctl proxy-status, SYNCED, STALE)
- An istioctl command that lists every proxy, its istiod and whether it has acknowledged the latest configuration (SYNCED) or not (STALE). Lesson 21.28
- proxyless (proxyless gRPC)
- A mesh client that talks xDS itself (some gRPC libraries can), so it needs no sidecar. Lesson 21.27
- RBAC: access denied
- The body of the 403 an Istio proxy returns when an AuthorizationPolicy refuses a request. Lesson 21.29
- re-encrypt (re-encryption)
- A TLS setup where the edge proxy decrypts a request and then opens a new TLS connection to the backend, so traffic is encrypted on both sides. Lesson 21.1
- redirect loop (ssl-redirect loop, ERR_TOO_MANY_REDIRECTS)
- A request that is redirected again and again, for example when TLS ends at a load balancer and the controller keeps redirecting the plain HTTP it receives to HTTPS. Lesson 21.3
- release channel (standard channel, experimental channel)
- Gateway API ships its CRDs in two sets: standard (stable kinds and fields) and experimental (fields still being tried). Lesson 21.19
- renewBefore (certificate renewal)
- How long before a certificate expires cert-manager renews it. By default renewal starts when two thirds of its lifetime has passed. Lesson 21.10
- reporter (reporter="source", reporter="destination")
- The metrics label that says which proxy counted a request: the client's (source) or the server's (destination). Lesson 21.37
- RequestMirror (traffic mirroring)
- An HTTPRoute filter that sends a copy of each request to another backend and throws its answer away. The copy is a real request: mirror read-only paths. Lesson 21.20
- RequestRedirect
- An HTTPRoute filter that answers the client with a redirect (301 or 302) to another scheme, host, port or path. Lesson 21.20
- resource record (RR)
- One entry in a DNS zone, such as an A record for shop.lab. external-dns logs each one it adds as "Adding RR". Lesson 21.11
- response flag (response flags, RESPONSE_FLAGS)
- A short code in an Envoy access log line that says why a request ended the way it did, such as UH (no healthy upstream) or UT (timeout). A dash means nothing special happened. Lesson 21.1
- retry amplification (retry multiplication)
- Retries at several layers multiplying each other: three layers with three tries each can turn one request into 27 calls to the bottom service. Lesson 21.35
- rfc2136 (RFC 2136, dynamic DNS update)
- The standard for sending updates to a DNS server, used by external-dns to add and remove records on classic servers such as BIND. Lesson 21.11
- RL
- Envoy response flag: the request was refused by a local rate limit. Lesson 21.36
- route filter (RequestHeaderModifier, ResponseHeaderModifier)
- A step an HTTPRoute rule applies to matching requests: change headers, redirect, rewrite the URL or mirror a copy. Lesson 21.20
- route timeouts (timeouts.request, timeouts.backendRequest)
- HTTPRoute fields that limit how long the Gateway waits: request for the whole request, backendRequest for one try to the backend. Past them the client gets 504. Lesson 21.20
- sectionName
- The field in a route's parentRef that names one listener of the Gateway to attach to, such as https. Lesson 21.19
- self check (propagation check)
- cert-manager fetching its own challenge URL (or DNS record) before telling the ACME server to check it. While it fails, the Challenge waits and says why. Lesson 21.10
- side-by-side cutover (DNS cutover)
- Running the new edge next to the old one with its own address, testing it, then moving users by changing DNS. Pointing DNS back is the rollback. Lesson 21.21
- sidecar injection (istio-injection=enabled)
- Istio adding its proxy to a pod when the pod is created, through a mutating webhook, for namespaces or pods that opt in. Existing pods need a restart to get it. Lesson 21.28
- SIG (SIG Network, Kubernetes SIGs)
- A Kubernetes Special Interest Group: the community team that owns one area, such as SIG Network for Services, Ingress and Gateway API. Lesson 21.2
- snippet annotation (configuration-snippet, server-snippet, snippets)
- An ingress-nginx annotation that pastes raw nginx configuration from an Ingress into the shared config. Disabled by default because it let Ingress authors read the controller's secrets. Lesson 21.2
- solver pod (cm-acme-http-solver)
- The short-lived pod (with its Service and Ingress or route) that cert-manager starts to serve an HTTP-01 token, removed when the challenge ends. Lesson 21.10
- SPIFFE ID (SPIFFE, spiffe://)
- A workload identity written as a URI, such as spiffe://cluster.local/ns/shop/sa/web. Istio puts it in each workload's certificate, based on its service account. Lesson 21.29
- subset (subsets)
- A named group of a Service's pods selected by labels in a DestinationRule, such as v1 and v2, that a VirtualService can route to. Lesson 21.35
- Telemetry (Istio) (Telemetry API, kind: Telemetry)
- The Istio object that turns access logs, metrics and tracing on or off per mesh, namespace or workload. Lesson 21.37
- trace header propagation (traceparent, x-b3-traceid)
- The app copying the trace headers of an incoming request onto the calls it makes, so the hops join into one trace. Lesson 21.37
- TXT registry (ownership record, txt-owner-id)
- external-dns's way of remembering which records it created: a TXT record next to each one with its owner id. It never changes records without one. Lesson 21.11
- UF (UC)
- Envoy response flags: UF = could not connect to the upstream, UC = the upstream connection was closed after it was established. Lesson 21.36
- UH (no_healthy_upstream)
- Envoy response flag: no healthy upstream. The cluster has no endpoints that may receive traffic. Lesson 21.36
- UO
- Envoy response flag: upstream overflow. A connection pool limit refused the request. Lesson 21.36
- upsert-only (--policy=upsert-only, --policy=sync)
- An external-dns policy: create and update records but never delete them. The other policy, sync, also deletes records whose source is gone. Lesson 21.11
- URLRewrite (ReplacePrefixMatch, ReplaceFullPath)
- An HTTPRoute filter that changes the path or host before the request reaches the backend. The client does not notice. Lesson 21.20
- URX
- Envoy response flag: the retry limit was reached and the last try failed. Lesson 21.36
- UT (response_timeout)
- Envoy response flag: upstream request timeout. The route's timeout passed before an answer came. Lesson 21.36
- VirtualService (VS)
- The Istio object that decides where requests for a host go: matches, weights, retries, timeouts and faults. The first matching rule wins. Lesson 21.35
- waypoint proxy (waypoint, istioctl waypoint)
- An Envoy Deployment that ambient traffic for a namespace or Service passes through to get L7 features. Lesson 21.38
- X-Forwarded-Client-Cert (XFCC)
- A header the server's sidecar adds with the caller's identity (its SPIFFE ID) and its own, proof that the call used mTLS. Lesson 21.29
- xDS (CDS, LDS, EDS)
- The family of APIs Envoy uses to receive configuration from a control plane: clusters (CDS), listeners (LDS), endpoints (EDS), routes (RDS) and secrets (SDS). Lesson 21.27
- ztunnel
- The per-node proxy of Istio ambient mode, handling mTLS and L4 policy for every ambient pod on the node. Lesson 21.38