Endpoints

Discovery record listing the ready backend addresses behind a Service, superseded by EndpointSlice.

Provider: k8s
Kind: Coordination service
Category: Operations
Official docs: https://kubernetes.io/docs/concepts/services-networking/endpoint-slices/
Also known as: ep

Properties · 2 set by this component

property	type	values	required	kind default	this component
addressType · component property	enum	ipv4 \| ipv6 \| fqdn	no	—	inherited
consensus	enum	none \| raft \| paxos \| zab	no	none	inherited
controlPlaneManaged · component property	boolean	—	no	true	inherited
managed	boolean	—	no	false	▸ false
maxEndpointsPerSlice · component property	integer	—	no	100	inherited
nodes	integer	—	no	—	inherited
replicated	boolean	—	no	false	inherited
role	enum	metadata \| lock \| discovery \| placement \| sharding \| leader-election \| config	yes	—	▸ discovery

Rules that apply · 2

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

Shared dependency without redundancyerror

shared-dependency-without-redundancy

The design requires redundant discovery, but this DNS or coordination service, which everything depends on, runs on a single provider or a single replica. Its failure is the whole system's failure.

— all of these hold:
— the design requirement `availability.discoveryRedundant` is true
— any of these hold:
— the node's `redundantProviders` is false
— the node's `replicated` is false

Stateful engine pinned to a single zoneerror

stateful-engine-pinned-to-single-zone

A matching engine, coordination service or event store living in exactly one availability zone, with no failover and no replication, is lost with that zone. Everything that depends on it stops with it.

— all of these hold:
— the node sits inside exactly 1 availability-zone group
— any of these hold:
— the node's `failover` is "none"
— the node's `replicated` is false
— the node's `replication` is "none"

Use it in a design

nodes:
  - { id: "endpoints", component: "k8s-endpoints" }

Other Coordination service products · 17

Microservices Enginealibaba-msealibabacloudcoordination-service AWS Cloud Mapaws-cloud-mapawscoordination-service Azure Arcazure-arcazurecoordination-service Azure Device Registryazure-device-registryazurecoordination-service Durable Objectscloudflare-durable-objectscloudflarecoordination-service Apache Helixapache-helixcoordination-service Consulconsulcoordination-service Generic coordination servicecoordination-servicecoordination-service etcdetcdcoordination-service Eurekaeurekacoordination-service Nacosnacoscoordination-service Oxiaoxiacoordination-service Apache ZooKeeperzookeepercoordination-service Service Directorygoogle-service-directorygcpcoordination-service OpenStack Blazaropenstack-blazaropenstackcoordination-service OpenStack Cyborgopenstack-cyborgopenstackcoordination-service OpenStack Placementopenstack-placementopenstackcoordination-service

Source

1# yaml-language-server: $schema=../../schema/component.schema.json
2# Kubernetes Endpoints: the discovery record listing the backend addresses behind a Service.
3# Deprecated since Kubernetes v1.33 in favour of EndpointSlice, which is what the control plane
4# now creates and manages for every Service that has a selector. Per "EndpointSlices" a slice
5# holds at most 100 endpoints by default (raisable to 1000 with --max-endpoints-per-slice on
6# kube-controller-manager), and IPv4 and IPv6 addresses live in separate slices.
7schemaVersion: "1"
8type: "component"
9id: "k8s-endpoints"
10kind: "coordination-service"
11provider: "k8s"
12docs: "https://kubernetes.io/docs/concepts/services-networking/endpoint-slices/"
13aliases: ["ep"]
14defaults:
15  role: "discovery"
16  managed: false
17properties:
18  controlPlaneManaged:
19    type: "boolean"
20    default: true
21  maxEndpointsPerSlice:
22    type: "integer"
23    default: 100
24  addressType:
25    type: "enum"
26    values: ["ipv4", "ipv6", "fqdn"]

The same page as markdown, for an agent: /catalogue/components/k8s-endpoints.md