dlss-capistrano 3.11.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80eb28bbf5c58cf57b561882ef7a7f3cffed327710fb733ac0a4450fa275fd15
-  data.tar.gz: a3ae9e2feb13dd590e599a786ed7cbe2e1453ffae78124b7026eef45c1ae53b9
+  metadata.gz: 1702874c90a70b558db39872139922c1bc1f513813925c50c378cf3eac575f24
+  data.tar.gz: 1a4c30ef36c1ccf64c9883bd0b0cced6aee568958db25d74160c1d7e71ed025d
 SHA512:
-  metadata.gz: 8f13360fdbe742cf471edab521728b79a2f685fb4e98182875b951b29d65d42487cb0ccc79fd589afff5f5226d100774ff9438c25c5a724fe54ac38e6214bab8
-  data.tar.gz: 1eb046a6aca94b7d5e5ede77d06624d601dcb9548d4648bae559cb404fc4932e5d9564f0e600d352766e9a114362a0ff52632c9ffc478727efbc8ef6a9c81b89
+  metadata.gz: b9ab79dc66765e0c794966b6e6969d060d8c3f8de8b9bcac19c659f0630da6a85b5ae8b474257f98fb71313ed103938dd2d1dbdb736ca34b15e421be928f5fc7
+  data.tar.gz: 427abdeb794947a38336829bcd5cd3ad9b7bc5b64f0e262f98cfc52bdc4485196a3fdfa74a30fe91150ba63fa856034dfc307fc6c87a39e433134d2e289540c5

data/README.md

@@ -6,20 +6,21 @@ This gem provides Capistrano deployment tasks used by Stanford Libraries' Digita
 
 ## Included Tasks
 
-### Bundle 2-style Configuration
+### Remote Execution
 
-To override the capistrano-bundler gem and use Bundler 2-style configuration without using deprecated arguments, you can set the following settings in `config/deploy.rb`:
+Sometimes you want to execute a command on all boxes in a given environment, and dlss-capistrano's got your back:
 
