async-grpc-xds 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49d59879d476dd4d2e5f134a637371d29e1d0f352b35f22494630e424919e64d
-  data.tar.gz: 8a6898813f97f84ef507a4bd001f8fc224912d297296cc3439f523853bf43f44
+  metadata.gz: fb5e9b5b4fbb4b738a33f5714254602767c65774e0d3cab49c0c7528042885c5
+  data.tar.gz: 7c1fc5b76c954ed6c2a61f6b2f3e154f1287492f9f81438cfccec0788d803beb
 SHA512:
-  metadata.gz: 0f19714dcf5dd780cdfa9e7df25dcc52aa921ece5f168d10b0e8b2b34896a171098f4c907590e0ca27f8e43bf01e0e737faeb41bb2a746770762bb7dd807d1dd
-  data.tar.gz: a5c9b8d7e1cfff638f626c03f7643c5e27385365e30cb9bdaaf7802c3ba8655fd71dff1523506f2cb96ab70d9230a86ec9040bccf1c446b4de9ea15eb6788990
+  metadata.gz: ba0e68b3e2b1a7767ae5d3e62646818a746d5553d7a2187511914d2cb8cc37a491fae834865294936c6982abefff76b676b0b8bfb67ad93eca55eb3b9f6245d9
+  data.tar.gz: e973bf4dd5bbf1e54efd2c6fba9134960d879a66039e49c0361b47d6bacba1f9e458d0cbcd4c109fe2d134794fef3983c86911332564a3557244b39bb95fbdde

checksums.yaml.gz.sig

@@ -1,6 +1,4 @@
-e�(Ѽ�\�H�UB1��*�P�g��
�S��$������<+�V��jJǻ?�6	�X�K���Oș�J5C�x�j����5�y�O�uWy%�YG�|�'��n�#P�Q9;(hd-N+�W�n�}�m�2ic�@!���m��C�4�		~,�?�+
-p燙D.�O-��ΐ:�wx/je�6��N��_��GC���U���:��u:zѫj{=�J��C0+o��͞?6
-�@��O���}C��Ay*쥏�8u�J��F���B�w�Z��o�S����B�?����2.YR��B���v��,�pN�5v��p�
-�|_��%)��"�n ��'�Pq{��Ix���+l���C�
-w�͋�(:���/�W,EE�D�
-�����73
+w�ʚ���,T�\L���'��b�b.�v����yϏ<[�B����9|*�94�Bū��;�`���������jB
+�@�3̮�e\*~z�W�	*��/)D6��*�6�d�B��V�/�_IF����
+��ah:��#
+�U��u�R?���)�[|5J�2�X|�S�f�F��r��f�Y��x�l����kU��-y1+�e�x8�����L=G��ϡ�{z����ǀل

data/lib/async/grpc/xds/cluster.rb

@@ -22,11 +22,12 @@ module Async
 				# @parameter name [String] The cluster name.
 				# @parameter service_name [String] The EDS service name.
 				# @parameter load_balancing_policy [Envoy::Config::Cluster::V3::LoadBalancingPolicy | Nil] The typed Envoy load-balancing policy.
+				# @parameter health_checks [Array(Envoy::Config::Core::V3::HealthCheck)] The active health checks applied to cluster endpoints.
 				# @parameter connect_timeout [Numeric] The upstream connection timeout in seconds.
 				# @parameter protocol [Symbol] The canonical upstream protocol, either `:http1` or `:http2`.
 				# @returns [Envoy::Config::Cluster::V3::Cluster] The generated cluster resource.
 				# @raises [ArgumentError] If the upstream protocol is unsupported.
-				def build(name, service_name: name, load_balancing_policy: nil, connect_timeout: 5, protocol: :http2)
+				def build(name, service_name: name, load_balancing_policy: nil, health_checks: [], connect_timeout: 5, protocol: :http2)
 					options = {
 						name: name.to_s,
 						type: Envoy::Config::Cluster::V3::Cluster::DiscoveryType::EDS,
@@ -37,6 +38,7 @@ module Async
 							)
 						),
 						connect_timeout: duration(connect_timeout),
+						health_checks: health_checks,
 					}
 					
 					options[:load_balancing_policy] = load_balancing_policy if load_balancing_policy

