Class: KamalBackup::CLI

Inherits:

Thor

• Object
• Thor
• KamalBackup::CLI

Includes:

Helpers

Defined in:

lib/kamal_backup/cli.rb

Defined Under Namespace

Modules: Helpers Classes: CommandBase, DrillCLI, RestoreCLI

Class Attribute Summary

• .command_env ⇒ Object

  Returns the value of attribute command_env.

Class Method Summary

• .basename ⇒ Object
• .normalize_global_options(argv) ⇒ Object
• .start(argv = ARGV, env: ENV) ⇒ Object

Instance Method Summary

• #backup ⇒ Object
• #check ⇒ Object
• #evidence ⇒ Object
• #init ⇒ Object
• #list ⇒ Object
• #schedule ⇒ Object
• #validate ⇒ Object
• #version ⇒ Object

Methods included from Helpers

#accessory_name, #accessory_reboot_command, #bridge, #command_env, #confirm!, #confirm_production_restore!, #default_deploy_config?, #deploy_snippet, #deployment_mode?, #direct_app, #ensure_remote_version_match!, #exec_remote, #init_config_root, #local_command_config, #local_preferences, #local_restore_app, #print_backup_result, #print_remote_version_status, #production_restore_confirmation_config, #production_source_defaults, #prompt_required, #redactor, #remote_command_mode?, #remote_version, #require_typed_confirmation, #shared_config_path, #shared_config_source_defaults, #shared_config_template, #validate_deploy_config, #write_init_file

Class Attribute Details

.command_env ⇒ Object

Returns the value of attribute command_env.

# File 'lib/kamal_backup/cli.rb', line 380

def command_env
  @command_env
end

Class Method Details

.basename ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 418

def self.basename
  "kamal-backup"
end

.normalize_global_options(argv) ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 382

def normalize_global_options(argv)
  tokens = Array(argv).dup
  leading = []

  while tokens.any?
    token = tokens.first

    case token
    when "-d", "--destination", "-c", "--config-file"
      leading << tokens.shift
      leading << tokens.shift if tokens.any?
    when /\A--destination=.+\z/, /\A--config-file=.+\z/
      leading << tokens.shift
    else
      break
    end
  end

  if leading.empty? || tokens.empty?
    Array(argv)
  else
    [tokens.shift, *leading, *tokens]
  end
end

.start(argv = ARGV, env: ENV) ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 422

def self.start(argv = ARGV, env: ENV)
  self.command_env = env
  output = CommandOutput.new(io: $stderr, env: env)
  Command.with_output(output) do
    super(normalize_global_options(argv))
  end
rescue Error => e
  output ||= CommandOutput.new(io: $stderr, env: env)
  output.error("(#{e.class}): #{e.message}", redactor: Redactor.new(env: env))
  exit(1)
rescue StandardError => e
  output ||= CommandOutput.new(io: $stderr, env: env)
  output.error("(#{e.class}): #{e.message}", redactor: Redactor.new(env: env))
  exit(1)
rescue Interrupt
  output ||= CommandOutput.new(io: $stderr, env: env)
  output.error("(Interrupt): interrupted", redactor: Redactor.new(env: env))
  exit(130)
ensure
  self.command_env = nil
end

Instance Method Details

#backup ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 448

def backup
  if remote_command_mode?
    argv = ["kamal-backup", "backup"]
    argv << "--force" if options[:force]
    exec_remote(argv)
  else
    print_backup_result(direct_app.backup(force: options[:force]))
  end
end

#check ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 468

def check
  if remote_command_mode?
    exec_remote(["kamal-backup", "check"])
  else
    puts(direct_app.check)
  end
end

#evidence ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 477

def evidence
  if remote_command_mode?
    exec_remote(["kamal-backup", "evidence"])
  else
    puts(direct_app.evidence)
  end
end

#init ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 497

def init
  write_init_file(shared_config_path, shared_config_template)

  puts
  puts "Add this accessory block to your Kamal deploy config:"
  puts
  puts deploy_snippet
  puts
  puts "The accessory runs scheduled database and file backups with backup.schedule."
  puts "For most Rails apps, restore local and drill local can infer the development database, Active Storage path, and tmp state directory."
  puts "Local restore and drill also require the restic binary on your machine."
  puts "Create config/kamal-backup.local.yml only if you need to override those local defaults."
end

#list ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 459

def list
  if remote_command_mode?
    exec_remote(["kamal-backup", "list"])
  else
    puts(direct_app.snapshots)
  end
end

#schedule ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 512

def schedule
  if deployment_mode?
    exec_remote(["kamal-backup", "schedule"])
  else
    direct_app.schedule
  end
end

#validate ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 486

def validate
  if remote_command_mode?
    validate_deploy_config
  else
    direct_app.validate
  end

  puts("ok")
end

#version ⇒ Object

# File 'lib/kamal_backup/cli.rb', line 521

def version
  if remote_command_mode?
    print_remote_version_status
  else
    puts(VERSION)
  end
end