racecar 2.11.0.beta3 → 2.11.0.beta4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e94370f7438cb989f00b1b70148c97b2eb57f84aad477512829ba4160c95be4
-  data.tar.gz: 4ead1f9cd7628c2e93cce9d1485278b582c38f69c9ddcd6f84881f1b6ab61056
+  metadata.gz: c735414453200c4d57cf1507cdb912f0d96a779b6aaaec362f54e4fe9f8c1fbc
+  data.tar.gz: 22de2e18b7c68d25e1f5f68b0bbf205b6e5c3d4b66e44263f0bef51c6e09d68e
 SHA512:
-  metadata.gz: d86c13aadbf50bca785536e15cc26b8e77bd5d59ea36f12ea5e101974e1740c0a1fc074ba37140a7a2bf1f4d74e44a326a212d03206c78bc5f539fcb3b5df519
-  data.tar.gz: 06f57db93326633d4da9cdd671444a1cd71e9411fc7733ad0a8b654e184fdb311757ee4e6bf6f3897d39a0db3f0895ec6eb5b9e31beec1f53a73380bfee0dd8a
+  metadata.gz: 26070165d58aa4d92655c695af359f96717bd2f3e21c12d722ffa14538cd3cc72e10f5fd7d53b72021000540b9f6456590908d06f50be4a893883c115de5efd3
+  data.tar.gz: e4243278cdb6cc71702ccbed36234b7a07a364746b0dc934a88eb0d79c0b1be25b1fbe7f751312ce716417b5e253461e772c0582ba13dc85917308e92ca2b7db

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 2.11.0.beta4
+
+* Allow the liveness probe command to skip loading config files
+
 ## 2.11.0.beta3
 
 * Fix bug with domain socket support

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    racecar (2.11.0.beta3)
+    racecar (2.11.0.beta4)
       king_konf (~> 1.0.0)
       rdkafka (~> 0.15.0)
 

data/README.md

@@ -542,15 +542,14 @@ While `maxSurge` should always be 0, `maxUnavailable` can be increased to reduce
 Racecar comes with a built-in liveness probe, primarily for use with Kubernetes, but useful for any deployment environment where you can periodically run a process to check the health of your consumer.
 
 To use this feature:
-- set the `liveness_probe_enabled` config option to true.
-- configure your Kubernetes deployment to run `$ racecarctl liveness_probe`
+1. Set the `liveness_probe_enabled` config option to true.
+2. Configure your Kubernetes deployment liveness probe to run this command `$ racecarctl liveness_probe`
 
-
-When enabled (see config) Racecar will touch the file at `liveness_probe_file_path` each time it finishes polling Kafka and processing the messages in the batch (if any).
+When enabled (see config) Racecar will touch the file at the specified path each time it finishes polling Kafka and processing the messages in the batch (if any).
 
 The modified time of this file can be observed to determine when the consumer last exhibited 'liveness'.
 
-Running `racecarctl liveness_probe` will return a successful exit status if the last 'liveness' event happened within an acceptable time, `liveness_probe_max_interval`.
+Running `racecarctl liveness_probe` will return a successful exit status if the last 'liveness' event happened within an acceptable time, which you can set as `liveness_probe_max_interval`.
 
 `liveness_probe_max_interval` should be long enough to account for both the Kafka polling time of `max_wait_time` and the processing time of a full message batch.
 
@@ -558,9 +557,15 @@ On receiving `SIGTERM`, Racecar will gracefully shut down and delete this file,
 
 You may wish to tolerate more than one failed probe run to accommodate for environmental variance and clock changes.
 
-See the [Configuration section](https://github.com/zendesk/racecar#configuration) for the various ways the liveness probe can be configured, environment variables being one option.
+The [Configuration section](https://github.com/zendesk/racecar#configuration) for the various ways the liveness probe can be configured. (We recommend environment variables).
+
+##### Slow racecar.rb / racecar.yml? Skip config files!
+
+If your config files need to do something expensive, such as load Rails, you can enable `RACECAR_LIVENESS_PROBE_SKIP_CONFIG_FILES`. The liveness probe command will then skip loading your configuration and execute quickly.
 
-Here is an example Kubernetes liveness probe configuration:
+Most other configuration values can be set via the environment, we recommend you do this for liveness probe settings.
+
+##### Example Kubernetes Configuration
 
 ```yaml
 apiVersion: apps/v1
@@ -576,8 +581,15 @@ spec:
         - SomeConsumer
 
         env:
+        # Skip config loading to run fast, only the following values are needed
+        - name: RACECAR_LIVENESS_PROBE_SKIP_CONFIG_FILES
+          value: "true"
         - name: RACECAR_LIVENESS_PROBE_ENABLED
           value: "true"
+        - name: RACECAR_LIVENESS_PROBE_FILE_PATH
+          value: "/tmp/racecar-liveness"
+        - name: RACECAR_LIVENESS_PROBE_MAX_INTERVAL
+          value: "5"
 
         livenessProbe:
           exec:
@@ -585,8 +597,8 @@ spec:
             - racecarctl
             - liveness_probe
 
-          # Allow up to 10 consecutive failures before terminating Pod:
-          failureThreshold: 10
+          # Allow up to 3 consecutive failures before terminating Pod:
+          failureThreshold: 3
 
           # Wait 30 seconds before starting the probes:
           initialDelaySeconds: 30

data/lib/racecar/config.rb

@@ -188,6 +188,9 @@ module Racecar
     desc "Used only by the liveness probe: Max time (in seconds) between liveness events before the process is considered not healthy"
     integer :liveness_probe_max_interval, default: 5
 
+    desc "Allows the liveness probe command to skip loading config files. When enabled, configure liveness probe values via environmental variables. Defaults still apply. Only applies to the liveness probe command."
+    boolean :liveness_probe_skip_config_files, default: false
+
     desc "Strategy for switching topics when there are multiple subscriptions. `exhaust-topic` will only switch when the consumer poll returns no messages. `round-robin` will switch after each poll regardless.\nWarning: `round-robin` will be the default in Racecar 3.x"
     string :multi_subscription_strategy, allowed_values: %w(round-robin exhaust-topic), default: "exhaust-topic"
 

data/lib/racecar/ctl.rb

@@ -36,12 +36,14 @@ module Racecar
       require "racecar/liveness_probe"
       parse_options!(args)
 
-      if ENV["RAILS_ENV"] && File.exist?("config/racecar.yml")
-        Racecar.config.load_file("config/racecar.yml", ENV["RAILS_ENV"])
-      end
+      unless config.liveness_probe_skip_config_files
+        if File.exist?("config/racecar.rb")
+          require "./config/racecar"
+        end
 
-      if File.exist?("config/racecar.rb")
-        require "./config/racecar"
+        if ENV["RAILS_ENV"] && File.exist?("config/racecar.yml")
+          Racecar.config.load_file("config/racecar.yml", ENV["RAILS_ENV"])
+        end
       end
 
       Racecar.config.liveness_probe.check_liveness_within_interval!

data/lib/racecar/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Racecar
-  VERSION = "2.11.0.beta3"
+  VERSION = "2.11.0.beta4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: racecar
 version: !ruby/object:Gem::Version
-  version: 2.11.0.beta3
+  version: 2.11.0.beta4
 platform: ruby
 authors:
 - Daniel Schierbeck
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-04-08 00:00:00.000000000 Z
+date: 2024-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: king_konf
@@ -229,7 +229,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.9
 signing_key: 
 specification_version: 4
 summary: A framework for running Kafka consumers