An Endpoints resource is an abstraction, linked to a Service, which defines the list of endpoints that actually implement the service.
resource "kubernetes_endpoints" "example" {
metadata {
name = "terraform-example"
}
subset {
address {
ip = "10.0.0.4"
}
address {
ip = "10.0.0.5"
}
port {
name = "http"
port = 80
protocol = "TCP"
}
port {
name = "https"
port = 443
protocol = "TCP"
}
}
subset {
address {
ip = "10.0.1.4"
}
address {
ip = "10.0.1.5"
}
port {
name = "http"
port = 80
protocol = "TCP"
}
port {
name = "https"
port = 443
protocol = "TCP"
}
}
}
resource "kubernetes_service" "example" {
metadata {
name = "${kubernetes_endpoints.example.metadata.0.name}"
}
spec {
port {
port = 8080
target_port = 80
}
port {
port = 8443
target_port = 443
}
}
}
The following arguments are supported:
metadata
- (Required) Standard endpoints' metadata. For more info see Kubernetes referencesubset
- (Optional) Set of addresses and ports that comprise a service. Can be repeated multiple times.metadata
annotations
- (Optional) An unstructured key value map stored with the endpoints resource that may be used to store arbitrary metadata.generate_name
- (Optional) Prefix, used by the server, to generate a unique name ONLY IF the name
field has not been provided. This value will also be combined with a unique suffix. For more info see Kubernetes referencelabels
- (Optional) Map of string keys and values that can be used to organize and categorize (scope and select) the endpoints resource. May match selectors of replication controllers and services.name
- (Optional) Name of the endpoints resource, must be unique. Cannot be updated. This name should correspond with an accompanying Service resource. For more info see Kubernetes referencenamespace
- (Optional) Namespace defines the space within which name of the endpoints resource must be unique.generation
- A sequence number representing a specific generation of the desired state.resource_version
- An opaque value that represents the internal version of this endpoints resource that can be used by clients to determine when endpoints resource has changed. For more info see Kubernetes referenceuid
- The unique in time and space value for this endpoints resource. For more info see Kubernetes referencesubset
address
- (Optional) An IP address block which offers the related ports and is ready to accept traffic. These endpoints should be considered safe for load balancers and clients to utilize. Can be repeated multiple times.not_ready_address
- (Optional) A IP address block which offers the related ports but is not currently marked as ready because it have not yet finished starting, have recently failed a readiness check, or have recently failed a liveness check. Can be repeated multiple times.port
- (Optional) A port number block available on the related IP addresses. Can be repeated multiple times.address
ip
- The IP of this endpoint. May not be loopback (127.0.0.0/8), link-local (169.254.0.0/16), or link-local multicast ((224.0.0.0/24).hostname
- (Optional) The Hostname of this endpoint.node_name
- (Optional) Node hosting this endpoint. This can be used to determine endpoints local to a node.not_ready_address
ip
- The IP of this endpoint. May not be loopback (127.0.0.0/8), link-local (169.254.0.0/16), or link-local multicast ((224.0.0.0/24).hostname
- (Optional) The Hostname of this endpoint.node_name
- (Optional) Node hosting this endpoint. This can be used to determine endpoints local to a node.port
name
- (Optional) The name of this port within the endpoint. All ports within the endpoint must have unique names. Optional if only one port is defined on this endpoint.port
- (Required) The port that will be utilized by this endpoint.protocol
- (Optional) The IP protocol for this port. Supports TCP
and UDP
. Default is TCP
.An Endpoints resource can be imported using its namespace and name, e.g.
$ terraform import kubernetes_endpoints.example default/terraform-name