mirror of
https://github.com/k3s-io/kubernetes.git
synced 2025-07-23 03:41:45 +00:00
Merge pull request #95768 from danwinship/document-nodeaddresstype
Document the NodeAddressType values
This commit is contained in:
commit
7e23c5367d
@ -4240,11 +4240,44 @@ type NodeAddressType string
|
||||
|
||||
// These are valid values of node address type
|
||||
const (
|
||||
NodeHostName NodeAddressType = "Hostname"
|
||||
NodeExternalIP NodeAddressType = "ExternalIP"
|
||||
NodeInternalIP NodeAddressType = "InternalIP"
|
||||
NodeExternalDNS NodeAddressType = "ExternalDNS"
|
||||
// NodeHostName identifies a name of the node. Although every node can be assumed
|
||||
// to have a NodeAddress of this type, its exact syntax and semantics are not
|
||||
// defined, and are not consistent between different clusters.
|
||||
NodeHostName NodeAddressType = "Hostname"
|
||||
|
||||
// NodeInternalIP identifies an IP address which is assigned to one of the node's
|
||||
// network interfaces. Every node should have at least one address of this type.
|
||||
//
|
||||
// An internal IP is normally expected to be reachable from every other node, but
|
||||
// may not be visible to hosts outside the cluster. By default it is assumed that
|
||||
// kube-apiserver can reach node internal IPs, though it is possible to configure
|
||||
// clusters where this is not the case.
|
||||
//
|
||||
// NodeInternalIP is the default type of node IP, and does not necessarily imply
|
||||
// that the IP is ONLY reachable internally. If a node has multiple internal IPs,
|
||||
// no specific semantics are assigned to the additional IPs.
|
||||
NodeInternalIP NodeAddressType = "InternalIP"
|
||||
|
||||
// NodeExternalIP identifies an IP address which is, in some way, intended to be
|
||||
// more usable from outside the cluster then an internal IP, though no specific
|
||||
// semantics are defined. It may be a globally routable IP, though it is not
|
||||
// required to be.
|
||||
//
|
||||
// External IPs may be assigned directly to an interface on the node, like a
|
||||
// NodeInternalIP, or alternatively, packets sent to the external IP may be NAT'ed
|
||||
// to an internal node IP rather than being delivered directly (making the IP less
|
||||
// efficient for node-to-node traffic than a NodeInternalIP).
|
||||
NodeExternalIP NodeAddressType = "ExternalIP"
|
||||
|
||||
// NodeInternalDNS identifies a DNS name which resolves to an IP address which has
|
||||
// the characteristics of a NodeInternalIP. The IP it resolves to may or may not
|
||||
// be a listed NodeInternalIP address.
|
||||
NodeInternalDNS NodeAddressType = "InternalDNS"
|
||||
|
||||
// NodeExternalDNS identifies a DNS name which resolves to an IP address which has
|
||||
// the characteristics of a NodeExternalIP. The IP it resolves to may or may not
|
||||
// be a listed NodeExternalIP address.
|
||||
NodeExternalDNS NodeAddressType = "ExternalDNS"
|
||||
)
|
||||
|
||||
// NodeAddress represents node's address
|
||||
|
@ -4912,11 +4912,44 @@ type NodeAddressType string
|
||||
|
||||
// These are valid address type of node.
|
||||
const (
|
||||
NodeHostName NodeAddressType = "Hostname"
|
||||
NodeExternalIP NodeAddressType = "ExternalIP"
|
||||
NodeInternalIP NodeAddressType = "InternalIP"
|
||||
NodeExternalDNS NodeAddressType = "ExternalDNS"
|
||||
// NodeHostName identifies a name of the node. Although every node can be assumed
|
||||
// to have a NodeAddress of this type, its exact syntax and semantics are not
|
||||
// defined, and are not consistent between different clusters.
|
||||
NodeHostName NodeAddressType = "Hostname"
|
||||
|
||||
// NodeInternalIP identifies an IP address which is assigned to one of the node's
|
||||
// network interfaces. Every node should have at least one address of this type.
|
||||
//
|
||||
// An internal IP is normally expected to be reachable from every other node, but
|
||||
// may not be visible to hosts outside the cluster. By default it is assumed that
|
||||
// kube-apiserver can reach node internal IPs, though it is possible to configure
|
||||
// clusters where this is not the case.
|
||||
//
|
||||
// NodeInternalIP is the default type of node IP, and does not necessarily imply
|
||||
// that the IP is ONLY reachable internally. If a node has multiple internal IPs,
|
||||
// no specific semantics are assigned to the additional IPs.
|
||||
NodeInternalIP NodeAddressType = "InternalIP"
|
||||
|
||||
// NodeExternalIP identifies an IP address which is, in some way, intended to be
|
||||
// more usable from outside the cluster then an internal IP, though no specific
|
||||
// semantics are defined. It may be a globally routable IP, though it is not
|
||||
// required to be.
|
||||
//
|
||||
// External IPs may be assigned directly to an interface on the node, like a
|
||||
// NodeInternalIP, or alternatively, packets sent to the external IP may be NAT'ed
|
||||
// to an internal node IP rather than being delivered directly (making the IP less
|
||||
// efficient for node-to-node traffic than a NodeInternalIP).
|
||||
NodeExternalIP NodeAddressType = "ExternalIP"
|
||||
|
||||
// NodeInternalDNS identifies a DNS name which resolves to an IP address which has
|
||||
// the characteristics of a NodeInternalIP. The IP it resolves to may or may not
|
||||
// be a listed NodeInternalIP address.
|
||||
NodeInternalDNS NodeAddressType = "InternalDNS"
|
||||
|
||||
// NodeExternalDNS identifies a DNS name which resolves to an IP address which has
|
||||
// the characteristics of a NodeExternalIP. The IP it resolves to may or may not
|
||||
// be a listed NodeExternalIP address.
|
||||
NodeExternalDNS NodeAddressType = "ExternalDNS"
|
||||
)
|
||||
|
||||
// NodeAddress contains information for the node's address.
|
||||
|
Loading…
Reference in New Issue
Block a user