dpmrb 0.1.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6c0f52ffa194774f2608e5b49e4f83ac4d9042b93a4b0671a17832260346287
-  data.tar.gz: a4694ce151f8b5ff79169e81784b3d3947221f1ea4f2d2bad9ae44597e42b6e7
+  metadata.gz: 7071062b1142b4ccb9003d85dba16f38167dcb8e1338a39f0d815c6177750bf6
+  data.tar.gz: 286ac526db640e294e52a35f0939e2840ac8dd124979187e343d9f5c1a0f1c6b
 SHA512:
-  metadata.gz: 6a4908ead37f4d397f8907e4d8c9a8dfe406f1e2bd5b3351d56163540821967aadb80431dfff8684e6979c26349088922d81d1f03c241ed6488b9d119e4fdfb6
-  data.tar.gz: bd7d3ce91c79e559ef8735d17e5a5e493cd905b0237b43c863ffeed90c5a77cbfedfaf9e4a73006e818cd9f4dd51db0a2dbee046b1e1793181b87ca9c11dcbad
+  metadata.gz: d1afcdbab71d64680d3e350999585526dab02ce1fa5dcfc36f5083f88c92780148c50aa8e7ac393cb62f519f4ccf05d37bfde6cec75ea76ca22ee02f797a1533
+  data.tar.gz: eb3fcc41aa0cf974809a916a7f5c3d0d11f91342476276a92fc92e0ad895e94e519476d54528c16d05e1b202852c8dfd11b513f937c070a0e3d0210345878087

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dpmrb (0.1.1)
+    dpmrb (0.2.2)
       activesupport (~> 6.x)
 
 GEM

data/README.en-US.md