data/lib/async/grpc/xds/http_health_check.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "google/protobuf/duration_pb"
+require "google/protobuf/wrappers_pb"
+
+require "envoy/config/core/v3/health_check_pb"
+
+module Async
+	module GRPC
+		module XDS
+			# Builds Envoy HTTP active health checks.
+			module HTTPHealthCheck
+				extend self
+				
+				# Build an HTTP active health check.
+				# @parameter path [String] The request path used to check each endpoint.
+				# @parameter interval [Numeric] The interval between checks in seconds.
+				# @parameter timeout [Numeric] The check timeout in seconds.
+				# @parameter unhealthy_threshold [Integer] The consecutive failures required to mark an endpoint unhealthy.
+				# @parameter healthy_threshold [Integer] The consecutive successes required to mark an endpoint healthy.
+				# @returns [Envoy::Config::Core::V3::HealthCheck] The generated health check.
+				def build(path, interval: 1, timeout: 1, unhealthy_threshold: 2, healthy_threshold: 1)
+					Envoy::Config::Core::V3::HealthCheck.new(
+						timeout: duration(timeout),
+						interval: duration(interval),
+						unhealthy_threshold: Google::Protobuf::UInt32Value.new(value: Integer(unhealthy_threshold)),
+						healthy_threshold: Google::Protobuf::UInt32Value.new(value: Integer(healthy_threshold)),
+						http_health_check: Envoy::Config::Core::V3::HealthCheck::HttpHealthCheck.new(path: path.to_s)
+					)
+				end
+				
+				private
+				
+				def duration(value)
+					seconds = value.to_i
+					
+					Google::Protobuf::Duration.new(
+						seconds: seconds,
+						nanos: ((value.to_f - seconds) * 1_000_000_000).to_i
+					)
+				end
+			end
+		end
+	end
+end

data/lib/async/grpc/xds/version.rb

@@ -9,7 +9,7 @@ module Async
 	module GRPC
 		# @namespace
 		module XDS
-			VERSION = "0.2.0"
+			VERSION = "0.3.0"
 		end
 	end
 end

data/lib/async/grpc/xds.rb

@@ -15,6 +15,7 @@ require_relative "xds/context"
 require_relative "xds/client"
 require_relative "xds/cluster"
 require_relative "xds/endpoint"
+require_relative "xds/http_health_check"
 require_relative "xds/client_side_weighted_round_robin"
 require_relative "xds/control_plane"
 require_relative "xds/service"

data/readme.md

@@ -26,6 +26,10 @@ docker compose -f xds/docker-compose.yaml up --build --exit-code-from tests
 
 Please see the [project releases](https://socketry.github.io/async-grpc-xds/releases/index) for all releases.
 
+### v0.3.0
+
+  - Add Envoy HTTP active health-check resources and attach health checks to generated clusters.
+
 ### v0.2.0
 
   - Add ORCA load reporting messages, service interface, and client-side weighted-round-robin resources.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.3.0
+
+  - Add Envoy HTTP active health-check resources and attach health checks to generated clusters.
+
 ## v0.2.0
 
   - Add ORCA load reporting messages, service interface, and client-side weighted-round-robin resources.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-grpc-xds
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -138,6 +138,7 @@ files:
 - lib/async/grpc/xds/discovery_client.rb
 - lib/async/grpc/xds/endpoint.rb
 - lib/async/grpc/xds/health_checker.rb
+- lib/async/grpc/xds/http_health_check.rb
 - lib/async/grpc/xds/load_balancer.rb
 - lib/async/grpc/xds/resource_cache.rb
 - lib/async/grpc/xds/resources.rb