@@ -270,3 +270,31 @@ A service or replication controller that is defined to use pods with the
270
270
The
271
271
https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/user-guide/labels.md[Kubernetes
272
272
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