diff --git a/kubernetes/customresourcedefinitions.gen.yaml b/kubernetes/customresourcedefinitions.gen.yaml index 45f40e73b8e..83ce5c725e2 100644 --- a/kubernetes/customresourcedefinitions.gen.yaml +++ b/kubernetes/customresourcedefinitions.gen.yaml @@ -4739,6 +4739,8 @@ spec: items: properties: destination: + description: Destination specifies the target of the mirror + operation. properties: host: description: The name of a service from the service @@ -4756,6 +4758,8 @@ spec: type: string type: object percentage: + description: Percentage of the traffic to be mirrored + by the `destination` field. properties: value: format: double @@ -5562,6 +5566,8 @@ spec: items: properties: destination: + description: Destination specifies the target of the mirror + operation. properties: host: description: The name of a service from the service @@ -5579,6 +5585,8 @@ spec: type: string type: object percentage: + description: Percentage of the traffic to be mirrored + by the `destination` field. properties: value: format: double diff --git a/networking/v1alpha3/virtual_service.pb.go b/networking/v1alpha3/virtual_service.pb.go index ab1a4202626..9c413bdb632 100644 --- a/networking/v1alpha3/virtual_service.pb.go +++ b/networking/v1alpha3/virtual_service.pb.go @@ -852,9 +852,6 @@ type HTTPRoute struct { // original destination. Statistics will be generated for the mirrored // destination. Mirror *Destination `protobuf:"bytes,9,opt,name=mirror,proto3" json:"mirror,omitempty"` - // $hide_from_docs - // Hide this from doc until implemented. - // // Specifies the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -3551,9 +3548,6 @@ func (x *HTTPFaultInjection) GetAbort() *HTTPFaultInjection_Abort { return nil } -// $hide_from_docs -// Hide this from doc until implemented. -// // HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -3565,14 +3559,8 @@ type HTTPMirrorPolicy struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // $hide_from_docs - // Hide this from doc until implemented. - // // Destination specifies the target of the mirror operation. Destination *Destination `protobuf:"bytes,1,opt,name=destination,proto3" json:"destination,omitempty"` - // $hide_from_docs - // Hide this from doc until implemented. - // // Percentage of the traffic to be mirrored by the `destination` field. // If this field is absent, all the traffic (100%) will be mirrored. // Max value is 100. diff --git a/networking/v1alpha3/virtual_service.pb.html b/networking/v1alpha3/virtual_service.pb.html index d7f328d1865..255b851a7ef 100644 --- a/networking/v1alpha3/virtual_service.pb.html +++ b/networking/v1alpha3/virtual_service.pb.html @@ -6,7 +6,7 @@ generator: protoc-gen-docs schema: istio.networking.v1alpha3.VirtualService aliases: [/docs/reference/config/networking/v1alpha3/virtual-service] -number_of_entries: 28 +number_of_entries: 29 ---

Configuration affecting traffic routing. Here are a few terms useful to define in the context of traffic routing.

@@ -727,6 +727,22 @@

HTTPRoute

original destination. Statistics will be generated for the mirrored destination.

+ + +No + + + +mirrors +HTTPMirrorPolicy[] + +

Specifies the destinations to mirror HTTP traffic in addition +to the original destination. Mirrored traffic is on a +best effort basis where the sidecar/gateway will not wait for the +mirrored destinations to respond before returning the response from the +original destination. Statistics will be generated for the mirrored +destination.

+ No @@ -2732,6 +2748,52 @@

HTTPFaultInjection

Abort Http request attempts and return error codes back to downstream service, giving the impression that the upstream service is faulty.

+ + +No + + + + + +

HTTPMirrorPolicy

+
+

HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition +to the original destination. Mirrored traffic is on a +best effort basis where the sidecar/gateway will not wait for the +mirrored destinations to respond before returning the response from the +original destination. Statistics will be generated for the mirrored +destination.

+ + + + + + + + + + + + + + + + + + + + +
FieldTypeDescriptionRequired
destinationDestination +

Destination specifies the target of the mirror operation.

+ +
+Yes +
percentagePercent +

Percentage of the traffic to be mirrored by the destination field. +If this field is absent, all the traffic (100%) will be mirrored. +Max value is 100.

+
No diff --git a/networking/v1alpha3/virtual_service.proto b/networking/v1alpha3/virtual_service.proto index 4e29bd611f8..e1e4a83858b 100644 --- a/networking/v1alpha3/virtual_service.proto +++ b/networking/v1alpha3/virtual_service.proto @@ -633,9 +633,6 @@ message HTTPRoute { // destination. Destination mirror = 9; - // $hide_from_docs - // Hide this from doc until implemented. - // // Specifies the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -2090,9 +2087,6 @@ message HTTPFaultInjection { } } -// $hide_from_docs -// Hide this from doc until implemented. -// // HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -2100,15 +2094,9 @@ message HTTPFaultInjection { // original destination. Statistics will be generated for the mirrored // destination. message HTTPMirrorPolicy { - // $hide_from_docs - // Hide this from doc until implemented. - // // Destination specifies the target of the mirror operation. Destination destination = 1 [(google.api.field_behavior) = REQUIRED]; - // $hide_from_docs - // Hide this from doc until implemented. - // // Percentage of the traffic to be mirrored by the `destination` field. // If this field is absent, all the traffic (100%) will be mirrored. // Max value is 100. diff --git a/networking/v1beta1/virtual_service.pb.go b/networking/v1beta1/virtual_service.pb.go index 4521f1fbcb9..b4e24e2aa02 100644 --- a/networking/v1beta1/virtual_service.pb.go +++ b/networking/v1beta1/virtual_service.pb.go @@ -852,9 +852,6 @@ type HTTPRoute struct { // original destination. Statistics will be generated for the mirrored // destination. Mirror *Destination `protobuf:"bytes,9,opt,name=mirror,proto3" json:"mirror,omitempty"` - // $hide_from_docs - // Hide this from doc until implemented. - // // Specifies the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -3551,9 +3548,6 @@ func (x *HTTPFaultInjection) GetAbort() *HTTPFaultInjection_Abort { return nil } -// $hide_from_docs -// Hide this from doc until implemented. -// // HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -3565,14 +3559,8 @@ type HTTPMirrorPolicy struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - // $hide_from_docs - // Hide this from doc until implemented. - // // Destination specifies the target of the mirror operation. Destination *Destination `protobuf:"bytes,1,opt,name=destination,proto3" json:"destination,omitempty"` - // $hide_from_docs - // Hide this from doc until implemented. - // // Percentage of the traffic to be mirrored by the `destination` field. // If this field is absent, all the traffic (100%) will be mirrored. // Max value is 100. diff --git a/networking/v1beta1/virtual_service.proto b/networking/v1beta1/virtual_service.proto index 6894f88298e..6f543d777b8 100644 --- a/networking/v1beta1/virtual_service.proto +++ b/networking/v1beta1/virtual_service.proto @@ -633,9 +633,6 @@ message HTTPRoute { // destination. Destination mirror = 9; - // $hide_from_docs - // Hide this from doc until implemented. - // // Specifies the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -2090,9 +2087,6 @@ message HTTPFaultInjection { } } -// $hide_from_docs -// Hide this from doc until implemented. -// // HTTPMirrorPolicy can be used to specify the destinations to mirror HTTP traffic in addition // to the original destination. Mirrored traffic is on a // best effort basis where the sidecar/gateway will not wait for the @@ -2100,15 +2094,9 @@ message HTTPFaultInjection { // original destination. Statistics will be generated for the mirrored // destination. message HTTPMirrorPolicy { - // $hide_from_docs - // Hide this from doc until implemented. - // // Destination specifies the target of the mirror operation. Destination destination = 1 [(google.api.field_behavior) = REQUIRED]; - // $hide_from_docs - // Hide this from doc until implemented. - // // Percentage of the traffic to be mirrored by the `destination` field. // If this field is absent, all the traffic (100%) will be mirrored. // Max value is 100.