mirror of https://github.com/status-im/consul.git
60 lines
2.4 KiB
Protocol Buffer
60 lines
2.4 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 Gateways) that a Route wants
|
|
// to be attached to. Note that the referenced parent resource needs to allow
|
|
// this for the attachment to be complete. For Gateways, that means the
|
|
// Gateway needs to allow attachment from Routes of this kind and namespace.
|
|
//
|
|
// It is invalid to reference an identical parent more than once. It is valid
|
|
// to reference multiple distinct sections within the same parent resource,
|
|
// such as 2 Listeners within a Gateway.
|
|
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;
|
|
}
|