avm 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a8d74639333b0b7c2b8f8e171c22dd6184ec276653bfe46ac84cbddfdf05d0c
-  data.tar.gz: f897626773b7aa103b80347a7b41740c6a5c66c3aee68e7834ee80e44263fc3a
+  metadata.gz: 3be29c02f4be9deec23c40452cf17ad0ce0478c6ae32508690d0a54bc9c4987a
+  data.tar.gz: e63f5d086715190a1803f4289a48f9e25e56094d570d62f6ed5c22b0ceeb6084
 SHA512:
-  metadata.gz: 9122946512714522606f24e5e3c79f64b773a7f4229ed25cb8c3a7e2e82b62e86a3ec4354230fdb2bce366bb36ad0e27593cd42e3e9380ab5eb82854eafbff55
-  data.tar.gz: 71b9e84a0416b0bcefccbbd283d78b5da476e1d5e366746e245eb75eb6c5f22752ef3871a4f571363554f0f99354c366823193dd6a84d3f92faa981b82299d52
+  metadata.gz: 372b53edca7fe1187fa0faa39e145437779a3608b7ce7d248b2d5fe753520079c0542dda99a80b4936f09438f6bda1fceebdb78ce1b741e14854f10160468085
+  data.tar.gz: 02bd6cdb0cdb4f02e7a202d69de40ca2c5f1c981af6198e8ce1e93b36380b0d39a436d36a358e58856675df9e040080ad6879367e013228cd6bfa3efb3e66735

data/lib/avm/data/package/dump.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require 'avm/tools/core_ext'
-require 'avm/files/rotate'
+require 'avm/data/rotate'
+require 'eac_ruby_utils/core_ext'
 require 'minitar'
 
 module Avm
@@ -88,7 +88,7 @@ module Avm
           return unless existing == EXISTING_ROTATE
 
           infom "Rotating \"#{data_file_path}\"..."
-          ::Avm::Files::Rotate.new(data_file_path).run
+          ::Avm::Data::Rotate.new(data_file_path).run
         end
 
         def new_build_path

data/lib/avm/data/rotate.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/object/blank'
+require 'eac_ruby_utils/simple_cache'
+
+module Avm
+  module Data
+    class Rotate
+      include ::EacRubyUtils::SimpleCache
+
+      attr_reader :options, :source_path
+
+      def initialize(source_path, options = {})
+        @source_path = source_path
+        @options = options
+      end
+
+      def run
+        validate_msg = validate
+        return validate_msg if validate_msg.present?
+
+        ::FileUtils.mv(source_path, target_path)
+        check_space_limit
+        nil
+      end
+
+      def space_limit
+        r = options[:space_limit].try(:to_i)
+        return r if r.present? && r.positive?
+
+        r
+      end
+
+      def space_used
+        rotated_files.inject(0) { |a, e| a + ::File.size(e) }
+      end
+
+      def rotated_files
+        ::Dir["#{dirname}/#{source_basename_without_extension}*#{source_extension}"]
+      end
+
+      def oldest_rotated_file
+        rotated_files.min_by { |file| [::File.mtime(file)] }
+      end
+
+      private
+
+      def check_space_limit
+        return unless space_limit
+
+        while space_used > space_limit
+          file = oldest_rotated_file
+          unless file
+            raise 'oldest_rotated_file returned nil ' \
+              "(Limit: #{space_limit}, used: #{space_used})"
+          end
+          ::File.delete(file)
+        end
+      end
+
+      def validate
+        return "Source file \"#{source_path}\" does not exist" unless ::File.exist?(source_path)
+        return "File \"#{source_path}\" is already rotated" if source_rotated?
+
+        nil
+      end
+
+      def source_rotated?
+        source_basename_without_extension.match(/[PN]\d{4}\z/)
+      end
+
+      def source_extension_uncached
+        file_extension(::File.basename(source_path))
+      end
+
+      def source_basename_without_extension
+        ::File.basename(source_path, source_extension)
+      end
+
+      def target_path_uncached
+        ::File.join(dirname, target_basename)
+      end
+
+      def dirname
+        ::File.dirname(source_path)
+      end
+
+      def target_basename
+        source_basename_without_extension + target_suffix + source_extension
+      end
+
+      def target_suffix
+        return '_UNKNOWN_MTIME' unless ::File.exist?(source_path)
+
+        t = ::File.mtime(source_path)
+        t.strftime('_%Y-%m-%d_%H-%M-%S_') + t.strftime('%z').gsub(/\A\+/, 'P').gsub(/\A\-/, 'N')
+      end
+
+      def file_extension(basename)
+        extension = ::File.extname(basename)
+        return '' if extension.blank?
+
+        file_extension(::File.basename(basename, extension)) + extension
+      end
+    end
+  end
+end

