backup_nexus 0.1.0

data/lib/generators/backup_nexus/templates/migration.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+class CreateBackupNexusTables < ActiveRecord::Migration[8.0]
+  def up
+    rename_legacy_table(:rails_nexus_backups, :backup_nexus_backups)
+    rename_legacy_table(:rails_nexus_backup_configs, :backup_nexus_backup_configs)
+    create_backups unless table_exists?(:backup_nexus_backups)
+    create_backup_configs unless table_exists?(:backup_nexus_backup_configs)
+  end
+
+  def down
+    if table_exists?(:backup_nexus_backups) && !table_exists?(:rails_nexus_backups)
+      rename_table :backup_nexus_backups, :rails_nexus_backups
+    elsif table_exists?(:backup_nexus_backups)
+      drop_table :backup_nexus_backups
+    end
+
+    if table_exists?(:backup_nexus_backup_configs) && !table_exists?(:rails_nexus_backup_configs)
+      rename_table :backup_nexus_backup_configs, :rails_nexus_backup_configs
+    elsif table_exists?(:backup_nexus_backup_configs)
+      drop_table :backup_nexus_backup_configs
+    end
+  end
+
+  private
+
+  def rename_legacy_table(legacy_name, new_name)
+    return unless table_exists?(legacy_name)
+    return if table_exists?(new_name)
+
+    rename_table legacy_name, new_name
+  end
+
+  def create_backups
+    create_table :backup_nexus_backups do |t|
+      t.string :config_name, null: false
+      t.string :status, null: false
+      t.text :file_path
+      t.bigint :file_size
+      t.float :duration
+      t.text :error_message
+      t.string :triggered_by
+      t.datetime :started_at, null: false
+      t.datetime :completed_at
+    end
+
+    add_index :backup_nexus_backups, %i[config_name started_at]
+    add_index :backup_nexus_backups, :status
+    add_index :backup_nexus_backups, :started_at
+  end
+
+  def create_backup_configs
+    create_table :backup_nexus_backup_configs do |t|
+      t.string :name, null: false
+      t.string :description
+      t.string :database_name, null: false
+      t.string :adapter, null: false, default: "mysql"
+      t.string :host, default: "localhost"
+      t.integer :port
+      t.string :username
+      t.string :password
+      t.string :skip_tables
+      t.string :storage_path, null: false
+      t.integer :keep_count, default: 30
+      t.boolean :compress, default: true
+      t.boolean :bzip2_compress, default: false
+      t.boolean :encrypted, default: false
+      t.string :encryption_password
+      t.boolean :encrypt_base64, default: false
+      t.boolean :gpg_enabled, default: false
+      t.string :gpg_password
+      t.boolean :rsync_enabled, default: false
+      t.string :rsync_host
+      t.integer :rsync_port, default: 22
+      t.string :rsync_user
+      t.string :rsync_path
+      t.boolean :rsync_mirror, default: false
+      t.boolean :rsync_archive, default: true
+      t.string :rsync_directories
+      t.string :rsync_excludes
+      t.string :mysql_additional_options
+      t.boolean :s3_enabled, default: false
+      t.string :s3_access_key
+      t.string :s3_secret_key
+      t.string :s3_bucket
+      t.string :s3_region, default: "us-east-1"
+      t.string :s3_prefix
+      t.boolean :archive_enabled, default: false
+      t.string :archive_paths
+      t.string :archive_excludes
+      t.boolean :split_chunks, default: false
+      t.string :notify_command
+      t.boolean :notify_on_success, default: true
+      t.boolean :notify_on_failure, default: true
+      t.boolean :email_notify, default: false
+      t.string :email_to
+      t.string :schedule_cron
+      t.boolean :enabled, default: true
+      t.timestamps
+    end
+
+    add_index :backup_nexus_backup_configs, :name, unique: true
+    add_index :backup_nexus_backup_configs, :enabled
+  end
+end

