eac_tools 0.121.0 → 0.122.0

data/sub/avm-eac_ubuntu_base0/.gitrepo

@@ -0,0 +1,7 @@
+[subrepo]
+  cmdver = 0.4.9
+  commit = 1811d085e51693b30d5411a4a5b3c8adc3c48c2c
+  method = merge
+  parent = e31cef66002a37582b14aaf6a6d518ca3ae32765
+  branch = master
+  remote = https://github.com/esquilo-azul/avm-eac_ubuntu_base0.git

data/sub/{avm-eac_ruby_base1/avm-eac_ruby_base1.gemspec → avm-eac_ubuntu_base0/avm-eac_ubuntu_base0.gemspec}

@@ -2,23 +2,20 @@
 
 $LOAD_PATH.push File.expand_path('lib', __dir__)
 
-require 'avm/eac_ruby_base1/version'
+require 'avm/eac_ubuntu_base0/version'
 
 Gem::Specification.new do |s|
-  s.name        = 'avm-eac_ruby_base1'
-  s.version     = Avm::EacRubyBase1::VERSION
+  s.name        = 'avm-eac_ubuntu_base0'
+  s.version     = Avm::EacUbuntuBase0::VERSION
   s.authors     = ['Put here the authors']
   s.summary     = 'Put here de description.'
 
-  s.files = Dir.glob('{lib,locale,template}/**/*', File::FNM_DOTMATCH)
-              .reject { |f| ['.', '..'].include?(File.basename(f)) }
+  s.files = Dir['{lib,template}/**/*']
   s.required_ruby_version = '>= 3.2' # rubocop:disable Gemspec/RequiredRubyVersion
 
-  s.add_dependency 'aranha-parsers', '~> 0.29'
   s.add_dependency 'avm', '~> 0.102', '>= 0.102.4'
-  s.add_dependency 'avm-eac_generic_base0', '~> 0.15', '>= 0.15.3'
-  s.add_dependency 'eac_envs-http', '~> 0.7', '>= 0.7.2'
   s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
+  s.add_dependency 'eac_templates', '~> 0.9'
 
   s.add_development_dependency 'eac_ruby_gem_support', '~> 0.15'
 end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/apache/resource.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    class Apache