data/lib/avm/docker/runner.rb

@@ -13,6 +13,7 @@ module Avm
 
       runner_with :help do
         desc 'Manipulate Docker images.'
+        bool_opt '-I', '--image-name', 'Output image name.'
         arg_opt '-n', '--registry-name', 'Docker registry\'s name.'
         bool_opt '-p', '--push', 'Push the image to Docker registry.'
         bool_opt '-r', '--run', 'Run or start a container with builded image.'
@@ -27,6 +28,7 @@ module Avm
         setup
         banner
         build
+        output_image_name
         push
         container_run
       end
@@ -84,6 +86,12 @@ module Avm
         )
       end
 
+      def output_image_name
+        return unless parsed.image_name
+
+        out(docker_image.tag.to_s.strip + "\n")
+      end
+
       def registry_uncached
         registry_from_option || registry_from_instance || registry_from_default ||
           fatal_error('No registry defined')

data/lib/avm/instances/application.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entries'
+
+module Avm
+  module Instances
+    class Application
+      include ::Avm::Instances::Entries
+
+      attr_reader :id
+
+      def initialize(id)
+        @id = id.to_s
+      end
+
+      def to_s
+        id
+      end
+
+      def instance(suffix)
+        ::Avm::Instances::Base.new(self, suffix)
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/access.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Access
+          def auto_access
+            read_entry_optional('ssh.url').present? ? 'ssh' : 'local'
+          end
+
+          def auto_ssh_hostname
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ssh.hostname')
+          end
+
+          def auto_ssh_port
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ssh.port') || 22
+          end
+
+          def auto_ssh_username
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ssh.username')
+          end
+
+          def auto_ssh_url
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ssh.url') ||
+              auto_ssh_url_by_parts
+          end
+
+          def auto_ssh_url_by_parts
+            read_entry_optional('ssh.hostname').if_present do |a|
+              a = read_entry_optional('ssh.username').if_present(a) { |v| "#{v}@#{a}" }
+              a = read_entry_optional('ssh.port').if_present(a) { |v| "#{a}:#{v}" }
+              "ssh://#{a}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/admin.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Admin
+          def auto_admin_email
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'admin.email')
+          end
+
+          def auto_admin_name
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'admin.name')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/data.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'avm/data/package/dump'
+require 'avm/self/instance'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Data
+          def auto_data_default_dump_path
+            ::Avm::Self
+              .instance
+              .read_entry_optional(::Avm::Self::Instance::EntryKeys::DATA_DEFAULT_PATH)
+              .if_present do |v|
+              ::File.join(
+                v,
+                "#{id}#{::Avm::Data::Instance::Package::Dump::DEFAULT_FILE_EXTENSION}"
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/database.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Database
+          DEFAULT_HOSTNAME = '127.0.0.1'
+          DEFAULT_LIMIT = 5
+          DEFAULT_PORTS = {
+            'postgresql' => 5432,
+            'mysql' => 3306,
+            'oracle' => 1521,
+            'sqlserver' => 1433
+          }.freeze
+          DEFAULT_SYSTEM = 'postgresql'
+          DEFAULT_TIMEOUT = 5000
+
+          def auto_database_name
+            inherited_entry_value(::Avm::Instances::EntryKeys::DATABASE_ID,
+                                  ::Avm::Instances::EntryKeys::DATABASE_NAME) || id
+          end
+
+          def auto_database_hostname
+            database_auto_common('hostname') || DEFAULT_HOSTNAME
+          end
+
+          def auto_database_limit
+            database_auto_common('limit') || DEFAULT_LIMIT
+          end
+
+          def auto_database_password
+            database_auto_common('password')
+          end
+
+          def auto_database_port
+            database_auto_common('port') || database_port_by_system
+          end
+
+          def auto_database_username
+            database_auto_common('username')
+          end
+
+          def auto_database_system
+            database_auto_common('system') || DEFAULT_SYSTEM
+          end
+
+          def auto_database_timeout
+            database_auto_common('timeout') || DEFAULT_TIMEOUT
+          end
+
+          private
+
+          def database_auto_common(suffix)
+            database_key = ::Avm::Instances::EntryKeys.const_get("database_#{suffix}".upcase)
+            inherited_entry_value(::Avm::Instances::EntryKeys::DATABASE_ID, database_key) ||
+              inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, database_key)
+          end
+
+          def database_port_by_system
+            read_entry_optional(::Avm::Instances::EntryKeys::DATABASE_SYSTEM).if_present do |v|
+              DEFAULT_PORTS.fetch(v)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/filesystem.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Filesystem
+          FS_PATH_KEY = :fs_path
+
+          def auto_fs_path
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, FS_PATH_KEY) do |v|
+              v + '/' + id
+            end
+          end
+
+          def auto_data_fs_path
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, :data_fs_path) do |v|
+              v + '/' + id
+            end
+          end
+
+          def auto_fs_url
+            auto_fs_url_with_ssh || auto_fs_url_without_ssh
+          end
+
+          def auto_fs_url_with_ssh
+            read_entry_optional('ssh.url').if_present do |ssh_url|
+              read_entry_optional('fs_path').if_present do |fs_path|
+                "#{ssh_url}#{fs_path}"
+              end
+            end
+          end
+
+          def auto_fs_url_without_ssh
+            return nil if read_entry_optional('ssh.url').present?
+
+            read_entry_optional('fs_path').if_present do |fs_path|
+              "file://#{fs_path}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/mailer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entry'
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Mailer
+          ::Avm::Instances::EntryKeys.all.select { |c| c.to_s.start_with?('mailer.') }
+                                     .reject { |c| c == ::Avm::Instances::EntryKeys::MAILER_ID }
+                                     .each do |mailer_key|
+            define_method ::Avm::Instances::Entry.auto_value_method_name(mailer_key) do
+              mailer_auto_common(mailer_key)
+            end
+          end
+
+          def auto_mailer_id
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID,
+                                  ::Avm::Instances::EntryKeys::MAILER_ID) ||
+              read_entry_optional(::Avm::Instances::EntryKeys::HOST_ID)
+          end
+
+          private
+
+          def mailer_auto_common(mailer_key)
+            inherited_entry_value(::Avm::Instances::EntryKeys::MAILER_ID, mailer_key)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/ruby.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Ruby
+          def auto_ruby_version
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'ruby.version')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/source.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Source
+          def auto_source_instance_id
+            "#{application.id}_dev"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/system.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'addressable'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module System
+          def auto_system_username
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'system.username') ||
+              read_entry_optional('ssh.username')
+          end
+
+          def auto_system_groupname
+            inherited_entry_value(::Avm::Instances::EntryKeys::HOST_ID, 'system.groupname') ||
+              read_entry_optional('system.username')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values/web.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'addressable'
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        module Web
+          def auto_web_authority
+            web_url_as_uri(&:authority)
+          end
+
+          def auto_web_hostname
+            web_url_as_uri(&:host)
+          end
+
+          def auto_web_path
+            web_url_as_uri(&:path)
+          end
+
+          def auto_web_port
+            web_url_as_uri(&:port)
+          end
+
+          def auto_web_scheme
+            web_url_as_uri(&:scheme)
+          end
+
+          def auto_web_userinfo
+            web_url_as_uri(&:userinfo)
+          end
+
+          private
+
+          def web_url_as_uri
+            read_entry_optional(::Avm::Instances::EntryKeys::WEB_URL).if_present do |v|
+              yield(::Addressable::URI.parse(v))
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/auto_values.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub(__FILE__)
+
+module Avm
+  module Instances
+    class Base
+      module AutoValues
+        extend ::ActiveSupport::Concern
+
+        included do
+          %w[Access Admin Data Database Filesystem Mailer Ruby Source System Web]
+            .each do |class_name|
+            include const_get(class_name)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/dockerizable.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'eac_docker/executables'
+require 'eac_ruby_utils/core_ext'
+require 'avm/docker/container'
+
+module Avm
+  module Instances
+    class Base
+      module Dockerizable
+        enable_simple_cache
+        attr_reader :docker_image_options
+
+        def docker_image_options=(options)
+          @docker_image_options = ::ActiveSupport::HashWithIndifferentAccess.new(options)
+          reset_cache
+        end
+
+        def docker_container_exist?
+          ::EacDocker::Executables.docker.command.append(
+            ['ps', '-qaf', "name=#{docker_container_name}"]
+          ).execute!.present?
+        end
+
+        def docker_container_name
+          id
+        end
+
+        private
+
+        def docker_container_uncached
+          ::Avm::Docker::Container.new(self)
+        end
+
+        def docker_image_uncached
+          r = docker_image_class.new(docker_image_options.fetch(:registry))
+          r.instance = self if r.respond_to?(:instance)
+          r.version = docker_image_options[:version] if docker_image_options.key?(:version)
+          r.snapshot = docker_image_options[:snapshot] if docker_image_options.key?(:snapshot)
+          r
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base/entry_keys.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'avm/instances/entry_keys'
+
+module Avm
+  module Instances
+    class Base
+      module EntryKeys
+        ::Avm::Instances::EntryKeys.all.each do |key|
+          method_name = key.to_s.variableize
+          define_method method_name do
+            read_entry(key)
+          end
+
+          define_method "#{method_name}_optional" do
+            read_entry(key, required: false)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avm/instances/base.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+require 'eac_ruby_utils/simple_cache'
+require 'avm/instances/entries'
+
+module Avm
+  module Instances
+    class Base
+      enable_listable
+      enable_simple_cache
+      require_sub __FILE__, include_modules: true
+      include ::Avm::Instances::Entries
+
+      lists.add_string :access, :local, :ssh
+
+      ID_PATTERN = /\A([a-z0-9]+(?:\-[a-z0-9]+)*)_(.+)\z/.freeze
+
+      class << self
+        def by_id(id)
+          application_id, suffix = parse_id(id)
+          require 'avm/instances/application'
+          new(::Avm::Instances::Application.new(application_id), suffix)
+        end
+
+        private
+
+        def parse_id(id)
+          m = ID_PATTERN.match(id)
+          return [m[1], m[2]] if m
+
+          raise "ID Pattern no matched: \"#{id}\""
+        end
+      end
+
+      common_constructor :application, :suffix do
+        self.suffix = suffix.to_s
+      end
+
+      def id
+        "#{application.id}_#{suffix}"
+      end
+
+      def to_s
+        id
+      end
+
+      def host_env_uncached
+        access = read_entry(:access, list: ::Avm::Instances::Base.lists.access.values)
+        case access
+        when 'local' then ::EacRubyUtils::Envs.local
+        when 'ssh' then ::EacRubyUtils::Envs.ssh(read_entry('ssh.url'))
+        else raise("Unmapped access value: \"#{access}\"")
+        end
+      end
+
+      private
+
+      def source_instance_uncached
+        ::Avm::Instances::Base.by_id(source_instance_id)
+      end
+    end
+  end
+end

