capistrano-ops 0.2.11 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2744c35793b74ff96ed5933892458ed3bbb86d33b93b4a9aab119996ab099048
-  data.tar.gz: 8245cc91a46097474588d94f4b935dc0f2c83090bf1818c7da4e6f37662bfaa0
+  metadata.gz: 8c6192691d485f5348cadfb470f7c06c7e86e4aca51daedcb1ffe33be9923a2d
+  data.tar.gz: 469cba09f0f444133aa54451d8e7f06fac4430d3ab9cc67bc52714f76402949f
 SHA512:
-  metadata.gz: ddc408fdde37cbc926b36ce1fd3dce989a2aa6c4a73e61a700af581c02b3432274b49837784d182fa1f07ea48cb1ca253e8c6e9647d5aadbe6313d8c319bb57f
-  data.tar.gz: 14c1223afe87285ced3ce3790ef73b3b515a2912dd62cfd15da8e08ea2bebee3945c0773ba2af423bfc6753756a3dbd3f7d22acebcdf3de5117c6051c0934615
+  metadata.gz: 0bca2a6b0dd5e2b7dd724c623ea1f9f22bb6c05ca16ee654f805253fac5dedbf955c1c729dac8aa3c4d66822eead8b38cb7a62645dca5d7b11fe034cf860b3ca
+  data.tar.gz: 74c95eea7b0f4bc7b95b24010f7a651a987a06234f455c63e68d9e8cac3961930a2fe0cc9dee105be44401b40aef01a40ba274734cd1bf9cc3255884dfe6766c

data/README.md

@@ -96,6 +96,9 @@ require 'capistrano/ops'
 | `cap <environment> logs:rails`                   | display server log live                                           |
 | `cap <environment> whenever:show_crontab`        | display server app crontab generated with whenever                |
 | `cap <environment> invoke:rake TASK=<your:task>` | invoke rake task on server                                        |
+| `cap <environment> logrotate:enable`             | enable logrotate for logfiles on server                           |
+| `cap <environment> logrotate:disable`            | disable logrotate for logfiles on server                          |
+| `cap <environment> logrotate:check`              | show logrotate status for logfiles on server                      |
 | `rake pg:dump`                                   | creates postgres database backup                                  |
 | `rake pg:remove_old_dumps`                       | remove old postgres backups                                       |
 | `rake storage:backup`                            | creates backup of storage                                         |