+      class Resource
+        common_constructor :apache, :type, :directory_prefix, :name
+
+        def available_path
+          ::File.join(apache.etc_root, "#{directory_prefix}-available", "#{name}.conf")
+        end
+
+        def available?
+          apache.host_env.file(available_path).exist?
+        end
+
+        def disable
+          apache.host_env.command('sudo', "a2dis#{type}", name).execute!
+        end
+
+        def enable
+          apache.host_env.command('sudo', "a2en#{type}", name).execute!
+        end
+
+        def enabled_path
+          ::File.join(apache.etc_root, "#{directory_prefix}-enabled", "#{name}.conf")
+        end
+
+        def enabled?
+          apache.host_env.file(enabled_path).exist?
+        end
+
+        def remove
+          remove_disabled
+          remove_available
+        end
+
+        def remove_available
+          raise 'Remove enabled before' if enabled?
+
+          apache.host_env.command('sudo', 'rm', '-f', available_path).execute! if available?
+        end
+
+        def remove_disabled
+          disable if enabled?
+          apache.host_env.command('sudo', 'rm', '-f', enabled_path).execute! if enabled?
+        end
+
+        def write(content)
+          ::EacRubyUtils::Envs.local.command('echo', content).pipe(
+            apache.host_env.command('sudo', 'tee', available_path)
+          ).execute!
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/apache.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    class Apache
+      require_sub __FILE__
+      common_constructor :host_env
+
+      def etc_root
+        '/etc/apache2'
+      end
+
+      def service(command)
+        host_env.command('sudo', 'service', 'apache2', command)
+      end
+
+      { conf: :conf, site: :sites }.each do |type, directory_prefix|
+        define_method type do |name|
+          ::Avm::EacUbuntuBase0::Apache::Resource.new(self, type, directory_prefix, name)
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/docker_image.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    class DockerImage < ::Avm::Docker::Image
+      USER_NAME = 'myuser'
+
+      # @return [String]
+      def base_image
+        ::Avm::EacUbuntuBase0::MinimalDockerImage.new.provide.id
+      end
+
+      def stereotype_tag
+        'eac_ubuntu_base0'
+      end
+
+      def user_home
+        ::File.join('/home', user_name)
+      end
+
+      def user_name
+        USER_NAME
+      end
+
+      def user_password
+        user_name
+      end
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/instances/base.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    module Instances
+      class Base < ::Avm::Instances::Base
+        # @return [Avm::EacUbuntuBase0::Apache]
+        def apache
+          ::Avm::EacUbuntuBase0::Apache.new(host_env)
+        end
+
+        def docker_image_class
+          ::Avm::EacUbuntuBase0::DockerImage
+        end
+
+        def file_sudo_write(path, content)
+          ::EacRubyUtils::Envs.local.command('echo', content).pipe(
+            host_env.command('sudo', 'tee', path)
+          ).execute!
+        end
+      end
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/minimal_docker_image.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    class MinimalDockerImage < ::Avm::Docker::Image
+      BASE_IMAGE = 'ubuntu:24.04'
+      STEREOTYPE_TAG = 'eac_ubuntu_base0_minimal'
+
+      # @return [String]
+      def base_image
+        BASE_IMAGE
+      end
+
+      # @return [String]
+      def stereotype_tag
+        STEREOTYPE_TAG
+      end
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/rspec/ssh_docker_server.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    module Rspec
+      class SshDockerServer < ::EacDocker::Images::Templatized
+        # @return [String]
+        def base_image
+          ::Avm::EacUbuntuBase0::MinimalDockerImage.new.provide.id
+        end
+
+        # @return [EacRubyUtils::Envs::SshEnv]
+        def env
+          raise '@env is blank' if @env.blank?
+
+          @env
+        end
+
+        def on_run(&)
+          on_container do
+            on_env(&)
+          end
+        end
+
+        private
+
+        def container
+          raise '@container is blank' if @container.blank?
+
+          @container
+        end
+
+        def env_identity_file
+          eac_template.child('id_rsa').path
+        end
+
+        def env_identity_file_good_permissions
+          r = ::EacRubyUtils::Fs::Temp.file
+          ::FileUtils.cp env_identity_file, r
+          r.chmod(0o600)
+          r
+        end
+
+        def close_env
+          @identity_file.remove
+          @env = nil
+        end
+
+        def on_env
+          open_env
+          begin
+            yield
+          ensure
+            close_env
+          end
+        end
+
+        def on_container
+          provide.container.temporary(true).on_detached do |container|
+            @container = container
+            begin
+              yield
+            ensure
+              @container = nil
+            end
+          end
+        end
+
+        def open_env
+          raise 'Environment already open' if @env.present?
+
+          @identity_file = env_identity_file_good_permissions
+          @env = ::EacRubyUtils::Envs::SshEnv.new(
+            "ssh://root@#{container.hostname}" \
+            '?StrictHostKeyChecking=no' \
+            '&BatchMode=yes' \
+            "&IdentityFile=#{@identity_file}"
+          )
+        end
+      end
+    end
+  end
+end

data/sub/{avm-eac_ruby_base1/lib/avm/eac_ruby_base1/runners/base.rb → avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/runners/base/docker.rb}

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 module Avm
-  module EacRubyBase1
+  module EacUbuntuBase0
     module Runners
       class Base < ::Avm::Runners::Base
-        runner_with :help, :subcommands do
-          desc 'Ruby utilities for AVM.'
-          subcommands
+        class Docker < ::Avm::Docker::Runner
+          def use_default_registry?
+            true
+          end
         end
       end
     end