data/lib/tasks/backup_nexus.rake

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+namespace :backup_nexus do
+  desc "Run a specific backup by name: backup_nexus:backup[daily_backup]"
+  task :backup, [:name] => :environment do |_task, args|
+    name = args[:name]
+    if name.blank?
+      puts "Usage: rake backup_nexus:backup[config_name]"
+      puts "Available configs:"
+      BackupNexus::BackupConfig.enabled.pluck(:name).each { |config_name| puts "  - #{config_name}" }
+      next
+    end
+
+    result = BackupNexus::BackupRunner.run(name)
+    if result[:success]
+      puts "✓ Backup \"#{name}\" completed successfully (#{result[:record].duration_human})"
+    else
+      puts "✗ Backup \"#{name}\" failed: #{result[:error]}"
+      exit 1
+    end
+  end
+
+  desc "Run all enabled backup configs"
+  task backup_all: :environment do
+    BackupNexus::BackupRunner.run_all.each do |result|
+      if result[:success]
+        puts "✓ #{result[:record].config_name} completed"
+      else
+        puts "✗ #{result[:record]&.config_name || '?'} failed: #{result[:error]}"
+      end
+    end
+  end
+
+  desc "Run backups matching the current cron schedule"
+  task backup_scheduled: :environment do
+    results = BackupNexus::BackupRunner.run_scheduled
+    if results.empty?
+      puts "No backups scheduled for this time"
+    else
+      results.each do |result|
+        if result[:success]
+          puts "✓ #{result[:record].config_name} completed"
+        else
+          puts "✗ #{result[:record]&.config_name || '?'} failed: #{result[:error]}"
+        end
+      end
+    end
+  end
+
+  desc "Clean up old backup records (default: 30 days)"
+  task :backup_cleanup, [:days] => :environment do |_task, args|
+    days = (args[:days] || 30).to_i
+    count = BackupNexus::Backup.where("started_at < ?", days.days.ago).delete_all
+    puts "✓ Deleted #{count} backup records older than #{days} days"
+  end
+
+  desc "List all backup configs and their status"
+  task backup_list: :environment do
+    configs = BackupNexus::BackupConfig.order(:name)
+    if configs.empty?
+      puts "No backup configs found"
+    else
+      configs.each do |config|
+        status = config.enabled? ? "✓" : "✗"
+        last = config.recent_backups(limit: 1).first
+        last_str = last ? "#{last.status} #{last.started_at&.strftime('%b %d %H:%M')}" : "never"
+        puts "#{status} #{config.name.ljust(20)} #{config.adapter.ljust(12)} #{config.database_name.ljust(20)} last: #{last_str}"
+      end
+    end
+  end
+
+  desc "Seed the safe example backup config"
+  task seed_backups: :environment do
+    seed_file = File.join(BackupNexus::Engine.root, "db", "seeds", "backup_configs_safe.rb")
+    if File.exist?(seed_file)
+      load seed_file
+    else
+      puts "Seed file not found: #{seed_file}"
+    end
+  end
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: backup_nexus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tamiru Hailu
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+- !ruby/object:Gem::Dependency
+  name: rails_nexus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pagy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.5'
+description: A Rails engine for configuring, running, tracking, and retaining database
+  and file backups.
+email:
+- tamiruhailu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/backup_nexus/application_controller.rb
+- app/controllers/backup_nexus/backup_controller.rb
+- app/helpers/backup_nexus/application_helper.rb
+- app/jobs/backup_nexus/backup_job.rb
+- app/models/backup_nexus/backup.rb
+- app/models/backup_nexus/backup_config.rb
+- app/services/backup_nexus/backup_runner.rb
+- app/services/backup_nexus/backup_service.rb
+- app/views/backup_nexus/backup/_form.html.erb
+- app/views/backup_nexus/backup/config_history.html.erb
+- app/views/backup_nexus/backup/edit.html.erb
+- app/views/backup_nexus/backup/history.html.erb
+- app/views/backup_nexus/backup/index.html.erb
+- app/views/backup_nexus/backup/new.html.erb
+- backup_nexus.gemspec
+- config/routes.rb
+- db/seeds/backup_configs_safe.rb
+- lib/backup_nexus.rb
+- lib/backup_nexus/base_record.rb
+- lib/backup_nexus/configuration.rb
+- lib/backup_nexus/engine.rb
+- lib/backup_nexus/version.rb
+- lib/generators/backup_nexus/backup_generator.rb
+- lib/generators/backup_nexus/install_generator.rb
+- lib/generators/backup_nexus/templates/backup/backup/backup_helper.sh
+- lib/generators/backup_nexus/templates/backup/backup/config.rb
+- lib/generators/backup_nexus/templates/backup/backup/models/daily_backup.rb
+- lib/generators/backup_nexus/templates/backup/backup/models/full_backup.rb
+- lib/generators/backup_nexus/templates/backup/backup/models/sync_backup.rb
+- lib/generators/backup_nexus/templates/backup/backup/mysql-config/db_config.cnf
+- lib/generators/backup_nexus/templates/backup/backup/schedule.rb
+- lib/generators/backup_nexus/templates/migration.rb
+- lib/tasks/backup_nexus.rake
+homepage: https://github.com/tamiru/backup_nexus
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/tamiru/backup_nexus
+  source_code_uri: https://github.com/tamiru/backup_nexus/tree/main
+  changelog_uri: https://github.com/tamiru/backup_nexus/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/tamiru/backup_nexus/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Backup management for Rails applications
+test_files: []