data/lib/avm/instances/entries.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'avm/instances/entry'
+
+module Avm
+  module Instances
+    module Entries
+      def entry(suffix, options = {})
+        ::Avm::Instances::Entry.new(self, suffix, options)
+      end
+
+      def path_prefix
+        @path_prefix ||= [id].freeze
+      end
+
+      def read_entry(entry_suffix, options = {})
+        entry(entry_suffix, options).value
+      end
+
+      def read_entry_optional(entry_suffix, options = {})
+        entry(entry_suffix, options).optional_value
+      end
+
+      def full_entry_path(entry_suffix)
+        unless entry_suffix.is_a?(::Array)
+          entry_suffix = ::EacConfig::PathsHash.parse_entry_key(entry_suffix.to_s)
+        end
+        (path_prefix + entry_suffix).join('.')
+      end
+
+      def inherited_entry_value(source_entry_suffix, target_entry_suffix, &block)
+        read_entry_optional(source_entry_suffix).if_present do |instance_id|
+          other_entry_value(instance_id, target_entry_suffix).if_present(&block)
+        end
+      end
+
+      def other_entry_value(instance_id, entry_suffix)
+        ::Avm::Instances::Base.by_id(instance_id).read_entry_optional(entry_suffix)
+      end
+    end
+  end
+end