data/sub/avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0/runners/base.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Avm
+  module EacUbuntuBase0
+    module Runners
+      class Base < ::Avm::Runners::Base
+        enable_simple_cache
+        require_sub __FILE__
+
+        INSTANCE_ID = 'eac-ubuntu-base0_self'
+
+        runner_with :help, :subcommands do
+          subcommands
+        end
+
+        for_context :instance
+
+        private
+
+        def instance_uncached
+          ::Avm::EacUbuntuBase0::Instances::Base.by_id(INSTANCE_ID)
+        end
+      end
+    end
+  end
+end

data/sub/{avm/template/avm/rspec/launcher_controller/dummy/avm-tools_stub/lib/avm/tools → avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0}/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Avm
-  module Tools
-    VERSION = '1.0.0.pre.stub'
+  module EacUbuntuBase0
+    VERSION = '0.7.2'
   end
 end

data/sub/{avm-eac_ruby_base1/lib/avm/eac_ruby_base1.rb → avm-eac_ubuntu_base0/lib/avm/eac_ubuntu_base0.rb}

@@ -2,9 +2,7 @@
 
 require 'eac_ruby_base1'
 EacRubyBase1::RootModuleSetup.perform __FILE__ do
-  require 'aranha/parsers'
   require 'avm'
-  require 'avm/eac_generic_base0'
+  require 'eac_docker'
   require 'eac_templates'
-  require 'eac_envs/http'
 end

data/sub/avm-eac_ubuntu_base0/spec/lib/avm/eac_ubuntu_base0/docker_image_spec.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacUbuntuBase0::DockerImage do
+  let(:registry) { EacDocker::Registry.new('stub') }
+  let(:instance) { described_class.new(registry) }
+
+  describe '#provide' do
+    it do
+      expect(instance.provide).to be_a(EacDocker::Images::Base)
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/spec/lib/avm/eac_ubuntu_base0/rspec/ssh_docker_server_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacUbuntuBase0::Rspec::SshDockerServer do
+  let(:instance) { described_class.new }
+
+  describe '#provide' do
+    it do
+      expect(instance.provide).to be_a(EacDocker::Images::Base)
+    end
+  end
+end

data/sub/avm-eac_ubuntu_base0/spec/lib/avm/eac_ubuntu_base0/runners/base/docker_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacUbuntuBase0::Runners::Base::Docker do
+  it do
+    expect { run_command('--registry-name', 'testing', '--image-name') }.not_to raise_error
+  end
+
+  def run_command(*argv)
+    Avm::EacUbuntuBase0::Runners::Base.run(argv: %w[docker] + argv)
+  end
+end

data/sub/avm-eac_ubuntu_base0/spec/lib/avm/eac_ubuntu_base0/runners/base_spec.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+RSpec.describe Avm::EacUbuntuBase0::Runners::Base do
+  include_examples 'in_avm_registry', 'runners'
+end

data/sub/{avm-eac_ruby_base1 → avm-eac_ubuntu_base0}/spec/spec_helper.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
-require 'avm/eac_ruby_base1'
+require 'avm/eac_ubuntu_base0'
 require 'eac_ruby_gem_support'
 EacRubyUtils::Rspec.default_setup_create(File.expand_path('..', __dir__)).stub_avm_contexts

data/sub/avm-eac_ubuntu_base0/template/avm/eac_ubuntu_base0/docker_image/Dockerfile.template

@@ -0,0 +1,25 @@
+FROM %%base_image%%
+
+# Timezone
+RUN apt-get install -y tzdata
+RUN ln -fs /usr/share/zoneinfo/America/Sao_Paulo /etc/localtime
+RUN dpkg-reconfigure --frontend noninteractive tzdata
+
+# Default user
+RUN /usr/sbin/groupmod --new-name '%%user_name%%' ubuntu
+RUN /usr/sbin/usermod --shell /bin/bash --home %%user_home%% --move-home --login %%user_name%% \
+  ubuntu
+RUN /bin/echo '%%user_name%%:%%user_password%%' | /usr/sbin/chpasswd
+RUN /bin/chown %%user_name%%:%%user_name%% %%user_home%% -R
+
+# Sudo
+RUN apt-get install -y sudo
+RUN /bin/echo "%%user_name%% ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/%%user_name%%_all_nopasswd && chmod 0440 /etc/sudoers.d/%%user_name%%_all_nopasswd
+
+# Other
+RUN apt-get install -y file
+
+# Container
+USER %%user_name%%
+WORKDIR %%user_home%%
+CMD /bin/bash

