envoy-types 0.7.3

Collection of protobuf types and other assets to work with the Envoy Proxy through Rust gRPC services.
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
// This file is @generated by prost-build.
/// Defines supported protocols etc, so the management server can assign proper
/// endpoints to healthcheck.
#[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]
pub struct Capability {
    #[prost(enumeration = "capability::Protocol", repeated, tag = "1")]
    pub health_check_protocols: ::prost::alloc::vec::Vec<i32>,
}
/// Nested message and enum types in `Capability`.
pub mod capability {
    /// Different Envoy instances may have different capabilities (e.g. Redis)
    /// and/or have ports enabled for different protocols.
    #[derive(
        Clone,
        Copy,
        Debug,
        PartialEq,
        Eq,
        Hash,
        PartialOrd,
        Ord,
        ::prost::Enumeration
    )]
    #[repr(i32)]
    pub enum Protocol {
        Http = 0,
        Tcp = 1,
        Redis = 2,
    }
    impl Protocol {
        /// String value of the enum field names used in the ProtoBuf definition.
        ///
        /// The values are not transformed in any way and thus are considered stable
        /// (if the ProtoBuf definition does not change) and safe for programmatic use.
        pub fn as_str_name(&self) -> &'static str {
            match self {
                Self::Http => "HTTP",
                Self::Tcp => "TCP",
                Self::Redis => "REDIS",
            }
        }
        /// Creates an enum from field names used in the ProtoBuf definition.
        pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
            match value {
                "HTTP" => Some(Self::Http),
                "TCP" => Some(Self::Tcp),
                "REDIS" => Some(Self::Redis),
                _ => None,
            }
        }
    }
}
impl ::prost::Name for Capability {
    const NAME: &'static str = "Capability";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.Capability".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.Capability".into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct HealthCheckRequest {
    #[prost(message, optional, tag = "1")]
    pub node: ::core::option::Option<super::super::super::config::core::v3::Node>,
    #[prost(message, optional, tag = "2")]
    pub capability: ::core::option::Option<Capability>,
}
impl ::prost::Name for HealthCheckRequest {
    const NAME: &'static str = "HealthCheckRequest";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.HealthCheckRequest".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.HealthCheckRequest".into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EndpointHealth {
    #[prost(message, optional, tag = "1")]
    pub endpoint: ::core::option::Option<
        super::super::super::config::endpoint::v3::Endpoint,
    >,
    #[prost(
        enumeration = "super::super::super::config::core::v3::HealthStatus",
        tag = "2"
    )]
    pub health_status: i32,
}
impl ::prost::Name for EndpointHealth {
    const NAME: &'static str = "EndpointHealth";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.EndpointHealth".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.EndpointHealth".into()
    }
}
/// Group endpoint health by locality under each cluster.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct LocalityEndpointsHealth {
    #[prost(message, optional, tag = "1")]
    pub locality: ::core::option::Option<
        super::super::super::config::core::v3::Locality,
    >,
    #[prost(message, repeated, tag = "2")]
    pub endpoints_health: ::prost::alloc::vec::Vec<EndpointHealth>,
}
impl ::prost::Name for LocalityEndpointsHealth {
    const NAME: &'static str = "LocalityEndpointsHealth";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.LocalityEndpointsHealth".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.LocalityEndpointsHealth".into()
    }
}
/// The health status of endpoints in a cluster. The cluster name and locality
/// should match the corresponding fields in ClusterHealthCheck message.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct ClusterEndpointsHealth {
    #[prost(string, tag = "1")]
    pub cluster_name: ::prost::alloc::string::String,
    #[prost(message, repeated, tag = "2")]
    pub locality_endpoints_health: ::prost::alloc::vec::Vec<LocalityEndpointsHealth>,
}
impl ::prost::Name for ClusterEndpointsHealth {
    const NAME: &'static str = "ClusterEndpointsHealth";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.ClusterEndpointsHealth".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.ClusterEndpointsHealth".into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EndpointHealthResponse {
    /// Deprecated - Flat list of endpoint health information.
    #[deprecated]
    #[prost(message, repeated, tag = "1")]
    pub endpoints_health: ::prost::alloc::vec::Vec<EndpointHealth>,
    /// Organize Endpoint health information by cluster.
    #[prost(message, repeated, tag = "2")]
    pub cluster_endpoints_health: ::prost::alloc::vec::Vec<ClusterEndpointsHealth>,
}
impl ::prost::Name for EndpointHealthResponse {
    const NAME: &'static str = "EndpointHealthResponse";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.EndpointHealthResponse".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.EndpointHealthResponse".into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct HealthCheckRequestOrEndpointHealthResponse {
    #[prost(
        oneof = "health_check_request_or_endpoint_health_response::RequestType",
        tags = "1, 2"
    )]
    pub request_type: ::core::option::Option<
        health_check_request_or_endpoint_health_response::RequestType,
    >,
}
/// Nested message and enum types in `HealthCheckRequestOrEndpointHealthResponse`.
pub mod health_check_request_or_endpoint_health_response {
    #[derive(Clone, PartialEq, ::prost::Oneof)]
    pub enum RequestType {
        #[prost(message, tag = "1")]
        HealthCheckRequest(super::HealthCheckRequest),
        #[prost(message, tag = "2")]
        EndpointHealthResponse(super::EndpointHealthResponse),
    }
}
impl ::prost::Name for HealthCheckRequestOrEndpointHealthResponse {
    const NAME: &'static str = "HealthCheckRequestOrEndpointHealthResponse";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.HealthCheckRequestOrEndpointHealthResponse".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.HealthCheckRequestOrEndpointHealthResponse"
            .into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct LocalityEndpoints {
    #[prost(message, optional, tag = "1")]
    pub locality: ::core::option::Option<
        super::super::super::config::core::v3::Locality,
    >,
    #[prost(message, repeated, tag = "2")]
    pub endpoints: ::prost::alloc::vec::Vec<
        super::super::super::config::endpoint::v3::Endpoint,
    >,
}
impl ::prost::Name for LocalityEndpoints {
    const NAME: &'static str = "LocalityEndpoints";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.LocalityEndpoints".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.LocalityEndpoints".into()
    }
}
/// The cluster name and locality is provided to Envoy for the endpoints that it
/// health checks to support statistics reporting, logging and debugging by the
/// Envoy instance (outside of HDS). For maximum usefulness, it should match the
/// same cluster structure as that provided by EDS.
/// \[\#next-free-field: 6\]
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct ClusterHealthCheck {
    #[prost(string, tag = "1")]
    pub cluster_name: ::prost::alloc::string::String,
    #[prost(message, repeated, tag = "2")]
    pub health_checks: ::prost::alloc::vec::Vec<
        super::super::super::config::core::v3::HealthCheck,
    >,
    #[prost(message, repeated, tag = "3")]
    pub locality_endpoints: ::prost::alloc::vec::Vec<LocalityEndpoints>,
    ///
    /// Optional map that gets filtered by :ref:`health_checks.transport_socket_match_criteria <envoy_v3_api_field_config.core.v3.HealthCheck.transport_socket_match_criteria>`
    /// on connection when health checking. For more details, see
    /// : ref:`config.cluster.v3.Cluster.transport_socket_matches <envoy_v3_api_field_config.cluster.v3.Cluster.transport_socket_matches>`.
    #[prost(message, repeated, tag = "4")]
    pub transport_socket_matches: ::prost::alloc::vec::Vec<
        super::super::super::config::cluster::v3::cluster::TransportSocketMatch,
    >,
    /// Optional configuration used to bind newly established upstream connections.
    /// If the address and port are empty, no bind will be performed.
    #[prost(message, optional, tag = "5")]
    pub upstream_bind_config: ::core::option::Option<
        super::super::super::config::core::v3::BindConfig,
    >,
}
impl ::prost::Name for ClusterHealthCheck {
    const NAME: &'static str = "ClusterHealthCheck";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.ClusterHealthCheck".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.ClusterHealthCheck".into()
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct HealthCheckSpecifier {
    #[prost(message, repeated, tag = "1")]
    pub cluster_health_checks: ::prost::alloc::vec::Vec<ClusterHealthCheck>,
    /// The default is 1 second.
    #[prost(message, optional, tag = "2")]
    pub interval: ::core::option::Option<
        super::super::super::super::google::protobuf::Duration,
    >,
}
impl ::prost::Name for HealthCheckSpecifier {
    const NAME: &'static str = "HealthCheckSpecifier";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.HealthCheckSpecifier".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.HealthCheckSpecifier".into()
    }
}
/// \[\#not-implemented-hide:\] Not configuration. Workaround c++ protobuf issue with importing
/// services: <https://github.com/google/protobuf/issues/4221> and protoxform to upgrade the file.
#[derive(Clone, Copy, PartialEq, Eq, Hash, ::prost::Message)]
pub struct HdsDummy {}
impl ::prost::Name for HdsDummy {
    const NAME: &'static str = "HdsDummy";
    const PACKAGE: &'static str = "envoy.service.health.v3";
    fn full_name() -> ::prost::alloc::string::String {
        "envoy.service.health.v3.HdsDummy".into()
    }
    fn type_url() -> ::prost::alloc::string::String {
        "type.googleapis.com/envoy.service.health.v3.HdsDummy".into()
    }
}
/// Generated client implementations.
pub mod health_discovery_service_client {
    #![allow(
        unused_variables,
        dead_code,
        missing_docs,
        clippy::wildcard_imports,
        clippy::let_unit_value,
    )]
    use tonic::codegen::*;
    use tonic::codegen::http::Uri;
    /// HDS is Health Discovery Service. It compliments Envoy’s health checking
    /// service by designating this Envoy to be a healthchecker for a subset of hosts
    /// in the cluster. The status of these health checks will be reported to the
    /// management server, where it can be aggregated etc and redistributed back to
    /// Envoy through EDS.
    #[derive(Debug, Clone)]
    pub struct HealthDiscoveryServiceClient<T> {
        inner: tonic::client::Grpc<T>,
    }
    impl HealthDiscoveryServiceClient<tonic::transport::Channel> {
        /// Attempt to create a new client by connecting to a given endpoint.
        pub async fn connect<D>(dst: D) -> Result<Self, tonic::transport::Error>
        where
            D: TryInto<tonic::transport::Endpoint>,
            D::Error: Into<StdError>,
        {
            let conn = tonic::transport::Endpoint::new(dst)?.connect().await?;
            Ok(Self::new(conn))
        }
    }
    impl<T> HealthDiscoveryServiceClient<T>
    where
        T: tonic::client::GrpcService<tonic::body::Body>,
        T::Error: Into<StdError>,
        T::ResponseBody: Body<Data = Bytes> + std::marker::Send + 'static,
        <T::ResponseBody as Body>::Error: Into<StdError> + std::marker::Send,
    {
        pub fn new(inner: T) -> Self {
            let inner = tonic::client::Grpc::new(inner);
            Self { inner }
        }
        pub fn with_origin(inner: T, origin: Uri) -> Self {
            let inner = tonic::client::Grpc::with_origin(inner, origin);
            Self { inner }
        }
        pub fn with_interceptor<F>(
            inner: T,
            interceptor: F,
        ) -> HealthDiscoveryServiceClient<InterceptedService<T, F>>
        where
            F: tonic::service::Interceptor,
            T::ResponseBody: Default,
            T: tonic::codegen::Service<
                http::Request<tonic::body::Body>,
                Response = http::Response<
                    <T as tonic::client::GrpcService<tonic::body::Body>>::ResponseBody,
                >,
            >,
            <T as tonic::codegen::Service<
                http::Request<tonic::body::Body>,
            >>::Error: Into<StdError> + std::marker::Send + std::marker::Sync,
        {
            HealthDiscoveryServiceClient::new(
                InterceptedService::new(inner, interceptor),
            )
        }
        /// Compress requests with the given encoding.
        ///
        /// This requires the server to support it otherwise it might respond with an
        /// error.
        #[must_use]
        pub fn send_compressed(mut self, encoding: CompressionEncoding) -> Self {
            self.inner = self.inner.send_compressed(encoding);
            self
        }
        /// Enable decompressing responses.
        #[must_use]
        pub fn accept_compressed(mut self, encoding: CompressionEncoding) -> Self {
            self.inner = self.inner.accept_compressed(encoding);
            self
        }
        /// Limits the maximum size of a decoded message.
        ///
        /// Default: `4MB`
        #[must_use]
        pub fn max_decoding_message_size(mut self, limit: usize) -> Self {
            self.inner = self.inner.max_decoding_message_size(limit);
            self
        }
        /// Limits the maximum size of an encoded message.
        ///
        /// Default: `usize::MAX`
        #[must_use]
        pub fn max_encoding_message_size(mut self, limit: usize) -> Self {
            self.inner = self.inner.max_encoding_message_size(limit);
            self
        }
        /// 1. Envoy starts up and if its can_healthcheck option in the static
        ///   bootstrap config is enabled, sends HealthCheckRequest to the management
        ///   server. It supplies its capabilities (which protocol it can health check
        ///   with, what zone it resides in, etc.).
        /// 1. In response to (1), the management server designates this Envoy as a
        ///   healthchecker to health check a subset of all upstream hosts for a given
        ///   cluster (for example upstream Host 1 and Host 2). It streams
        ///   HealthCheckSpecifier messages with cluster related configuration for all
        ///   clusters this Envoy is designated to health check. Subsequent
        ///   HealthCheckSpecifier message will be sent on changes to:
        ///   a. Endpoints to health checks
        ///   b. Per cluster configuration change
        /// 1. Envoy creates a health probe based on the HealthCheck config and sends
        ///   it to endpoint(ip:port) of Host 1 and 2. Based on the HealthCheck
        ///   configuration Envoy waits upon the arrival of the probe response and
        ///   looks at the content of the response to decide whether the endpoint is
        ///   healthy or not. If a response hasn't been received within the timeout
        ///   interval, the endpoint health status is considered TIMEOUT.
        /// 1. Envoy reports results back in an EndpointHealthResponse message.
        ///   Envoy streams responses as often as the interval configured by the
        ///   management server in HealthCheckSpecifier.
        /// 1. The management Server collects health statuses for all endpoints in the
        ///   cluster (for all clusters) and uses this information to construct
        ///   EndpointDiscoveryResponse messages.
        /// 1. Once Envoy has a list of upstream endpoints to send traffic to, it load
        ///   balances traffic to them without additional health checking. It may
        ///   use inline healthcheck (i.e. consider endpoint UNHEALTHY if connection
        ///   failed to a particular endpoint to account for health status propagation
        ///   delay between HDS and EDS).
        ///   By default, can_healthcheck is true. If can_healthcheck is false, Cluster
        ///   configuration may not contain HealthCheck message.
        ///   TODO(htuch): How is can_healthcheck communicated to CDS to ensure the above
        ///   invariant?
        ///   TODO(htuch): Add @amb67's diagram.
        pub async fn stream_health_check(
            &mut self,
            request: impl tonic::IntoStreamingRequest<
                Message = super::HealthCheckRequestOrEndpointHealthResponse,
            >,
        ) -> std::result::Result<
            tonic::Response<tonic::codec::Streaming<super::HealthCheckSpecifier>>,
            tonic::Status,
        > {
            self.inner
                .ready()
                .await
                .map_err(|e| {
                    tonic::Status::unknown(
                        format!("Service was not ready: {}", e.into()),
                    )
                })?;
            let codec = tonic_prost::ProstCodec::default();
            let path = http::uri::PathAndQuery::from_static(
                "/envoy.service.health.v3.HealthDiscoveryService/StreamHealthCheck",
            );
            let mut req = request.into_streaming_request();
            req.extensions_mut()
                .insert(
                    GrpcMethod::new(
                        "envoy.service.health.v3.HealthDiscoveryService",
                        "StreamHealthCheck",
                    ),
                );
            self.inner.streaming(req, path, codec).await
        }
        /// TODO(htuch): Unlike the gRPC version, there is no stream-based binding of
        /// request/response. Should we add an identifier to the HealthCheckSpecifier
        /// to bind with the response?
        pub async fn fetch_health_check(
            &mut self,
            request: impl tonic::IntoRequest<
                super::HealthCheckRequestOrEndpointHealthResponse,
            >,
        ) -> std::result::Result<
            tonic::Response<super::HealthCheckSpecifier>,
            tonic::Status,
        > {
            self.inner
                .ready()
                .await
                .map_err(|e| {
                    tonic::Status::unknown(
                        format!("Service was not ready: {}", e.into()),
                    )
                })?;
            let codec = tonic_prost::ProstCodec::default();
            let path = http::uri::PathAndQuery::from_static(
                "/envoy.service.health.v3.HealthDiscoveryService/FetchHealthCheck",
            );
            let mut req = request.into_request();
            req.extensions_mut()
                .insert(
                    GrpcMethod::new(
                        "envoy.service.health.v3.HealthDiscoveryService",
                        "FetchHealthCheck",
                    ),
                );
            self.inner.unary(req, path, codec).await
        }
    }
}
/// Generated server implementations.
pub mod health_discovery_service_server {
    #![allow(
        unused_variables,
        dead_code,
        missing_docs,
        clippy::wildcard_imports,
        clippy::let_unit_value,
    )]
    use tonic::codegen::*;
    /// Generated trait containing gRPC methods that should be implemented for use with HealthDiscoveryServiceServer.
    #[async_trait]
    pub trait HealthDiscoveryService: std::marker::Send + std::marker::Sync + 'static {
        /// Server streaming response type for the StreamHealthCheck method.
        type StreamHealthCheckStream: tonic::codegen::tokio_stream::Stream<
                Item = std::result::Result<super::HealthCheckSpecifier, tonic::Status>,
            >
            + std::marker::Send
            + 'static;
        /// 1. Envoy starts up and if its can_healthcheck option in the static
        ///   bootstrap config is enabled, sends HealthCheckRequest to the management
        ///   server. It supplies its capabilities (which protocol it can health check
        ///   with, what zone it resides in, etc.).
        /// 1. In response to (1), the management server designates this Envoy as a
        ///   healthchecker to health check a subset of all upstream hosts for a given
        ///   cluster (for example upstream Host 1 and Host 2). It streams
        ///   HealthCheckSpecifier messages with cluster related configuration for all
        ///   clusters this Envoy is designated to health check. Subsequent
        ///   HealthCheckSpecifier message will be sent on changes to:
        ///   a. Endpoints to health checks
        ///   b. Per cluster configuration change
        /// 1. Envoy creates a health probe based on the HealthCheck config and sends
        ///   it to endpoint(ip:port) of Host 1 and 2. Based on the HealthCheck
        ///   configuration Envoy waits upon the arrival of the probe response and
        ///   looks at the content of the response to decide whether the endpoint is
        ///   healthy or not. If a response hasn't been received within the timeout
        ///   interval, the endpoint health status is considered TIMEOUT.
        /// 1. Envoy reports results back in an EndpointHealthResponse message.
        ///   Envoy streams responses as often as the interval configured by the
        ///   management server in HealthCheckSpecifier.
        /// 1. The management Server collects health statuses for all endpoints in the
        ///   cluster (for all clusters) and uses this information to construct
        ///   EndpointDiscoveryResponse messages.
        /// 1. Once Envoy has a list of upstream endpoints to send traffic to, it load
        ///   balances traffic to them without additional health checking. It may
        ///   use inline healthcheck (i.e. consider endpoint UNHEALTHY if connection
        ///   failed to a particular endpoint to account for health status propagation
        ///   delay between HDS and EDS).
        ///   By default, can_healthcheck is true. If can_healthcheck is false, Cluster
        ///   configuration may not contain HealthCheck message.
        ///   TODO(htuch): How is can_healthcheck communicated to CDS to ensure the above
        ///   invariant?
        ///   TODO(htuch): Add @amb67's diagram.
        async fn stream_health_check(
            &self,
            request: tonic::Request<
                tonic::Streaming<super::HealthCheckRequestOrEndpointHealthResponse>,
            >,
        ) -> std::result::Result<
            tonic::Response<Self::StreamHealthCheckStream>,
            tonic::Status,
        >;
        /// TODO(htuch): Unlike the gRPC version, there is no stream-based binding of
        /// request/response. Should we add an identifier to the HealthCheckSpecifier
        /// to bind with the response?
        async fn fetch_health_check(
            &self,
            request: tonic::Request<super::HealthCheckRequestOrEndpointHealthResponse>,
        ) -> std::result::Result<
            tonic::Response<super::HealthCheckSpecifier>,
            tonic::Status,
        >;
    }
    /// HDS is Health Discovery Service. It compliments Envoy’s health checking
    /// service by designating this Envoy to be a healthchecker for a subset of hosts
    /// in the cluster. The status of these health checks will be reported to the
    /// management server, where it can be aggregated etc and redistributed back to
    /// Envoy through EDS.
    #[derive(Debug)]
    pub struct HealthDiscoveryServiceServer<T> {
        inner: Arc<T>,
        accept_compression_encodings: EnabledCompressionEncodings,
        send_compression_encodings: EnabledCompressionEncodings,
        max_decoding_message_size: Option<usize>,
        max_encoding_message_size: Option<usize>,
    }
    impl<T> HealthDiscoveryServiceServer<T> {
        pub fn new(inner: T) -> Self {
            Self::from_arc(Arc::new(inner))
        }
        pub fn from_arc(inner: Arc<T>) -> Self {
            Self {
                inner,
                accept_compression_encodings: Default::default(),
                send_compression_encodings: Default::default(),
                max_decoding_message_size: None,
                max_encoding_message_size: None,
            }
        }
        pub fn with_interceptor<F>(
            inner: T,
            interceptor: F,
        ) -> InterceptedService<Self, F>
        where
            F: tonic::service::Interceptor,
        {
            InterceptedService::new(Self::new(inner), interceptor)
        }
        /// Enable decompressing requests with the given encoding.
        #[must_use]
        pub fn accept_compressed(mut self, encoding: CompressionEncoding) -> Self {
            self.accept_compression_encodings.enable(encoding);
            self
        }
        /// Compress responses with the given encoding, if the client supports it.
        #[must_use]
        pub fn send_compressed(mut self, encoding: CompressionEncoding) -> Self {
            self.send_compression_encodings.enable(encoding);
            self
        }
        /// Limits the maximum size of a decoded message.
        ///
        /// Default: `4MB`
        #[must_use]
        pub fn max_decoding_message_size(mut self, limit: usize) -> Self {
            self.max_decoding_message_size = Some(limit);
            self
        }
        /// Limits the maximum size of an encoded message.
        ///
        /// Default: `usize::MAX`
        #[must_use]
        pub fn max_encoding_message_size(mut self, limit: usize) -> Self {
            self.max_encoding_message_size = Some(limit);
            self
        }
    }
    impl<T, B> tonic::codegen::Service<http::Request<B>>
    for HealthDiscoveryServiceServer<T>
    where
        T: HealthDiscoveryService,
        B: Body + std::marker::Send + 'static,
        B::Error: Into<StdError> + std::marker::Send + 'static,
    {
        type Response = http::Response<tonic::body::Body>;
        type Error = std::convert::Infallible;
        type Future = BoxFuture<Self::Response, Self::Error>;
        fn poll_ready(
            &mut self,
            _cx: &mut Context<'_>,
        ) -> Poll<std::result::Result<(), Self::Error>> {
            Poll::Ready(Ok(()))
        }
        fn call(&mut self, req: http::Request<B>) -> Self::Future {
            match req.uri().path() {
                "/envoy.service.health.v3.HealthDiscoveryService/StreamHealthCheck" => {
                    #[allow(non_camel_case_types)]
                    struct StreamHealthCheckSvc<T: HealthDiscoveryService>(pub Arc<T>);
                    impl<
                        T: HealthDiscoveryService,
                    > tonic::server::StreamingService<
                        super::HealthCheckRequestOrEndpointHealthResponse,
                    > for StreamHealthCheckSvc<T> {
                        type Response = super::HealthCheckSpecifier;
                        type ResponseStream = T::StreamHealthCheckStream;
                        type Future = BoxFuture<
                            tonic::Response<Self::ResponseStream>,
                            tonic::Status,
                        >;
                        fn call(
                            &mut self,
                            request: tonic::Request<
                                tonic::Streaming<
                                    super::HealthCheckRequestOrEndpointHealthResponse,
                                >,
                            >,
                        ) -> Self::Future {
                            let inner = Arc::clone(&self.0);
                            let fut = async move {
                                <T as HealthDiscoveryService>::stream_health_check(
                                        &inner,
                                        request,
                                    )
                                    .await
                            };
                            Box::pin(fut)
                        }
                    }
                    let accept_compression_encodings = self.accept_compression_encodings;
                    let send_compression_encodings = self.send_compression_encodings;
                    let max_decoding_message_size = self.max_decoding_message_size;
                    let max_encoding_message_size = self.max_encoding_message_size;
                    let inner = self.inner.clone();
                    let fut = async move {
                        let method = StreamHealthCheckSvc(inner);
                        let codec = tonic_prost::ProstCodec::default();
                        let mut grpc = tonic::server::Grpc::new(codec)
                            .apply_compression_config(
                                accept_compression_encodings,
                                send_compression_encodings,
                            )
                            .apply_max_message_size_config(
                                max_decoding_message_size,
                                max_encoding_message_size,
                            );
                        let res = grpc.streaming(method, req).await;
                        Ok(res)
                    };
                    Box::pin(fut)
                }
                "/envoy.service.health.v3.HealthDiscoveryService/FetchHealthCheck" => {
                    #[allow(non_camel_case_types)]
                    struct FetchHealthCheckSvc<T: HealthDiscoveryService>(pub Arc<T>);
                    impl<
                        T: HealthDiscoveryService,
                    > tonic::server::UnaryService<
                        super::HealthCheckRequestOrEndpointHealthResponse,
                    > for FetchHealthCheckSvc<T> {
                        type Response = super::HealthCheckSpecifier;
                        type Future = BoxFuture<
                            tonic::Response<Self::Response>,
                            tonic::Status,
                        >;
                        fn call(
                            &mut self,
                            request: tonic::Request<
                                super::HealthCheckRequestOrEndpointHealthResponse,
                            >,
                        ) -> Self::Future {
                            let inner = Arc::clone(&self.0);
                            let fut = async move {
                                <T as HealthDiscoveryService>::fetch_health_check(
                                        &inner,
                                        request,
                                    )
                                    .await
                            };
                            Box::pin(fut)
                        }
                    }
                    let accept_compression_encodings = self.accept_compression_encodings;
                    let send_compression_encodings = self.send_compression_encodings;
                    let max_decoding_message_size = self.max_decoding_message_size;
                    let max_encoding_message_size = self.max_encoding_message_size;
                    let inner = self.inner.clone();
                    let fut = async move {
                        let method = FetchHealthCheckSvc(inner);
                        let codec = tonic_prost::ProstCodec::default();
                        let mut grpc = tonic::server::Grpc::new(codec)
                            .apply_compression_config(
                                accept_compression_encodings,
                                send_compression_encodings,
                            )
                            .apply_max_message_size_config(
                                max_decoding_message_size,
                                max_encoding_message_size,
                            );
                        let res = grpc.unary(method, req).await;
                        Ok(res)
                    };
                    Box::pin(fut)
                }
                _ => {
                    Box::pin(async move {
                        let mut response = http::Response::new(
                            tonic::body::Body::default(),
                        );
                        let headers = response.headers_mut();
                        headers
                            .insert(
                                tonic::Status::GRPC_STATUS,
                                (tonic::Code::Unimplemented as i32).into(),
                            );
                        headers
                            .insert(
                                http::header::CONTENT_TYPE,
                                tonic::metadata::GRPC_CONTENT_TYPE,
                            );
                        Ok(response)
                    })
                }
            }
        }
    }
    impl<T> Clone for HealthDiscoveryServiceServer<T> {
        fn clone(&self) -> Self {
            let inner = self.inner.clone();
            Self {
                inner,
                accept_compression_encodings: self.accept_compression_encodings,
                send_compression_encodings: self.send_compression_encodings,
                max_decoding_message_size: self.max_decoding_message_size,
                max_encoding_message_size: self.max_encoding_message_size,
            }
        }
    }
    /// Generated gRPC service name
    pub const SERVICE_NAME: &str = "envoy.service.health.v3.HealthDiscoveryService";
    impl<T> tonic::server::NamedService for HealthDiscoveryServiceServer<T> {
        const NAME: &'static str = SERVICE_NAME;
    }
}