data/lib/avm/instances/entry.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'eac_config/node'
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Instances
+    class Entry
+      class << self
+        def auto_value_method_name(suffix)
+          "auto_#{suffix.to_s.gsub('.', '_')}"
+        end
+      end
+
+      common_constructor :parent, :suffix, :options
+
+      def auto_value
+        parent.respond_to?(auto_value_method, true) ? parent.send(auto_value_method) : nil
+      end
+
+      def auto_value_method
+        self.class.auto_value_method_name(suffix)
+      end
+
+      def full_path
+        (parent.path_prefix + suffix_as_array).join('.')
+      end
+
+      def optional_value
+        read(required: false, noinput: true) || auto_value
+      end
+
+      def read(extra_options = {})
+        ::EacConfig::Node.context.current.entry(full_path, options.merge(extra_options)).value
+      end
+
+      def suffix_as_array
+        if suffix.is_a?(::Array)
+          suffix.dup
+        else
+          ::EacConfig::PathsHash.parse_entry_key(suffix.to_s)
+        end
+      end
+
+      def value
+        optional_value || read
+      end
+
+      def write(value)
+        ::EacConfig::Node.context.current.entry(full_path).value = value
+      end
+    end
+  end
+end

data/lib/avm/instances/entry_keys.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module Avm
+  module Instances
+    module EntryKeys
+      class << self
+        def all
+          all_keys.to_a
+        end
+
+        def keys_consts_set(prefix, suffixes)
+          if suffixes.is_a?(::Hash)
+            keys_consts_set_from_hash(prefix, suffixes)
+          elsif suffixes.is_a?(::Enumerable)
+            keys_consts_set_from_enum(prefix, suffixes)
+          else
+            raise "Unmapped suffixes class: #{suffixes.class}"
+          end
+        end
+
+        def key_const_set(prefix, suffix)
+          key = [prefix, suffix].reject(&:blank?).join('.')
+          const_set(key.gsub('.', '_').upcase, key)
+          all_keys << key
+        end
+
+        private
+
+        def all_keys
+          @all_keys ||= ::Set.new
+        end
+
+        def keys_consts_set_from_enum(prefix, suffixes)
+          suffixes.each { |suffix| key_const_set(prefix, suffix) }
+        end
+
+        def keys_consts_set_from_hash(prefix, suffixes)
+          suffixes.each { |k, v| keys_consts_set(prefix.to_s + (k.blank? ? '' : ".#{k}"), v) }
+        end
+      end
+
+      {
+        '' => %w[fs_path host_id source_instance_id],
+        database: %w[id hostname limit name password port system timeout username],
+        docker: %w[registry],
+        mailer: {
+          '' => %w[id from reply_to],
+          smtp: %w[address port domain username password authentication starttls_auto]
+        },
+        ssh: %w[hostname port url username],
+        web: %w[authority hostname path port scheme url userinfo]
+      }.each { |prefix, suffixes| keys_consts_set(prefix, suffixes) }
+    end
+  end
+end