data/sub/avm-eac_ubuntu_base0/template/avm/eac_ubuntu_base0/minimal_docker_image/Dockerfile.template

@@ -0,0 +1,6 @@
+FROM %%base_image%%
+
+# Base system update
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update -y --option APT::Update::Error-Mode=any
+RUN apt-get dist-upgrade -y

data/sub/avm-eac_ubuntu_base0/template/avm/eac_ubuntu_base0/rspec/ssh_docker_server/Dockerfile.template

@@ -0,0 +1,22 @@
+FROM '%%base_image%%'
+MAINTAINER Aleksandar Diklic "https://github.com/rastasheep"
+
+RUN apt-get install -y openssh-server
+RUN mkdir /var/run/sshd
+
+RUN echo 'root:root' |chpasswd
+
+RUN sed -ri 's/^#?PermitRootLogin\s+.*/PermitRootLogin yes/' /etc/ssh/sshd_config
+RUN sed -ri 's/UsePAM yes/#UsePAM yes/g' /etc/ssh/sshd_config
+
+RUN mkdir -p /root/.ssh
+ADD id_rsa /root/.ssh/id_rsa
+ADD id_rsa.pub /root/.ssh/id_rsa.pub
+ADD id_rsa.pub /root/.ssh/authorized_keys
+
+RUN apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+EXPOSE 22
+
+CMD    ["/usr/sbin/sshd", "-D"]

data/sub/avm-eac_ubuntu_base0/template/avm/eac_ubuntu_base0/rspec/ssh_docker_server/id_rsa

