Skip to content

Commit 8a3c141

Browse files
committed
Document the endpoint admission controller
1 parent 3ddd5d5 commit 8a3c141

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

architecture/core_concepts/pods_and_services.adoc

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -270,3 +270,31 @@ A service or replication controller that is defined to use pods with the
270270
The
271271
https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/user-guide/labels.md[Kubernetes
272272
documentation] has more information on labels.
273+
274+
[[endpoints]]
275+
276+
== Endpoints
277+
278+
The servers that back a service are called its endpoints, and are
279+
specified by an object of type *Endpoints* with the same name as the
280+
service. When a service is backed by pods, those pods are normally
281+
specified by a label selector in the service specification, and
282+
{product-title} automatically creates the Endpoints object pointing to
283+
those pods.
284+
285+
In some cases, you may want to create a service but have it be backed
286+
by external hosts rather than by pods in the {product-title} cluster.
287+
In this case, you can leave out the `*selector*` field in the service,
288+
and
289+
xref:../../dev_guide/integrating_external_services.adoc#dev-guide-integrating-external-services[create
290+
the Endpoints object manually].
291+
292+
Note that {product-title} will not let most users manually create an
293+
Endpoints object that points to an IP address in
294+
xref:../../install_config/configuring_sdn.adoc#configuring-the-pod-network-on-masters[the
295+
network blocks reserved for pod and service IPs]. Only
296+
xref:../additional_concepts/authorization.adoc#roles[cluster admins]
297+
or other users with
298+
xref:../additional_concepts/authorization.adoc#evaluating-authorization[permission
299+
to `create` resources under `endpoints/restricted`] can create such
300+
Endpoint objects.

0 commit comments

Comments
 (0)