health-monitor-rails 12.3.0 → 12.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 952a62b089d3b56df2b8ab11b329dae2512d285db4027bde6705892e171ff755
-  data.tar.gz: 36a7996a83a871a82814caef5d31d2cc880b1f40bd12e2f191290e72a9d1537f
+  metadata.gz: 16d418a94d55bfea53470ed8a0b1d4b8614c32b2f3a0f439dd37859c99cb62b1
+  data.tar.gz: 5f53e4f8bcc43d2a2ae27fa02a14f44c277b2a37388b500b7c9450ca6834197d
 SHA512:
-  metadata.gz: a9878debcd730c9848ec50af8ed0b1ed912adffc240c1aab657c82a40e0113ac32a335f53ef32c9c7a3487eee68483235b767009e900c376eb1df55dd28cf2cd
-  data.tar.gz: d361fd7cf5fe894de0d2bce196b06c23f9c3015d1dfa545ba0158c441e2c4f1caed1d6053975a9ff545082025ec1a1c387644a7aaa4dbede0e020c8869289cac
+  metadata.gz: e09ede9673ea8c30618eeffb12b169920705b4f54376e091141008303c060a6071ec627eec576724901f046d3c697e30c0519235a22175ec100ce58286188c97
+  data.tar.gz: b0383068465c7ebb1e4beedd46c9f26801fcd2fdae8f0b591be3a4967bb72bb94f13a6a62a3c35290c3385f187ec917cafd3ea5add28386afa2c44bda9a6d6de

data/README.md

@@ -177,6 +177,7 @@ The following services are currently supported:
 * Resque
 * Delayed Job
 * Solr
+* FileAbsence
 
 ## Configuration
 
@@ -318,6 +319,12 @@ Please note that `url` or `connection` can't be used at the same time.
 * `url`: the URL used to connect to your Solr instance - must be a string. You can also use `url` to explicitly configure authentication (e.g., `'https://user:pass@example.solr.com:8983/'`)
 * `collection`: An optional parameter used to connect to your specific Solr collection - must be a string. By setting this parameter the code will check the status of this individual collection in your Solr instance instead of just the status of the overall Solr instance
 
+### FileAbsence
+
+This check allows you to create a file on your server when you would like to force the check to fail. For example if you are utilizing the `health.json` as you health check page for your load balancer and would like to force a machine offline.
+
+* `filename`: the file relative to the rails root that must remain absent for the health check to remain passing. For example: `public/remove-from-nginx`
+
 ### Adding a Custom Provider
 
 It's also possible to add custom health check providers suited for your needs (of course, it's highly appreciated and encouraged if you'd contribute useful providers to the project).
@@ -441,9 +448,11 @@ nicolas@desktop:$ echo $?
 ```
 
 ## Development
+
 In order to work on development on the gem itself
 
 ### Installing the gems
+
 Use the [appraisal gem](https://github.com/thoughtbot/appraisal) to install the bundles for different rails versions:
 
 ```bash
@@ -453,7 +462,9 @@ appraisal install
 ```
 
 ### Running the tests
+
 Use appraisal to run the tests using rake
+
 ```bash
 appraisal rake
 ```

data/lib/health_monitor/configuration.rb

@@ -2,7 +2,7 @@
 
 module HealthMonitor
   class Configuration
-    PROVIDERS = %i[cache database delayed_job redis resque sidekiq solr].freeze
+    PROVIDERS = %i[cache database delayed_job file_absence redis resque sidekiq solr].freeze
 
     attr_accessor :basic_auth_credentials,
                   :environment_variables,

data/lib/health_monitor/providers/file_absence.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'health_monitor/providers/base'
+
+module HealthMonitor
+  module Providers
+    class FileAbsenceException < StandardError; end
+
+    class FileAbsence < Base
+      class Configuration < Base::Configuration
+        DEFAULT_FILENAME = nil
+        attr_accessor :filename
+
+        def initialize(provider)
+          super(provider)
+
+          @filename = DEFAULT_FILENAME
+        end
+      end
+
+      def check!
+        return unless File.exist?(configuration.filename)
+
+        raise FileAbsenceException.new("Unwanted file #{configuration.filename} exists!")
+      end
+
+      private
+
+      def configuration_class
+        ::HealthMonitor::Providers::FileAbsence::Configuration
+      end
+    end
+  end
+end

data/lib/health_monitor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HealthMonitor
-  VERSION = '12.3.0'
+  VERSION = '12.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: health-monitor-rails
 version: !ruby/object:Gem::Version
-  version: 12.3.0
+  version: 12.4.0
 platform: ruby
 authors:
 - Leonid Beder
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-22 00:00:00.000000000 Z
+date: 2024-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -45,6 +45,7 @@ files:
 - lib/health_monitor/providers/cache.rb
 - lib/health_monitor/providers/database.rb
 - lib/health_monitor/providers/delayed_job.rb
+- lib/health_monitor/providers/file_absence.rb
 - lib/health_monitor/providers/redis.rb
 - lib/health_monitor/providers/resque.rb
 - lib/health_monitor/providers/sidekiq.rb