async-service-supervisor-envoy 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15171bea49a1422dc4ef04dc7f04f904dcc28e050e97365d905c15348e19877d
-  data.tar.gz: 9ccfbff50bda3608571165db4dc9b12f46668cb1b84063d8515ef0f7f3059157
+  metadata.gz: d51f4a0841888cdb84d1d321b67202fdeab2aaba77bc54e3dbcb856d57658406
+  data.tar.gz: feea549ad0b41d010cad21f9375159bd3e43c2cb97c9314172f9288e697048cb
 SHA512:
-  metadata.gz: e8ea8643b3ae68cdb1e318e2dbae4a3b51d8c3609b7e6c1f73713828c7c76aa9539a586f810e2a91371a39b766da44471fee0b66cb22d9dcdc66d3fce7f91bfd
-  data.tar.gz: 593ec4b29fd5b582b8727fcf18552263bc286666348de95bb43dcd772e283413c28a2fdc6801d6759791266efb5253ea4f29d494aa78ea3affe922b64fd70f94
+  metadata.gz: 2cfa5c93b3e1090d045e5087ad70931c539b37d607aff20de1bab17625078dd728f0312fba050a7e9158fc4aed8bfb3e8b93863ce4b00c2fd552e20d09173317
+  data.tar.gz: e8008adf78279955e66f6852ce111bb2c451a377cbddf6f51ab2bbea0f1f51d91b2bdfce2420738eaf0e77e601a1ea282ff6ad105abfaadb31a0774d902ea960

data/bake/async/service/supervisor/envoy.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+# Get the running Envoy monitor status from the supervisor.
+def status
+	envoy_status
+end
+
+# Get the clusters currently published by the running Envoy monitor.
+def clusters
+	fetch_clusters
+end
+
+# Get a compact endpoint list from the running Envoy monitor.
+def endpoints
+	fetch_clusters.flat_map do |cluster, entries|
+		entries.map do |entry|
+			entry.merge(cluster: cluster)
+		end
+	end
+end
+
+private
+
+def supervisor_status
+	context["async:service:supervisor:status"].call
+end
+
+def envoy_status
+	status = supervisor_status
+	monitor = status.find do |entry|
+		entry[:type] == "Async::Service::Supervisor::Envoy::Monitor"
+	end
+	
+	unless monitor
+		raise "No Async::Service::Supervisor::Envoy::Monitor status found."
+	end
+	
+	monitor
+end
+
+def fetch_clusters
+	status = envoy_status
+	status.fetch(:data).fetch(:clusters)
+end

data/lib/async/service/supervisor/envoy/monitor.rb

@@ -28,6 +28,7 @@ module Async
 					# @parameter bind [String | Nil] The optional address for the xDS control plane server.
 					# @parameter delegate [Delegate] The delegate used to map supervisor state into Envoy endpoints.
 					# @parameter control_plane [Async::GRPC::XDS::ControlPlane] The xDS control plane to update.
+					# @parameter health_checks [Array(Envoy::Config::Core::V3::HealthCheck)] The active health checks applied to published clusters.
 					# @parameter orca [Boolean] Whether to collect and serve per-worker ORCA load reports.
 					# @parameter processor [Process::Metrics::Processor | Nil] The optional process CPU sampler.
 					# @parameter utilization_monitor [Async::Service::Supervisor::UtilizationMonitor | Nil] The per-worker utilization monitor used for ORCA reporting.
@@ -36,6 +37,7 @@ module Async
 						bind: nil,
 						delegate: Delegate.new,
 						control_plane: Async::GRPC::XDS::ControlPlane.new,
+						health_checks: [],
 						orca: false,
 						processor: nil,
 						utilization_monitor: nil,
@@ -47,6 +49,7 @@ module Async
 						@bind = bind
 						@delegate = delegate
 						@control_plane = control_plane
+						@health_checks = health_checks
 						@interval = interval
 						@orca = orca
 						@controllers = {}
@@ -243,7 +246,10 @@ module Async
 						raise ArgumentError, "Envoy cluster contains no common protocols: #{protocols.inspect}" if common_protocols.empty?
 						raise ArgumentError, "HTTPS upstream endpoints are not yet supported!" if schemes.first == :https
 						
-						configuration = {protocol: envoy_protocol(common_protocols)}
+						configuration = {
+							protocol: envoy_protocol(common_protocols),
+							health_checks: @health_checks,
+						}
 						
 						if @orca
 							if records.any?{|record| record[:endpoint].addresses.any?{|address| address[:path]}}

data/lib/async/service/supervisor/envoy/version.rb

@@ -11,7 +11,7 @@ module Async
 		module Supervisor
 			# @namespace
 			module Envoy
-				VERSION = "0.3.0"
+				VERSION = "0.4.0"
 			end
 		end
 	end

data/readme.md

@@ -25,6 +25,14 @@ Please see the [project documentation](https://socketry.github.io/async-service-
 
 Please see the [project releases](https://socketry.github.io/async-service-supervisor-envoy/releases/index) for all releases.
 
+### v0.4.0
+
+  - Publish configured active health checks with Envoy clusters.
+
+### v0.3.1
+
+  - Add Bake tasks for inspecting Envoy monitor status, clusters, and endpoints.
+
 ### v0.3.0
 
   - Add supervisor-driven out-of-band ORCA load reporting for independently addressable workers.
@@ -43,10 +51,6 @@ Please see the [project releases](https://socketry.github.io/async-service-super
   - Publish grouped IP and Unix-domain-socket endpoint addresses to Envoy.
   - Configure generated clusters from each endpoint's supported HTTP protocol names.
 
-### v0.1.0
-
-  - Deduplicate immutable endpoint values reported by multiple supervised workers and aggregate their health.
-
 ## See Also
 
   - [async-service-supervisor](https://github.com/socketry/async-service-supervisor) - Supervisor for managed Async service workers.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.4.0
+
+  - Publish configured active health checks with Envoy clusters.
+
+## v0.3.1
+
+  - Add Bake tasks for inspecting Envoy monitor status, clusters, and endpoints.
+
 ## v0.3.0
 
   - Add supervisor-driven out-of-band ORCA load reporting for independently addressable workers.
@@ -17,7 +25,3 @@
   - Register concrete Falcon cluster listeners as Envoy upstream endpoint state after binding.
   - Publish grouped IP and Unix-domain-socket endpoint addresses to Envoy.
   - Configure generated clusters from each endpoint's supported HTTP protocol names.
-
-## v0.1.0
-
-  - Initial release.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-service-supervisor-envoy
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: async-http
   requirement: !ruby/object:Gem::Requirement
@@ -112,6 +112,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- bake/async/service/supervisor/envoy.rb
 - code.md
 - context/getting-started.md
 - context/index.yaml