@@ -0,0 +1,76 @@
+[简体中文](README.md) | [English](README.en-US.md)
+
+# DPM
+
+Docker Package Manager, makes using your Docker as easy as package managers (`apt`, `yum`, `brew`).
+
+## Installation
+
+Dependency:
+- Docker
+- Ruby >= 2.6
+
+Install command:
+```bash
+gem install dpmrb
+```
+
+## Usage
+
+```bash
+dpm pacakges                   # List all supported packages
+dpm start mysql                # Start the package `mysql` by the config `packages/mysql.yml`
+dpm stop mysql                 # Stop the package `mysql`
+dpm status mysql               # Show the status of the package `mysql`
+dpm help                       # Get help to show all the features
+```
+
+## Package Config
+
+DPM supports two types of package configs:
+1. The "System Package Config" in the directory `packages/` of repo
+2. The "User Package Config" in the directory `~/.dpm/packages/` of user
+
+### System Package Config
+
+The goal of "System Package Config" is to make a Docker service run the same as the natively installed one. Take MySQL as an example:
+- After the native MySQL is installed and run, it will bind port 3306 by default, so our MySQL package configuration should also expose the service port to the host by default
+- After the native MySQL is installed, there are fixed configuration directories and log directories, so our MySQL package configuration must also map these directories in the container to fixed directories
+
+### User Package Config
+
+"User Package Config" has the following usage scenarios:
+1. If the default package configuration of DPM is unreasonable and you want to change it, you can use "User Package Config" to debug and view the results, and then submit MR to the repo.
+2. DPM does not provide the package you need, you need to add your own package configuration. (Contributions of your new package configuration to DPM are welcome).
+3. DPM default package configuration is not suitable for local environment, need to override "System Package Config". For example, if I need to run two MySQL services locally, then I need to change the port of one of the services to the other to avoid conflicts.
+
+#### Add User Package Config
+
+"User Package Config" provides the following commands for quick creation:
+```bash
+dpm configure PACKAGE
+```
+
+The function of this command is to add a new package configuration file `PACKAGE.yml` under the user directory `~/.dpm/`.
+If the package already exists in the "system package configuration", the contents will be initialized into this file.
+
+**Note:** If the PACKAGE parameter is `package`, the "Global Package Config" `config/package.yml` is configured, and the configuration here will be merged into all packages.
+
+## Related Tools
+
+- [Visual Studio Code Plugin](https://marketplace.visualstudio.com/items?itemName=UoooBarry.dpm-vscode)
+
+## Development
+
+### Setup environment
+
+```bash
+git clone git@github.com:songhuangcn/dpm.git
+cd dpm
+bin/setup # Need Ruby >= 2.6
+```
+
+### Development Skills
+
+- Adding ENV `DEBUG` to all commands will show detailed error stack to help locate the problem
+- After development, use the command `bin/check` to check code specifications and tests, and resolve some CI failures in advance

data/README.md

@@ -1,41 +1,75 @@
-[English](README.md) | [简体中文](README.zh-CN.md)
+[简体中文](README.md) | [English](README.en-US.md)
 
 # DPM
 
-Docker Package Manager, makes using your containers as easy as package managers (`apt`, `yml`, `brew`).
+Docker Package Manager, 让你的 Docker 用起来跟包管理器（`apt`, `yum`, `brew`）一样简单。
 
-## Installation
+## 安装
 
+依赖：
+- Docker
+- Ruby >= 2.6
+
+安装命令：
 ```bash
 gem install dpmrb
 ```
 
-## Usage
+## 使用
 
 ```bash
-dpm help                       # Show help
-dpm list                       # docker ps --filter "name=dpm-"
-dpm start mysql                # docker run --name=dpm-mysql -d --rm -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes ...
-dpm stop mysql                 # docker stop dpm-mysql
-dpm status mysql               # docker ps --filter "name=dpm-mysql"
-dpm start elasticsearch:7.10.2 # docker run --name=dpm-elasticsearch-7.10.2 -d --rm -p 9200:9200 -e discovery.type=single-node ...
-dpm start mysql:5.7            # docker run --name=dpm-mysql-5.7 -d --rm -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes ...
+dpm pacakges                   # 列出所有支持的包
+dpm start mysql                # 通过配置 `packages/mysql.yml` 运行 `mysql` 包
+dpm stop mysql                 # 停止运行 `mysql` 包
+dpm status mysql               # 展示 `mysql` 包的运行状态
+dpm help                       # 展示帮助，查看所有功能
 ```
 
-## Development
+## 包配置
+
+DPM 支持两种包配置：
+1. 项目 repo 目录 `packages/` 的 "系统包配置"
+1. 用户目录 `~/.dpm/packages` 的 "用户包配置"
+
+### 系统包配置
+
+"系统包配置" 目标是让一个 Docker 服务跑起来跟原生安装的软件一致，拿 MySQL 来举例：
+- 原生软件 MySQL 安装好运行后，会默认绑定好 3306 端口，那我们的 MySQL 包配置就要做到默认也暴露该服务端口到主机
+- 原生软件 MySQL 安装好后，有固定的配置目录和日志目录，那我们的 MySQL 包配置就要做到也将容器里的这些目录映射到固定的目录
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+### 用户包配置
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+"用户包配置" 有以下使用场景：
+1. DPM 默认包配置不合理想更改，可以先用 "用户包配置" 调试查看结果，然后给 repo 提 MR。
+2. DPM 没有提供你需要的包，需要添加自己包配置。（欢迎给 DPM 贡献你的新包配置）。
+3. DPM 默认包配置不适合本地环境，需要覆盖 "系统包配置"。比如我本地需要跑两个 MySQL 服务，那我就需要把其中一个服务的端口改成其他避免冲突。
 
-## Contributing
+#### 添加用户包配置
+
+"用户包配置" 提供了以下命令快速创建：
+```bash
+dpm configure PACKAGE
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/songhuangcn/dpm. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/songhuangcn/dpm/blob/main/CODE_OF_CONDUCT.md).
+该命令功能就是在用户目录 `~/.dpm/` 下添加一个新的包配置文件 `PACKAGE.yml`。如果该包在 "系统包配置" 已经存在，则会将内容初始化到该文件里。
 
-## License
+**注意：** 如果 PACKAGE 参数为 `package`，则配置的是 "全局系统包配置" `config/package.yml`，这里的配置会合并到所有包里。
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+## 相关工具
+
+- [Visual Studio Code 插件](https://marketplace.visualstudio.com/items?itemName=UoooBarry.dpm-vscode)
+
+## 开发调试
+
+### 搭建环境
+
+```bash
+git clone git@github.com:songhuangcn/dpm.git
+cd dpm
+bin/setup # 需要 Ruby >= 2.6
+```
 
-## Code of Conduct
+### 开发技巧
 
-Everyone interacting in the DPM project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/songhuangcn/dpm/blob/main/CODE_OF_CONDUCT.md).
+- 给所有命令添加 ENV `DEBUG` 会展示详细错误堆栈，帮助定位问题
+- 开发完后，请使用命令 `bin/check` 检查代码规范和测试，提前解决一些 CI 失败的情况

data/bin/dpm

@@ -3,8 +3,9 @@
 require_relative "../lib/dpm"
 
 begin
-  DPM::Runner.call!(ARGV)
+  DPM.call!(ARGV)
 rescue => exception
-  puts "Errors: #{exception.message}"
+  raise if ENV["DEBUG"]
+  puts "Fatal error: #{exception.message}"
   exit 1
 end

data/config/config.template.yml

@@ -0,0 +1,30 @@
+# .base: &base
+#   {}  # Base config, like: `image_name`, `tag_name`
+# .run_options: &run_options
+#   {} # Docker run options, like: `p`, `publish`, `v`, `volume`
+# .run_args: &run_args
+#   {} #Docker run args, like: `character-set-server`
+#
+# latest:
+#   base:
+#     <<: *base
+#   run_options:
+#     <<: *run_options
+#   run_args:
+#     <<: *run_args
+#
+# tag1:
+#   base:
+#     <<: *base
+#   run_options:
+#     <<: *run_options
+#   run_args:
+#     <<: *run_args
+#
+# tag2:
+#   base:
+#     <<: *base
+#   run_options:
+#     <<: *run_options
+#   run_args:
+#     <<: *run_args

data/{packages/default.yml → config/package.yml}

@@ -1,7 +1,8 @@
+base:
+  {}
 run_options:
   name: "<%= container_name %>"
   d: true
   rm: true
-image: ""
-command: ""
-args: {}
+run_args:
+  {}

data/dpm.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email = ["songhuangcn@gmail.com"]
 
   spec.summary = "Docker Package Manager."
-  spec.description = "Makes using your containers as easy as package managers (`apt`, `yml`, `brew`)."
+  spec.description = "Docker Package Manager. Makes using your containers as easy as package managers (`apt`, `yum`, `brew`)."
   spec.homepage = "https://github.com/songhuangcn/dpm"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.6.0"

data/lib/dpm/options.rb

@@ -0,0 +1,87 @@
+require "optparse"
+
+module DPM
+  class Options
+    PACKAGE_COMMANDS = %w[tags status start stop restart configure].freeze
+    PACKAGE_REGEX = /\A[\w.\-:]+\z/.freeze
+    UNPACKAGE_COMMANDS = %w[list packages cleanup].freeze
+
+    attr_accessor :argv, :dry_run, :parser, :command, :package
+
+    def initialize(argv)
+      self.argv = argv
+      self.dry_run = false
+    end
+
+    def self.parse!(argv)
+      new(argv).parse!
+    end
+
+    def parse!
+      OptionParser.new do |parser|
+        self.parser = parser
+
+        parser.banner = "Usage: dpm [options] [COMMAND] [PACKAGE]"
+        parser.separator ""
+        parser.separator "Options:"
+
+        parser.on("-d", "--dry-run", "Don't actually run Docker command, just print") do |v|
+          self.dry_run = v
+        end
+
+        parser.on_tail("-h", "--help", "Show the help") do
+          puts help_text
+          exit
+        end
+
+        parser.on_tail("-v", "--version", "Show the version") do
+          puts VERSION
+          exit
+        end
+
+        parser.parse!(argv)
+      end
+
+      process_args!
+      self
+    end
+
+    def help_text
+      <<~EOF
+        #{parser}
+        COMMAND:
+            help                             Show the help
+            version                          Show the version
+            packages                         List supported packages
+            list                             List running packages
+            cleanup                          Cleanup useless data
+            tags PACKAGE                     List supported tags of a package
+            status PACKAGE                   Get the status of a package
+            start PACKAGE                    Start a package
+            stop PACKAGE                     Stop a package
+            restart PACKAGE                  Restart a package
+            configure PACKAGE                Configure a package in the user-level, including configure a new package
+
+        See more at https://github.com/songhuangcn/dpm
+      EOF
+    end
+
+    def process_args!
+      self.command, self.package = argv
+
+      case command
+      when "help"
+        puts help_text
+        exit
+      when "version"
+        puts VERSION
+        exit
+      when *PACKAGE_COMMANDS
+        raise Error, "Command `#{command}` need a package" if package.blank?
+        raise Error, "Package invalid, valid regex: #{PACKAGE_REGEX}" if !PACKAGE_REGEX.match?(package)
+      else
+        raise Error, "Unknown command `#{command}`, see `dpm help`" unless UNPACKAGE_COMMANDS.include?(command)
+      end
+    end
+  end
+end

data/lib/dpm/runner.rb

@@ -5,81 +5,93 @@ require "erb"
 
 module DPM
   class Runner
-    PACKAGE_COMMANDS = %w[status start stop restart].freeze
-    PACKAGE_REGEX = /\A[\w.\-:]+\z/.freeze
     CONTAINER_NAME_PREFIX = "dpm-"
     BASH_COLOR_GRAY = "\033[0;37m"
     BASH_COLOR_NONE = "\033[0m"
+    DOCKER_COMMANDS = %w[list status start stop restart cleanup].freeze
 
-    attr_reader :command, :package
+    attr_accessor :options
 
-    def self.call!(argv)
-      new(argv).call!
+    def self.call!(options)
+      new(options).call!
     end
 
-    def initialize(argv)
-      @command, @package = argv
-      validate_argv!
+    def initialize(options)
+      self.options = options
     end
 
     def call!
-      if docker_command
-        puts bash_color(docker_command)
-        puts ""
-        puts `#{docker_command}`
-      else
-        puts help_text
+      case options.command
+      when *DOCKER_COMMANDS
+        call_docker!
+      when "packages"
+        call_packages!
+      when "tags"
+        call_tags!
+      when "configure"
+        call_configure!
       end
     end
 
     private
 
-    def validate_argv!
-      if PACKAGE_COMMANDS.include?(command) && !PACKAGE_REGEX.match?(package)
-        raise Error, "`package` invalid, valid regex: #{PACKAGE_REGEX}"
-      end
-    end
-
-    def bash_color(text)
-      "#{BASH_COLOR_GRAY}#{text}#{BASH_COLOR_NONE}"
-    end
-
-    def docker_command
-      case command
+    def call_docker!
+      docker_command = case options.command
       when "list"
         %(docker ps --filter "name=#{CONTAINER_NAME_PREFIX}")
       when "status"
-        %(docker ps --filter "name=#{container_name}")
+        %(docker ps --filter "name=^/#{container_name}$")
       when "start"
         "docker run #{docker_run_params}"
       when "stop"
         "docker stop #{container_name}"
       when "restart"
-        "dpm stop #{package} && dpm start #{package}"
+        "dpm stop #{options.package} && dpm start #{options.package}"
+      when "cleanup"
+        "docker system prune --force"
+      else
+        raise "Not implemented command: `#{command}`"
       end
+      if options.dry_run
+        puts "Dry run:"
+        puts bash_color(docker_command)
+      else
+        puts bash_color(docker_command)
+        puts ""
+        puts `#{docker_command}`
+      end
+    end
+
+    def call_packages!
+      packages = Dir.glob(File.join(ROOT, "packages", "*.yml")).map { |file| File.basename(file, ".yml") }
+      puts packages
+    end
+
+    def call_tags!
+      tags = package_config_yaml.keys.reject { |key| key.start_with?(".") }
+      puts tags
     end
 
-    def help_text
-      <<~EOF
-        Usage: dpm command [PACKAGE]
+    def call_configure!
+      raise Error, "Need set $EDITOR" unless ENV["EDITOR"]
 
-        Docker Package Manager
+      config_dir = package_name == "package" ? "config" : "packages"
+      user_config = File.join(HOME, config_dir, "#{package_name}.yml")
+      unless File.exist?(user_config)
+        system_config = File.join(ROOT, config_dir, "#{package_name}.yml")
+        init_data = if File.exist?(system_config)
+          File.read(system_config)
+        else
+          File.read(File.join(ROOT, "config", "config.template.yml"))
+        end
+        File.write(user_config, init_data)
+      end
 
-        dpm help:
-            Show the help
-        dpm list:
-            List running packages
-        dpm status PACKAGE:
-            Get the status of the package
-        dpm start PACKAGE:
-            Start the package
-        dpm stop PACKAGE:
-            Stop the package
-        dpm restart PACKAGE:
-            Restart the package
+      `#{ENV["EDITOR"]} #{user_config}`
+    end
 
-        See more at https://github.com/songhuangcn/dpm
-      EOF
+    def bash_color(text)
+      "#{BASH_COLOR_GRAY}#{text}#{BASH_COLOR_NONE}"
     end
 
     def docker_run_params
@@ -87,15 +99,15 @@ module DPM
     end
 
     def config_run_options
-      process_options(manager_config["run_options"])
+      process_options(package_config["run_options"])
     end
 
     def config_command
-      manager_config["command"]
+      package_config["base"]["command"]
     end
 
     def config_args
-      process_options(manager_config["args"])
+      process_options(package_config["run_args"])
     end
 
     def process_options(hash)
@@ -110,57 +122,73 @@ module DPM
           option_prefix = "--"
           value_joiner = "="
         end
-        full_value = "#{value_joiner}#{value}" if value != true
 
-        "#{option_prefix}#{key}#{full_value}"
+        if value == true
+          "#{option_prefix}#{key}"
+        elsif value.is_a?(Array)
+          value.map { |v| "#{option_prefix}#{key}#{value_joiner}#{v}" }.join(" ")
+        else
+          "#{option_prefix}#{key}#{value_joiner}#{value}"
+        end
       end
       hash_arr.join(" ")
     end
 
     def docker_image
-      image_tag ? "#{image_name}:#{image_tag}" : image_name
+      "#{image_name}:#{image_tag}"
     end
 
     def image_name
-      @image_name ||= manager_config["image_name"] || package_name
+      @image_name ||= package_config["image_name"] || package_name
     end
 
     def image_tag
-      @image_tag ||= manager_config["image_tag"] || package_tag
+      @image_tag ||= package_config["image_tag"] || package_tag
     end
 
-    def manager_config
-      @manager_config ||= begin
-        default_options = load_yaml(File.join(ROOT, "packages", "default.yml"))
-        image_options = load_yaml(File.join(ROOT, "packages", package_name, "default.yml"))
-        tag_options = load_yaml(File.join(ROOT, "packages", package_name, "tag-#{package_tag}.yml"))
-
-        default_options \
-          .deep_merge(image_options) \
-          .deep_merge(tag_options)
+    def package_config
+      @package_config ||= begin
+        version = package_tag.dup
+        version_config = loop do
+          raise Error, "Package tag `#{package_tag}` not support" unless version
+          break package_config_yaml[version] if package_config_yaml[version]
+          version = version.sub!(/\.\d+\z/, "")
+        end
+        default_config.deep_merge(version_config)
       end
     end
 
+    def package_config_yaml
+      @package_config_yaml ||= load_yaml(File.join("packages", "#{package_name}.yml"))
+    rescue Errno::ENOENT
+      raise Error, "Package `#{package_name}` not support"
+    end
+
+    def default_config
+      @default_config ||= load_yaml(File.join("config", "package.yml"))
+    end
+
     def package_name
-      @package_name ||= package.split(":")[0]
+      @package_name ||= options.package.split(":")[0]
     end
 
     def package_tag
-      @package_tag ||= package.split(":")[1]
+      @package_tag ||= options.package.split(":")[1] || "latest"
     end
 
     def container_name
-      @container_name ||= "#{CONTAINER_NAME_PREFIX}#{package.tr(":", "-")}"
+      @container_name ||= "#{CONTAINER_NAME_PREFIX}#{options.package.tr(":", "-")}"
     end
 
     def load_yaml(file_path)
-      text = File.read(file_path)
+      user_path = File.join(HOME, file_path)
+      system_path = File.join(ROOT, file_path)
+      text = File.exist?(user_path) ? File.read(user_path) : File.read(system_path)
       data = ERB.new(text).result(binding)
-      YAML.safe_load(data).tap do |yaml|
+      yaml = YAML.safe_load(data, aliases: true).tap do |yaml|
         raise Error, "Config need to be a hash yaml: #{file_path}" unless yaml.is_a?(Hash)
       end
-    rescue Errno::ENOENT
-      {}
+      yaml.transform_keys!(&:to_s)
     end
   end
 end

data/lib/dpm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DPM
-  VERSION = "0.1.1"
+  VERSION = "0.2.2"
 end

data/lib/dpm.rb

@@ -5,9 +5,17 @@ require "active_support/core_ext"
 
 require_relative "dpm/version"
 require_relative "dpm/errors"
+require_relative "dpm/options"
 require_relative "dpm/runner"
 
 module DPM
   ROOT = File.expand_path("..", __dir__).freeze
   HOME = File.expand_path("~/.dpm").freeze
+
+  def self.call!(argv)
+    options = Options.parse!(argv)
+    Runner.call!(options)
+  rescue Error => exception
+    puts "Error: #{exception.message}"
+  end
 end

data/packages/elasticsearch.yml

@@ -0,0 +1,35 @@
+.base: &base
+  {}
+.run_options: &run_options
+  p:
+    - "9200:9200"
+    - "9300:9300"
+  v: "<%= DPM::HOME %>/data/<%= package_name %>/<%= package_tag || 'default' %>:/usr/share/elasticsearch/data"
+.run_args: &run_args
+  {}
+
+latest:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+8:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+7:
+  base:
+    <<: *base
+    image_name: "docker.elastic.co/elasticsearch/elasticsearch"
+  run_options:
+    <<: *run_options
+    e: "discovery.type=single-node"
+  run_args:
+    <<: *run_args

data/packages/mysql.yml

@@ -0,0 +1,35 @@
+.base: &base
+  {}
+.run_options: &run_options
+  p: "3306:3306"
+  e: "MYSQL_ALLOW_EMPTY_PASSWORD=yes"
+  v: "<%= DPM::HOME %>/data/<%= package_name %>/<%= package_tag || 'default' %>:/var/lib/mysql"
+.run_args: &run_args
+  character-set-server: "utf8mb4"
+  collation-server: "utf8mb4_unicode_ci"
+
+latest:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+8:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+    p: "3306:3306"
+  run_args:
+    <<: *run_args
+
+5:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+    p: "3307:3307"
+  run_args:
+    <<: *run_args

data/packages/nginx.yml

@@ -0,0 +1,22 @@
+.base: &base
+  {}
+.run_options: &run_options
+  p: "80:80"
+.run_args: &run_args
+  {}
+
+latest:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+1:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args

data/packages/postgres.yml

@@ -0,0 +1,56 @@
+.base: &base
+  {}
+.run_options: &run_options
+  p: "5432:5432"
+  e: "POSTGRES_PASSWORD=mysecretpassword"
+  v: "<%= DPM::HOME %>/data/<%= package_name %>/<%= package_tag || 'default' %>:/var/lib/postgressql/data"
+.run_args: &run_args
+  {}
+
+latest:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+14:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+13:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+12:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+11:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+10:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args

data/packages/redis.yml

@@ -0,0 +1,38 @@
+.base: &base
+  {}
+.run_options: &run_options
+  p: "6379:6379"
+.run_args: &run_args
+  {}
+
+latest:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+7:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+6:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args
+
+5:
+  base:
+    <<: *base
+  run_options:
+    <<: *run_options
+  run_args:
+    <<: *run_args

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dpmrb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Song Huang
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-13 00:00:00.000000000 Z
+date: 2022-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,8 +24,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 6.x
-description: Makes using your containers as easy as package managers (`apt`, `yml`,
-  `brew`).
+description: Docker Package Manager. Makes using your containers as easy as package
+  managers (`apt`, `yum`, `brew`).
 email:
 - songhuangcn@gmail.com
 executables:
@@ -39,22 +39,23 @@ files:
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- README.en-US.md
 - README.md
-- README.zh-CN.md
 - Rakefile
 - bin/dpm
+- config/config.template.yml
+- config/package.yml
 - dpm.gemspec
 - lib/dpm.rb
 - lib/dpm/errors.rb
+- lib/dpm/options.rb
 - lib/dpm/runner.rb
 - lib/dpm/version.rb
-- packages/default.yml
-- packages/elasticsearch/default.yml
-- packages/mysql/default.yml
-- packages/mysql/tag-5.7.yml
-- packages/nginx/default.yml
-- packages/redis/default.yml
-- sig/dpm.rbs
+- packages/elasticsearch.yml
+- packages/mysql.yml
+- packages/nginx.yml
+- packages/postgres.yml
+- packages/redis.yml
 homepage: https://github.com/songhuangcn/dpm
 licenses:
 - MIT

data/README.zh-CN.md

@@ -1,103 +0,0 @@
-[English](README.md) | [简体中文](README.zh-CN.md)
-
-# DPM
-
-Docker Package Manager, 让你的容器用起来跟包管理器（`apt`, `yml`, `brew`）一样简单。
-
-## 安装
-
-```bash
-gem install dpmrb
-```
-
-## 使用
-
-```bash
-dpm help                       # Show help
-dpm list                       # docker ps --filter "name=dpm-"
-dpm start mysql                # docker run --name=dpm-mysql -d --rm -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes ...
-dpm stop mysql                 # docker stop dpm-mysql
-dpm status mysql               # docker ps --filter "name=dpm-mysql"
-dpm start elasticsearch:7.10.2 # docker run --name=dpm-elasticsearch-7.10.2 -d --rm -p 9200:9200 -e discovery.type=single-node ...
-dpm start mysql:5.7            # docker run --name=dpm-mysql-5.7 -d --rm -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes ...
-```
-
-## 为项目添加新包
-
-DPM 跟 [Homebrew](https://brew.sh/) 一样，需要完善更多的包配置，欢迎为 `packages` 目录添加你需要的包配置。
-
-### 配置级别
-
-容器配置都是通用的 YAML 格式，有三个级别：
-
-1. 默认级别：`packages/default.yml`
-1. 包级别：`packages/PACKAGE/default.yml`
-1. 版本级别：`packages/PACKAGE/tag-TAG.yml`
-
-配置是合并机制，如果一个包没有自定义配置，他就会根据默认级别配置跑起来。
-
-### 配置示例
-
-例如有配置如下：
-
-1. `packages/default.yml`：
-    ```yml
-    run_options:
-      rm: true
-      d: true
-    ```
-1. `packages/mysql/default.yml`：
-    ```yml
-    run_options:
-      e: "MYSQL_ALLOW_EMPTY_PASSWORD=yes"
-      p: "3306:3306"
-    ```
-1. `packages/mysql/tag-5.7.yml`：
-    ```yml
-    run_options:
-      p: "3307:3307"
-    ```
-
-则最终这些包配置的启动命令为：
-
-- `mysql:5.7` 的配置：
-    ```bash
-    docker run --rm -d -p 3307:3307 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes mysql:5.7
-    ```
-- `mysql` 的配置：
-    ```bash
-    docker run --rm -d -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=yes mysql
-    ```
-- `not-exist-pkg` 的配置：
-    ```bash
-    docker run --rm -d not-exist-pkg
-    ```
-
-### 其他配置
-
-有一些其他配置项，例如 `image`：
-
-`packages/elasticsearch/default.yml`
-```yml
-image: "docker.elastic.co/elasticsearch/elasticsearch"
-```
-
-则 `elasticsearch` 包的镜像将不在按约定自动计算，而是变成了：
-
-```bash
-docker.elastic.co/elasticsearch/elasticsearch
-```
-
-还有一些配置，例如：`args`，这个是传入到容器的参数，例如有配置文件 `packages/mysql/default.yml`：
-
-```yml
-args:
-  character-set-server: "utf8mb4"
-  collation-server: "utf8mb4_unicode_ci"
-```
-
-则所有版本的 `mysql` 包将会多这两个启动参数：
-
-```bash
-docker run mysql --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
-```

data/packages/elasticsearch/default.yml

@@ -1,5 +0,0 @@
-image_name: "docker.elastic.co/elasticsearch/elasticsearch"
-run_options:
-  p: "9200:9200"
-  e: "discovery.type=single-node"
-  v: "<%= DPM::HOME %>/data/<%= package_name %>/<%= package_tag || 'default' %>:/usr/share/elasticsearch/data"

data/packages/mysql/default.yml

@@ -1,7 +0,0 @@
-run_options:
-  p: "3306:3306"
-  e: "MYSQL_ALLOW_EMPTY_PASSWORD=yes"
-  v: "<%= DPM::HOME %>/data/<%= package_name %>/<%= package_tag || 'default' %>:/var/lib/mysql"
-args:
-  character-set-server: "utf8mb4"
-  collation-server: "utf8mb4_unicode_ci"

data/packages/mysql/tag-5.7.yml

@@ -1,2 +0,0 @@
-run_options:
-  v: "<%= DPM::HOME %>/data/mysql-5.7:/var/lib/mysql"

data/packages/nginx/default.yml

@@ -1,2 +0,0 @@
-run_options:
-  p: "80:80"

data/packages/redis/default.yml

@@ -1,2 +0,0 @@
-run_options:
-  p: "6379:6379"

data/sig/dpm.rbs

@@ -1,4 +0,0 @@
-module Dpm
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end