consul/proto-public/pbmesh/v2beta1/tcp_route.proto

57 lines
2.1 KiB
Protocol Buffer

// Copyright (c) HashiCorp, Inc.
// SPDX-License-Identifier: MPL-2.0
syntax = "proto3";
package hashicorp.consul.mesh.v2beta1;
import "pbmesh/v2beta1/common.proto";
import "pbresource/annotations.proto";
// NOTE: this should align to the GAMMA/gateway-api version, or at least be
// easily translatable.
//
// https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.TCPRoute
//
// This is a Resource type.
message TCPRoute {
option (hashicorp.consul.resource.spec) = {scope: SCOPE_NAMESPACE};
// ParentRefs references the resources (usually Services) that a Route wants
// to be attached to.
//
// It is invalid to reference an identical parent more than once. It is valid
// to reference multiple distinct sections within the same parent resource.
repeated ParentReference parent_refs = 1;
// Rules are a list of TCP matchers and actions.
repeated TCPRouteRule rules = 2;
}
message TCPRouteRule {
// BackendRefs defines the backend(s) where matching requests should be sent.
// If unspecified or invalid (refers to a non-existent resource or a Service
// with no endpoints), the underlying implementation MUST actively reject
// connection attempts to this backend. Connection rejections must respect
// weight; if an invalid backend is requested to have 80% of connections,
// then 80% of connections must be rejected instead.
repeated TCPBackendRef backend_refs = 1;
}
message TCPBackendRef {
BackendReference backend_ref = 1;
// Weight specifies the proportion of requests forwarded to the referenced
// backend. This is computed as weight/(sum of all weights in this
// BackendRefs list). For non-zero values, there may be some epsilon from the
// exact proportion defined here depending on the precision an implementation
// supports. Weight is not a percentage and the sum of weights does not need
// to equal 100.
//
//If only one backend is specified and it has a weight greater than 0, 100%
//of the traffic is forwarded to that backend. If weight is set to 0, no
//traffic should be forwarded for this entry. If unspecified, weight defaults
//to 1.
uint32 weight = 2;
}