data/lib/avm/instances/runner.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Instances
+    class Runner
+      class << self
+        def instance_class
+          ::Avm.const_get(stereotype_name).const_get('Instance')
+        end
+
+        def stereotype_module
+          ::Avm.const_get(stereotype_name)
+        end
+
+        def stereotype_name
+          name.demodulize
+        end
+      end
+
+      description = "Utilities for #{stereotype_name} instances."
+      runner_with :help, :subcommands do
+        desc description
+        pos_arg 'instance-id'
+        subcommands
+      end
+
+      delegate :instance_class, :stereotype_module, :stereotype_name, to: :class
+
+      private
+
+      def instance_uncached
+        self.class.instance_class.by_id(parsed.instance_id)
+      end
+    end
+  end
+end

data/lib/avm/instances.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Avm
+  module Instances
+    require 'avm/instances/application'
+    require 'avm/instances/entries'
+  end
+end

data/lib/avm/registry.rb

@@ -7,7 +7,7 @@ module Avm
   module Registry
     require_sub __FILE__
     enable_listable
-    lists.add_symbol :category, :instance_stereotypes, :scms, :source_stereotypes
+    lists.add_symbol :category, :instance_stereotypes, :runners, :scms, :source_stereotypes
 
     class << self
       enable_simple_cache

