Module: MinIO::Commands

Defined in:
lib/minio/commands.rb

Defined Under Namespace

Classes: DirectoryNotFoundException, ExecutableNotFoundException, UnsupportedPlatformException

Constant Summary collapse

DEFAULT_DIR =
File.expand_path(File.join(__dir__, "..", "..", "exe"))
GEM_NAME =
"minio"

Class Method Summary collapse

Class Method Details

.executable(exe_path: DEFAULT_DIR) ⇒ Object



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# File 'lib/minio/commands.rb', line 25

def executable(exe_path: DEFAULT_DIR)
  minio_install_dir = ENV["MINIO_INSTALL_DIR"]
  if minio_install_dir
    if File.directory?(minio_install_dir)
      warn "NOTE: using MINIO_INSTALL_DIR to find minio executable: #{minio_install_dir}"
      exe_path = minio_install_dir
      exe_file = File.expand_path(File.join(minio_install_dir, "minio"))
    else
      raise DirectoryNotFoundException, <<~MESSAGE
        MINIO_INSTALL_DIR is set to #{minio_install_dir}, but that directory does not exist.
      MESSAGE
    end
  else
    if MinIO::Upstream::NATIVE_PLATFORMS.keys.none? { |p| Gem::Platform.match_gem?(Gem::Platform.new(p), GEM_NAME) }
      raise UnsupportedPlatformException, <<~MESSAGE
        minio-ruby does not support the #{platform} platform
        Please install minio following instructions at https://min.io/download?license=agpl
      MESSAGE
    end

    exe_file = Dir.glob(File.expand_path(File.join(exe_path, "*", "minio"))).find do |f|
      Gem::Platform.match_gem?(Gem::Platform.new(File.basename(File.dirname(f))), GEM_NAME)
    end
  end

  if exe_file.nil? || !File.exist?(exe_file)
    raise ExecutableNotFoundException, <<~MESSAGE
      Cannot find the minio executable for #{platform} in #{exe_path}

      If you're using bundler, please make sure you're on the latest bundler version:

          gem install bundler
          bundle update --bundler

      Then make sure your lock file includes this platform by running:

          bundle lock --add-platform #{platform}
          bundle install

      See `bundle lock --help` output for details.

      If you're still seeing this message after taking those steps, try running
      `bundle config` and ensure `force_ruby_platform` isn't set to `true`. See
      https://github.com/fractaledmind/minio-ruby#check-bundle_force_ruby_platform
      for more details.
    MESSAGE
  end

  exe_file
end

.platformObject



21
22
23
# File 'lib/minio/commands.rb', line 21

def platform
  [:cpu, :os].map { |m| Gem::Platform.local.send(m) }.join("-")
end

.server(directory, async: false, **argv) ⇒ Object



76
77
78
79
80
81
82
83
84
85
86
# File 'lib/minio/commands.rb', line 76

def server(directory, async: false, **argv)
  if MinIO.configuration
    ENV["MINIO_ROOT_USER"] ||= MinIO.configuration.username
    ENV["MINIO_ROOT_PASSWORD"] ||= MinIO.configuration.password
  end

  cmd = [executable, "server", *argv.stringify_keys, directory].flatten.compact
  puts cmd.inspect if ENV["DEBUG"]

  run(cmd, async: async)
end