-```ruby
-set :bundler2_config_use_hook, true # this is how to opt-in to bundler 2-style config. it's false by default
-set :bundler2_config_roles, [:app] # feel free to add roles to this array if you need them
-set :bundler2_config_deployment, true # this is true by default
-set :bundler2_config_without, 'production' # exclude development, and test bundle groups by default
-set :bundler2_config_path, '/tmp' # set to '#{shared_path}/bundle' by default
+```shell
+$ cap qa remote_execute["ps -ef | grep rolling | grep -v grep"]
+00:00 remote_execute
+      ps -ef | grep rolling | grep -v grep
+      ps -ef | grep rolling | grep -v grep
+      dor-indexing-app-qa-a.stanford.edu:
+dor_ind+  9159     1 20 Feb18 ?        14:15:03 rolling index
+      dor-indexing-app-qa-b.stanford.edu:
+dor_ind+ 29689     1 20 Feb18 ?        14:24:53 rolling index
 ```
 
-Note that only `bundler2_config_use_hook` **must** be set in order to use this functionality.
-
 ### Sidekiq symlink
 
 Every time the version of Sidekiq or Ruby changes, a corresponding Puppet PR must be made in order to update the XSendFilePath that allows Apache to access the bundled Sidekiq gem's assets. dlss-capistrano provides a hook to create a symlink to the bundled Sidekiq to avoid having to do this:
@@ -31,6 +32,19 @@ set :bundled_sidekiq_roles, [:app] # this is the default value
 
 Set this in `config/deploy.rb` to automate the symlink creation, and then use `XSendFilePath /path/to/my/app/shared/bundled_sidekiq/web/assets` in Apache configuration (in Puppet).
 
+### Status checking
+
+**NOTE**: Requires that `curl` is installed on each server host the check is run on.
+
+Use `cap ENV check_status` to hit the (*e.g.*, [okcomputer](https://github.com/sportngin/okcomputer)-based) status endpoint of your application. This is especially valuable with hosts that cannot be directly checked due to firewall rules.
+
+By default, these checks run against all nodes with the `:web` role and hit the `/status/all` endpoint. These can be configured in `config/deploy.rb` (or `config/deploy/{ENV}.rb` if you need environment-specific variation):
+
+```ruby
+set :check_status_roles, [:my_status_check_web_role]
+set :check_status_path, '/my/status/check/endpoint'
+```
+
 ### SSH
 
 `cap ENV ssh` establishes an SSH connection to the host running in `ENV` environment, and changes into the current deployment directory
@@ -72,7 +86,7 @@ These tasks are intended to replace those provided by `capistrano-sidekiq` gem,
 
 ### Sneakers via systemd
 
-`cap ENV sneakers_systemd:{quiet,stop,start,restart}`: quiets, stops, starts, restarts Sneakers via systemd.
+`cap ENV sneakers_systemd:{stop,start,restart}`: stops, starts, restarts Sneakers via systemd.
 
 
 #### Capistrano role

data/dlss-capistrano.gemspec

@@ -4,7 +4,7 @@ $:.unshift lib unless $:.include?(lib)
 
 Gem::Specification.new do |s|
   s.name        = "dlss-capistrano"
-  s.version     = '3.11.0'
+  s.version     = '4.1.0'
 
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["Chris Beer", 'Mike Giarlo']

data/lib/dlss/capistrano/tasks/check_status.rake

@@ -0,0 +1,23 @@
+# Capistrano plugin hook to set default values
+namespace :load do
+  task :defaults do
+    set :check_status_roles, fetch(:check_status_roles, [:web])
+    set :check_status_path, fetch(:check_status_path, '/status/all')
+  end
+end
+
+desc 'Run status checks'
+task :check_status do
+  on roles fetch(:check_status_roles), in: :sequence do |host|
+    status_url = "https://#{host}#{fetch(:check_status_path)}"
+
+    info "Checking status at #{status_url}"
+    status_body = capture("curl #{status_url}")
+
+    if status_body.match?(/FAILED/)
+      error status_body.lines.grep(/FAILED/).join
+    else
+      info SSHKit::Color.new($stdout).colorize('All checks passed!', :green)
+    end
+  end
+end

data/lib/dlss/capistrano/tasks/remote_execute.rake

@@ -0,0 +1,9 @@
+desc "execute command on all servers"
+task :remote_execute, :command do |_task, args|
+  raise ArgumentError, 'remote_execute task requires an argument' unless args[:command]
+
+  on roles(:all) do |host|
+    info args[:command] if fetch(:log_level) == :debug
+    info "#{host}:\n#{capture(args[:command])}"
+  end
+end

data/lib/dlss/capistrano/tasks/sneakers_systemd.rake

@@ -18,15 +18,7 @@ namespace :sneakers_systemd do
   task :add_hooks do
     after 'deploy:failed', 'sneakers_systemd:restart'
     after 'deploy:published', 'sneakers_systemd:start'
-    after 'deploy:starting', 'sneakers_systemd:quiet'
-    after 'deploy:updated', 'sneakers_systemd:stop'
-  end
-
-  desc 'Stop workers from picking up new jobs'
-  task :quiet do
-    on roles fetch(:sneakers_systemd_role) do
-      sudo :systemctl, 'reload', 'sneakers', raise_on_non_zero_exit: false
-    end
+    after 'deploy:starting', 'sneakers_systemd:stop'
   end
 
   desc 'Stop running workers gracefully'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dlss-capistrano
 version: !ruby/object:Gem::Version
-  version: 3.11.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Chris Beer
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-26 00:00:00.000000000 Z
+date: 2022-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capistrano
@@ -87,9 +87,10 @@ files:
 - lib/dlss/capistrano.rb
 - lib/dlss/capistrano/resque_pool.rb
 - lib/dlss/capistrano/resque_pool/tasks/resque_pool.rake
-- lib/dlss/capistrano/tasks/bundle_config.rake
 - lib/dlss/capistrano/tasks/bundled_sidekiq.rake
+- lib/dlss/capistrano/tasks/check_status.rake
 - lib/dlss/capistrano/tasks/deployed_branch.rake
+- lib/dlss/capistrano/tasks/remote_execute.rake
 - lib/dlss/capistrano/tasks/sidekiq_systemd.rake
 - lib/dlss/capistrano/tasks/sneakers_systemd.rake
 - lib/dlss/capistrano/tasks/ssh.rake
@@ -114,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.32
 signing_key: 
 specification_version: 4
 summary: Capistrano recipes for use in SUL/DLSS projects

data/lib/dlss/capistrano/tasks/bundle_config.rake

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-# These tasks exist because capistrano-bundler does not yet have a built-in
-# mechanism for configuring bundler 2 without deprecation warnings. We can dump
-# this if/when https://github.com/capistrano/bundler/issues/115 is resolved.
-
-def default_bundle_path
-  Pathname.new("#{shared_path}/bundle")
-end
-
-namespace :load do
-  task :defaults do
-    # This provides opt-in behavior. Do nothing if not requested.
-    set :bundler2_config_use_hook, fetch(:bundler2_config_use_hook, false)
-    set :bundler2_config_roles, fetch(:bundler2_config_roles, [:app])
-    set :bundler2_config_deployment, fetch(:bundler2_config_deployment, true)
-    set :bundler2_config_without, fetch(:bundler2_config_without, 'development:test')
-    # NOTE: `shared_path` is not defined at this point, so we can't set the default value to `default_bundle_path`
-    set :bundler2_config_path, fetch(:bundler2_config_path, nil)
-  end
-end
-
-# Integrate bundle config hook into Capistrano
-namespace :deploy do
-  before :starting, :add_bundler2_config_hook do
-    invoke 'bundler2:add_hook' if fetch(:bundler2_config_use_hook)
-  end
-end
-
-namespace :bundler2 do
-  # NOTE: no `desc` here to avoid publishing this task in the `cap -T` list
-  task :add_hook do
-    # Override capistrano-bundler settings
-    # HT: https://github.com/capistrano/bundler/issues/115#issuecomment-616570236
-    set :bundle_flags, '--quiet' # this unsets --deployment, see details in config_bundler task details
-    set :bundle_path, nil
-    set :bundle_without, nil
-
-    before 'bundler:install', 'bundler2:config'
-  end
-
-  # NOTE: This task lacks a `desc` to avoid publishing it, since we do not
-  #       foresee needing to run this task manually. It should run via hook.
-  #
-  # Configure bundler 2 without using deprecated arguments (overrides capistrano-bundler
-  task :config do
-    on roles fetch(:bundler2_config_roles) do
-      execute "bundle config --local deployment #{fetch(:bundler2_config_deployment)}"
-      execute "bundle config --local without '#{fetch(:bundler2_config_without)}'"
-      execute "bundle config --local path #{fetch(:bundler2_config_path) || default_bundle_path}"
-    end
-  end
-end