@@ -0,0 +1,27 @@
+-----BEGIN RSA PRIVATE KEY-----
+MIIEowIBAAKCAQEAyZfl6Z+r/Is396PdKgYEWAf0O2xt7a1UwlaP7ozRvZjmmd/X
+dkPo2ZsXe7tACAJzDHMO9UO1/WQ0ZirkVfLTe82CInwggYLxEf1vRtCV1NuVtttZ
++D0yZWb/kXEApVAIzKvCBPZJuspBPuJcEuVygJn646WXqi1X3CBDqV+YEI8sm1o3
+xn9xmsyXmW7AfIT07F1W6u4/vfGnZ3zjyXwA0ef1wZ46RgzFgVTBZOnpf0ELjcW0
+VRfvgGRytoY22pvqxtYc5Yumgddp2oi3fUKMoRrDAwU7+VFKUQv0XmMsZKKp2iei
+hl/WRI9ScXs16QNQZqVqnw9ll2aUaPVVf1Jk4QIDAQABAoIBADDiWKoyQe5XhBbU
+8YiDNQJzy1GtlWqRIYCOpRBfrWygayrdEM5o4UoDRcqHOZu3nFZkgDgRV0w+xEYS
+GJSO8aGP0AK0vt0o93Q5VIaDhhG7va49uq9rh5D3TPnjwRhVNA0NiVrSrkZRTUkG
+cvVSFlYBAMm7Ge/2VtvWJxInUCSTZPZfh+7ySAOYfDCpENgEcQKYXhx2WFrd0O/Q
+I2QgIpbpOAgqNxvaRT60gNiIKmIGAFHEJiKsK94mkaVj28GJ4kZkXkdaGQDuypYp
+nB7sO3Z5Gq2pCjAgFHxtDP2lZHN4IaX6uQBWupCPhJ63V9gLTvxTMZfI9sn6O2PS
+F50wQcECgYEA88o22sA5ZoEZ7CtXVZ9EzNOopNMFNX4IeMdu7c8+qgZWWFJDbmXV
+AqDZ0W72miSETZB8FR9unJLXlgBJWSR7R4s6KfTo9PKvfN3x0H3l+4AZXcDTexJN
+vdYWJbR+NnsW3lh5dzBiRE70GQ2QU9zQKMl9mCWVL+3o1YAz9XqTYKUCgYEA07Cn
+rPLHUQvmm4+DUlyNp8H0SBWl0jx1+cMnfWpdMMs/7bLYpkbnpqN/IgKQOf3AYI//
+lncnk1NRdNfpuf3yLtvhdqZFg9N11dbT0i0rTNlHvWzrVB4Rtu9OD3EWvCoqOPKQ
+ey+XdVyasI8W6k4hYuZiClsm2pFwxbTMBBTbYo0CgYAuQMVbh3Dcg835QtfVBNy2
+x8mNTAQG/Bx7XcssD0/iTkV/iEwG3Acn8oCg/Z6H7Dm1xZ3lHAuOZUXFzdQct5E0
+J7QnVbIFFy44UJuaZOiHaOxnHziAdx6Mz9tv1+jCSWQzVzHkbSeXsisZvbsOTiyo
+MGJFxYuihk7QgvxYrKLdiQKBgGb/aeYFTiNJ5g9EWYHmVGoOPZwhJEhRcJlwcbNc
+4DDQg69UuILWtvlmTYIvuxrsMwEIrzP3j8Ln5Bc0wpzjSUWxaFcBeYs1hPzhhLib
+j5jZk0VATJPl+XqHnvR2crhkz5xbsR6uvkO1JfLH/D9OeoITVBpz1Ui9QSCA4k8O
+Etw1AoGBAKRMXd+BxObb7+Qr0QSSjsAo2/5Ca782X1G8LoXkKqXqSiY+Y98ugpoC
+Gu+oeiHLHDW47hHbtC5rdXigcLEZQRiLVsOiwgua8AcnQxBhF4/Xi877+C8hB7ge
+JjlolpGpvjYN3QEnYxki4Fbgxxz4PX91NjnT5RF4dILhTa5kavP7
+-----END RSA PRIVATE KEY-----

data/sub/avm-eac_ubuntu_base0/template/avm/eac_ubuntu_base0/rspec/ssh_docker_server/id_rsa.pub

@@ -0,0 +1 @@
+ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDJl+Xpn6v8izf3o90qBgRYB/Q7bG3trVTCVo/ujNG9mOaZ39d2Q+jZmxd7u0AIAnMMcw71Q7X9ZDRmKuRV8tN7zYIifCCBgvER/W9G0JXU25W221n4PTJlZv+RcQClUAjMq8IE9km6ykE+4lwS5XKAmfrjpZeqLVfcIEOpX5gQjyybWjfGf3GazJeZbsB8hPTsXVbq7j+98adnfOPJfADR5/XBnjpGDMWBVMFk6el/QQuNxbRVF++AZHK2hjbam+rG1hzli6aB12naiLd9QoyhGsMDBTv5UUpRC/ReYyxkoqnaJ6KGX9ZEj1JxezXpA1BmpWqfD2WXZpRo9VV/UmTh avm@localhost

data/sub/eac_docker/.avm.yaml

@@ -0,0 +1,3 @@
+---
+locale: en
+bundle_test_command: exec rspec

data/sub/eac_docker/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.local
+Gemfile.lock

data/sub/eac_docker/.gitrepo

@@ -0,0 +1,7 @@
+[subrepo]
+  cmdver = 0.4.9
+  commit = c217f2136e09bac5c3ccc8612efc6eb002253f15
+  method = merge
+  parent = 8f52beff4b2ba7d948cd53a07ad2a3824886235b
+  branch = master
+  remote = https://github.com/esquilo-azul/eac_docker.git