@@ -232,6 +235,35 @@ S3_BACKUP_SECRET: '<your-s3-secret>'
 S3_BACKUP_ENDPOINT: '<your-s3-endpoint>' # optional, used for other S3 compatible services
 ```
 
+## Logrotate
+
+Logrotate is a utility designed for administrators who manage servers producing a high volume of log files to help them save some disk space as well as to avoid a potential risk making a system unresponsive due to the lack of disk space.
+
+The capistrano-ops gem provides a set of tasks to manage logrotate on your server:
+
+- `cap <environment> logrotate:enable` - This task enables logrotate for logfiles on the server.
+- `cap <environment> logrotate:disable` - This task disables logrotate for logfiles on the server.
+- `cap <environment> logrotate:check` - This task shows the logrotate status for logfiles on the server.
+
+### Configuration
+
+You can optionally specify the logrotate configuration file path (Defaults to `/etc/logrotate.conf`):
+
+```ruby
+# Defaults to '/etc/logrotate.conf'
+set :logrotate_path, '/path/to/your/logrotate.conf'
+```
+
+### Usage
+
+To use logrotate, you need to have it installed on your server. If it's not installed, you can install it using the package manager of your system. For example, on Ubuntu, you can install it using apt:
+
+```bash
+sudo apt-get install logrotate
+```
+
+Once logrotate is installed, you can use the capistrano-ops tasks to manage it.
+
 ## Contributing
 
 1. Fork it ( https://github.com/zauberware/capistrano-ops/fork )
@@ -247,3 +279,7 @@ The gem is available as open source under the terms of the [MIT License](http://
 ```
 
 ```
+
+```
+
+```

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/check.rake

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative 'logrotate_helper'
+
+namespace :logrotate do
+  include LogrotateHelper
+
+  desc 'show logrotate state and config'
+  task :check do
+    on roles(:app) do
+      within release_path do
+        set_config
+        if logrotate_enabled
+          puts "logrotate running with config\n========================="
+          puts capture "cat #{@config_file_path}"
+        else
+          puts 'logrotate disabled'
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/disable.rake

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative 'logrotate_helper'
+
+namespace :logrotate do
+  include LogrotateHelper
+
+  desc 'disable logrotate'
+  task :disable do
+    on roles(:app) do
+      within release_path do
+        set_config
+        if logrotate_disabled
+          puts 'logrotate already disabled'
+        else
+          whenever 'clear' if logrotate_enabled
+          delete_files
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/enable.rake

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative 'logrotate_helper'
+
+namespace :logrotate do
+  include LogrotateHelper
+  desc 'Enable logrotate for the application'
+  task :enable do
+    on roles(:app) do
+      within release_path do
+        set_config
+        if logrotate_enabled
+          puts "logrotate already enabled:\n========================="
+          puts capture "cat #{@config_file_path}"
+        else
+          make_basepath
+          upload! StringIO.new(@config_template), @config_file_path
+          upload! StringIO.new(@schedule_template), @schedule_file_path
+          whenever 'update' if logrotate_enabled
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/logrotate_helper.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module LogrotateHelper
+  # rubocop:disable Naming/MemoizedInstanceVariableName
+  def set_config
+    info ''
+    @shared_path ||= shared_path
+    @log_file_path ||= fetch(:log_file_path) || "#{@shared_path}/log"
+    @template_config_filename ||= fetch(:logrotate_template_config_file) || 'templates/logrotate.conf.erb'
+    @template_schedule_filename ||= fetch(:logrotate_template_schedule_file) || 'templates/schedule.rb.erb'
+    @basepath ||= fetch(:logrotate_basepath) || "#{shared_path}/logrotate"
+    @config_filename ||= File.basename(@template_config_filename, '.erb')
+    @schedule_filename ||= File.basename(@template_schedule_filename, '.erb')
+    @config_file_path ||= "#{@basepath}/#{@config_filename}"
+    @schedule_file_path ||= "#{@basepath}/#{@schedule_filename}"
+    @config_template ||= config_template
+    @schedule_template ||= schedule_template
+  end
+  # rubocop:enable Naming/MemoizedInstanceVariableName
+
+  def config
+    {
+      template_config_file: fetch(:logrotate_template_config_file) || 'templates/logrotate.conf.erb',
+      template_schedule_file: fetch(:logrotate_template_schedule_file) || 'templates/schedule.rb.erb'
+    }
+  end
+
+  def make_basepath
+    puts capture "mkdir -pv #{@basepath}"
+  end
+
+  def delete_files
+    puts capture "rm -rfv #{@basepath}"
+  end
+
+  def config_template
+    return nil unless @template_config_filename && File.exist?(File.expand_path(@template_config_filename, __dir__))
+
+    ERB.new(File.read(File.expand_path(@template_config_filename, __dir__))).result(binding)
+  end
+
+  def schedule_template
+    return nil unless @template_schedule_filename && File.exist?(File.expand_path(@template_schedule_filename, __dir__))
+
+    ERB.new(File.read(File.expand_path(@template_schedule_filename, __dir__))).result(binding)
+  end
+
+  def logrotate_enabled
+    test("[ -f #{@config_file_path} ]") && test("[ -f #{@schedule_file_path} ]")
+  end
+
+  def logrotate_disabled
+    !(test("[ -f #{@config_file_path} ]") && test("[ -f #{@schedule_file_path} ]"))
+  end
+
+  def whenever(type)
+    case type
+    when 'clear'
+      puts capture :bundle, :exec, :whenever, '--clear-crontab',
+                   "-f #{@schedule_file_path} #{fetch(:whenever_identifier)}_logrotate"
+    when 'update'
+      puts capture :bundle, :exec, :whenever, '--update-crontab', "-f #{@schedule_file_path}",
+                   "-i #{fetch(:whenever_identifier)}_logrotate"
+    else
+      puts 'type not found'
+    end
+  end
+end

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/templates/logrotate.conf.erb

@@ -0,0 +1,10 @@
+<%= @log_file_path %>/*.log {
+        daily
+        dateext
+        missingok
+        rotate 52
+        compress
+        delaycompress
+        notifempty
+        copytruncate
+}

data/lib/capistrano/ops/capistrano/v3/tasks/logrotate/templates/schedule.rb.erb

@@ -0,0 +1,8 @@
+env :PATH, ENV['PATH']
+set :output, -> { '2>&1 | logger -t logrotate' }
+
+job_type :logrotate, '/usr/sbin/logrotate -s <%= @shared_path %>/logrotate/status <%= @shared_path %>/logrotate/logrotate.conf :output'
+
+every "0 0 * * *" do
+    logrotate "logrotate"
+end

data/lib/capistrano/ops/capistrano.rb

@@ -6,10 +6,11 @@ if defined?(Capistrano::VERSION) && Gem::Version.new(Capistrano::VERSION).releas
   load File.expand_path('capistrano/v3/tasks/whenever.rake', __dir__)
   load File.expand_path('capistrano/v3/tasks/backup.rake', __dir__)
   load File.expand_path('capistrano/v3/tasks/figaro_yml.rake', __dir__)
-  load File.expand_path('capistrano/v3/tasks/logs.rake', __dir__)
   load File.expand_path('capistrano/v3/tasks/invoke.rake', __dir__)
   path = File.expand_path(__dir__)
   Dir.glob("#{path}/capistrano/v3/tasks/backup/**/*.rake").each { |f| load f }
+  Dir.glob("#{path}/capistrano/v3/tasks/logrotate/**/*.rake").each { |f| load f }
+  Dir.glob("#{path}/capistrano/v3/tasks/logs/**/*.rake").each { |f| load f }
 else
   puts 'Capistrano 3 is required to use this gem'
 end

data/lib/capistrano/ops/version.rb

@@ -2,6 +2,6 @@
 
 module Capistrano
   module Ops
-    VERSION = '0.2.11'
+    VERSION = '0.2.12'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capistrano-ops
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.2.12
 platform: ruby
 authors:
 - Florian Crusius
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-15 00:00:00.000000000 Z
+date: 2024-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-s3
@@ -128,7 +128,13 @@ files:
 - lib/capistrano/ops/capistrano/v3/tasks/backup/storage/pull.rake
 - lib/capistrano/ops/capistrano/v3/tasks/figaro_yml.rake
 - lib/capistrano/ops/capistrano/v3/tasks/invoke.rake
-- lib/capistrano/ops/capistrano/v3/tasks/logs.rake
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/check.rake
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/disable.rake
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/enable.rake
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/logrotate_helper.rb
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/templates/logrotate.conf.erb
+- lib/capistrano/ops/capistrano/v3/tasks/logrotate/templates/schedule.rb.erb
+- lib/capistrano/ops/capistrano/v3/tasks/logs/rails.rake
 - lib/capistrano/ops/capistrano/v3/tasks/whenever.rake
 - lib/capistrano/ops/notification.rb
 - lib/capistrano/ops/notification/api.rb