data/lib/avm/runners/base.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'eac_cli/core_ext'
+
+module Avm
+  module Runners
+    class Base
+      enable_abstract_methods
+
+      class << self
+        def command_argument
+          stereotype_name.underscore.dasherize
+        end
+
+        def stereotype_name
+          name.split('::')[-3]
+        end
+      end
+
+      delegate :command_argument, :stereotype_name, to: :class
+
+      runner_with :help, :subcommands do
+        subcommands
+      end
+
+      def to_s
+        stereotype_name
+      end
+    end
+  end
+end

data/lib/avm/self/docker_image.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'avm/docker/image'
+
+module Avm
+  module Self
+    class DockerImage < ::Avm::Docker::Image
+      def stereotype_tag
+        nil
+      end
+    end
+  end
+end

data/lib/avm/self/instance/entry_keys.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Avm
+  module Self
+    class Instance < ::Avm::Instances::Base
+      module EntryKeys
+        DATA_DEFAULT_PATH = 'data.default_path'
+        DOCKER_REGISTRY_NAME = 'docker.registry.name'
+      end
+    end
+  end
+end

data/lib/avm/self/instance.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'avm/instances/base'
+require 'avm/self/docker_image'
+require 'avm/self/instance/entry_keys'
+require 'avm/eac_ubuntu_base0/docker_image'
+
+module Avm
+  module Self
+    class Instance < ::Avm::Instances::Base
+      def docker_image_class
+        ::Avm::Self::DockerImage
+      end
+
+      def docker_registry
+        read_entry(::Avm::Self::Instance::EntryKeys::DOCKER_REGISTRY_NAME)
+      end
+
+      def docker_run_arguments
+        ['-e', "LOCAL_USER_ID=#{::Process.uid}"]
+      end
+    end
+  end
+end

data/lib/avm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Avm
-  VERSION = '0.6.1'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,15 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: avm
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Eduardo H. Bogoni
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-17 00:00:00.000000000 Z
+date: 2021-11-04 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: eac_cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.23.1
 - !ruby/object:Gem::Dependency
   name: eac_docker
   requirement: !ruby/object:Gem::Requirement
@@ -168,13 +188,34 @@ files:
 - lib/avm/data/package.rb
 - lib/avm/data/package/dump.rb
 - lib/avm/data/package/load.rb
+- lib/avm/data/rotate.rb
 - lib/avm/data/unit.rb
 - lib/avm/docker.rb
 - lib/avm/docker/container.rb
 - lib/avm/docker/image.rb
 - lib/avm/docker/runner.rb
 - lib/avm/executables.rb
+- lib/avm/instances.rb
+- lib/avm/instances/application.rb
+- lib/avm/instances/base.rb
+- lib/avm/instances/base/auto_values.rb
+- lib/avm/instances/base/auto_values/access.rb
+- lib/avm/instances/base/auto_values/admin.rb
+- lib/avm/instances/base/auto_values/data.rb
+- lib/avm/instances/base/auto_values/database.rb
+- lib/avm/instances/base/auto_values/filesystem.rb
+- lib/avm/instances/base/auto_values/mailer.rb
+- lib/avm/instances/base/auto_values/ruby.rb
+- lib/avm/instances/base/auto_values/source.rb
+- lib/avm/instances/base/auto_values/system.rb
+- lib/avm/instances/base/auto_values/web.rb
+- lib/avm/instances/base/dockerizable.rb
+- lib/avm/instances/base/entry_keys.rb
 - lib/avm/instances/docker_image.rb
+- lib/avm/instances/entries.rb
+- lib/avm/instances/entry.rb
+- lib/avm/instances/entry_keys.rb
+- lib/avm/instances/runner.rb
 - lib/avm/jobs.rb
 - lib/avm/jobs/base.rb
 - lib/avm/jobs/variables_source.rb
@@ -186,8 +227,12 @@ files:
 - lib/avm/rspec/setup.rb
 - lib/avm/rspec/shared_examples/in_avm_registry.rb
 - lib/avm/rspec/shared_examples/not_in_avm_registry.rb
+- lib/avm/runners/base.rb
 - lib/avm/scms/base.rb
 - lib/avm/scms/commit.rb
+- lib/avm/self/docker_image.rb
+- lib/avm/self/instance.rb
+- lib/avm/self/instance/entry_keys.rb
 - lib/avm/source_stereotypes/base.rb
 - lib/avm/sources.rb
 - lib/avm/sources/base.rb