data/sub/eac_docker/eac_docker.gemspec

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+require 'eac_docker/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'eac_docker'
+  s.version     = EacDocker::VERSION
+  s.authors     = ['Put here the authors']
+  s.summary     = 'Put here de description.'
+
+  s.files = Dir['{lib}/**/*']
+  s.required_ruby_version = '>= 3.2' # rubocop:disable Gemspec/RequiredRubyVersion
+
+  s.add_dependency 'eac_ruby_base1', '~> 0.1', '>= 0.1.1'
+  s.add_dependency 'eac_templates', '~> 0.9'
+
+  s.add_development_dependency 'eac_ruby_gem_support', '~> 0.15'
+end

data/sub/eac_docker/lib/eac_docker/container/exist.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    # Verify if a container identified by {#id}, if present, or {#name} already exists
+    # (running or not).
+    class Exist
+      acts_as_instance_method name_mark: :'?'
+      common_constructor :container
+      delegate :id, :name, to: :container
+
+      # @return [Boolean]
+      def result # rubocop:disable Naming/PredicateMethod
+        ::EacDocker::Executables.docker.command(
+          'ps', '--all', '--quiet', '--filter', filter
+        ).execute!.present?
+      end
+
+      # Filter used by {#result}: by {#id}, if present, or by {#name}.
+      #
+      # @return [String]
+      def filter
+        id.presence ? "id=#{id}" : "name=^/#{name}$"
+      end
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/container/identifiers.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    module Identifiers
+      common_concern do
+        immutable_accessor :name, type: :common
+      end
+
+      attr_reader :id
+
+      # Value that identifies the container to Docker commands: {#id}, if present, or {#name}.
+      #
+      # @return [String]
+      def identifier
+        id.presence || name.presence || raise('Neither `id` or `name` is present ' \
+                                              '- need at least one of them')
+      end
+
+      protected
+
+      attr_writer :id
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/container/run_command.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    class RunCommand
+      acts_as_instance_method
+      common_constructor :container, :extra_args, default: [[]]
+      delegate :capabilities, :command_args, :envs, :image, :interactive?, :name, :temporary?,
+               :tty?, :volumes, to: :container
+
+      # @return [EacRubyUtils::Envs::Command]
+      def result
+        ::EacDocker::Executables.docker.command('run', *all_args)
+      end
+
+      # @return [Array<String>]
+      def all_args
+        %w[boolean capabilities envs name volumes]
+          .inject([]) { |a, e| a + send("#{e}_args") } +
+          extra_args + [image.provide.id] + command_args
+      end
+
+      # @return [Array<String>]
+      def boolean_args
+        r = []
+        r << '--interactive' if interactive?
+        r << '--tty' if tty?
+        r << '--rm' if temporary?
+        r
+      end
+
+      # @return [Array<String>]
+      def capabilities_args
+        capabilities.flat_map { |capability| ['--cap-add', capability] }
+      end
+
+      # @return [Array<String>]
+      def envs_args
+        envs.flat_map { |name, value| ['--env', "#{name}=#{value}"] }
+      end
+
+      # @return [Array<String>]
+      def name_args
+        name.if_present([]) { |v| ['--name', v] }
+      end
+
+      # @return [Array<String>]
+      def volumes_args
+        volumes.flat_map { |volume| ['--volume', volume] }
+      end
+    end
+  end
+end

data/sub/eac_docker/lib/eac_docker/container/start_command.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    # Start an already existing container identified by {#id}, if present, or {#name}.
+    class StartCommand
+      acts_as_instance_method
+      common_constructor :container
+      delegate :identifier, :interactive?, :tty?, to: :container
+
+      # @return [EacRubyUtils::Envs::Command]
+      def result
+        ::EacDocker::Executables.docker.command('start', *start_args)
+      end
+
+      # @return [Array<String>]
+      def start_args
+        r = []
+        r << '--attach' if interactive? || tty?
+        r << '--interactive' if interactive?
+        r << identifier
+        r
+      end
+    end
+  end
+end