magellan-cli 0.4.4 → 0.5.0

data/lib/magellan/cli/messaging.rb

@@ -0,0 +1,18 @@
+require "magellan/cli"
+
+module Magellan
+  module Cli
+    module Messaging
+
+      autoload :Base, "magellan/cli/messaging/base"
+      autoload :Http, "magellan/cli/messaging/http"
+      # autoload :Spdy, "magellan/cli/messaging/spdy"
+      autoload :Mqtt, "magellan/cli/messaging/mqtt"
+
+      MAPPING = {
+        "Http" => "http",
+        "Mqtt" => "mqtt",
+      }
+    end
+  end
+end

data/lib/magellan/cli/reference_generator.rb

@@ -16,9 +16,13 @@ module Magellan
         @shell = Thor::Shell::Basic.new
         change_global_var_temporarily(["$PROGRAM_NAME", "magellan-cli"]) do
           process(Magellan::Cli::Command, "index.md")
-          Magellan::Cli::Resources::MAPPING.each do |class_name, res_name|
+          Magellan::Cli::Resources::MAPPING.each do |class_name, name|
             klass = Magellan::Cli::Resources.const_get(class_name)
-            process(klass, "#{res_name}.md", res_name)
+            process(klass, "resources/#{name}.md", name)
+          end
+          Magellan::Cli::Messaging::MAPPING.each do |class_name, name|
+            klass = Magellan::Cli::Messaging.const_get(class_name)
+            process(klass, "messaging/#{name}.md", name)
           end
         end
       end
@@ -38,25 +42,37 @@ module Magellan
         end
       end
 
-      def process(klass, filename, res_name = nil)
+      def process(klass, filename, name = nil)
         if cmd = klass.all_commands["help"]
           cmd.description = I18n.t(:help, scope: [:base, :cmd])
         end
 
-        path = File.expand_path(File.join(@subdir, filename), @dest)
+        rel_path = File.join(@subdir, filename)
+        path = File.expand_path(rel_path, @dest)
         FileUtils.mkdir_p(File.dirname(path))
         instance = klass.new
         open(path, "w") do |f|
           f.puts "---"
           f.puts "layout: index"
-          f.puts %!breadcrumb: <a href="/">Top</a> / <a href="/reference">Reference</a> / <a href="/reference/magellan-cli">magellan-cli</a> / #{res_name}!
+          version = Magellan::Cli::VERSION.split(/\./)[0,2].join(".")
+          f.puts "title: " << [name, "magellan-cli-#{version} (#{I18n.locale})", "Reference"].compact.join(" | ")
+          lang_links = I18n.available_locales.map do |locale|
+            (locale == I18n.locale) ? locale.to_s :
+              begin
+                path = rel_path.sub(/\/#{I18n.locale}\//, "/#{locale}/").sub(/\.md\z/, ".html")
+                %!<a href="/#{path}">#{locale}</a>!
+              end
+          end
+          f.puts %!breadcrumb: <a href="/">Top</a> / <a href="/reference">Reference</a> / <a href="/reference/magellan-cli/#{I18n.locale}">magellan-cli-#{version}</a> / #{name} #{lang_links.join(' ')}!
           f.puts "---"
           f.puts
 
           f.puts "## "<< I18n.t(:commands, scope: :reference)
           f.puts
           klass.sorted_commands.each do |cmd|
-            rel_path = Magellan::Cli::Resources::MAPPING.values.include?(cmd.name) ? "./#{cmd.name}.html" : "##{cmd.name}"
+            rel_path =
+              Magellan::Cli::Resources::MAPPING.values.include?(cmd.name) ? "./resources/#{cmd.name}.html" :
+                Magellan::Cli::Messaging::MAPPING.values.include?(cmd.name) ? "./messaging/#{cmd.name}.html" : "##{cmd.name}"
             f.puts "- [%s](%s)" % [Thor.send(:banner, cmd, false, false), rel_path]
           end
           f.puts
@@ -74,6 +90,7 @@ module Magellan
           f.puts "## " << I18n.t(:details, scope: :reference)
           klass.sorted_commands.each do |cmd|
             next if Magellan::Cli::Resources::MAPPING.values.include?(cmd.name)
+            next if Magellan::Cli::Messaging::MAPPING.values.include?(cmd.name)
             f.puts "### <a name=\"#{cmd.name}\"></a>#{cmd.name}"
             f.puts
             f.puts "```text"

data/lib/magellan/cli/resources/base.rb

@@ -46,7 +46,7 @@ module Magellan
               q = {}
               (self.class.resource_dependency || {}).each do |f, res|
                 r = sel[res]
-                raise NotSelected, I18n.t(:not_selected, scope: [:resources_base, :default_query], label: f) unless r
+                raise NotSelected, I18n.t(:not_selected, scope: [:resources, :base, :default_query], label: f) unless r
                 q[f] = r["id"]
               end
               build_query(q)
@@ -55,13 +55,12 @@ module Magellan
 
           def get_first_result!(name, path, query)
             results = get_json(path, query)
-            raise NotFound, I18n.t(:not_found, scope: [:resources_base, :get_first_result], name: name, query: query.inspect) if results.blank? || results.first.blank?
+            raise NotFound, I18n.t(:not_found, scope: [:resources, :base, :get_first_result], name: name, query: query.inspect) if results.blank? || results.first.blank?
             results.first
           end
 
-          DEFAULT_SELECTION_FIELDS = %w[id name].freeze
-
-          def update_first_result(name, path, query, fields = DEFAULT_SELECTION_FIELDS)
+          def update_first_result(name, path, query, fields = nil)
+            fields ||= ["id", self.class.caption_attr].compact
             r = get_first_result!(name, path, query)
             obj = fields.each_with_object({}) do |f, d|
               d[f] = r[f]
@@ -168,7 +167,7 @@ module Magellan
           end
 
           def select(name)
-            q = build_query("name" => name).update(default_query)
+            q = build_query(self.class.caption_attr => name).update(default_query)
             update_first_result(self.class.parameter_name, "/admin/#{self.class.resource_key}.json", q)
           end
 
@@ -204,6 +203,8 @@ module Magellan
                 cattr_accessor :resource_dependency
                 cattr_accessor :field_associations
                 cattr_accessor :hidden_fields, :multiline_fields
+                cattr_accessor :caption_attr
+                self.caption_attr = "name"
 
                 def self.parameter_name
                   resource_key.gsub(/~/, "_")
@@ -213,22 +214,22 @@ module Magellan
                 end
               end
 
-              desc "list", "#{I18n.t(:list, scope: [:resources_common, :cmd], res_names: res_name.pluralize)}"
+              desc "list", "#{I18n.t(:list, scope: [:resources, :common, :cmd], res_names: res_name.pluralize)}"
               def list
                 super
               end
 
-              desc "show [ID]", "#{I18n.t(:show, scope: [:resources_common, :cmd], res_name: res_name)}"
+              desc "show [ID]", "#{I18n.t(:show, scope: [:resources, :common, :cmd], res_name: res_name)}"
               def show(id = nil)
                 super(id)
               end
 
-              desc "select NAME", "#{I18n.t(:select, scope: [:resources_common, :cmd], res_name: res_name)}"
+              desc "select NAME", "#{I18n.t(:select, scope: [:resources, :common, :cmd], res_name: res_name)}"
               def select(name)
                 super
               end
 
-              desc "deselect", "#{I18n.t(:deselect, scope: [:resources_common, :cmd], res_name: res_name)}"
+              desc "deselect", "#{I18n.t(:deselect, scope: [:resources, :common, :cmd], res_name: res_name)}"
               def deselect
                 super
               end

data/lib/magellan/cli/resources/client_version.rb

@@ -13,8 +13,9 @@ module Magellan
         self.field_associations = {
           "stage_title_id" => {name: "stage", class: "Stage"},
         }
+        self.caption_attr = "version"
 
-        desc "create VERSION", I18n.t(:create, scope: [:client_version, :cmd], resource_name: resource_name)
+        desc "create VERSION", I18n.t(:create, scope: [:resources, :client_version, :cmd], resource_name: resource_name)
         def create(version)
           stage = load_selection!(Stage)
           params = {
@@ -28,7 +29,7 @@ module Magellan
           # select(version)
         end
 
-        desc "delete VERSION", I18n.t(:delete, scope: [:client_version, :cmd], resource_name: resource_name)
+        desc "delete VERSION", I18n.t(:delete, scope: [:resources, :client_version, :cmd], resource_name: resource_name)
         def delete(version)
           q = build_query("version" => version).update(default_query)
           r = get_first_result!(self.class.resource_name, "/admin/#{resource_key}.json", q)

data/lib/magellan/cli/resources/cloudsql.rb

@@ -12,10 +12,10 @@ module Magellan
         self.resource_dependency = {"stage" => Stage.parameter_name}
         self.hidden_fields = %w[cloudsql_instance_id].map(&:freeze).freeze
 
-        desc "create NAME", I18n.t(:create, scope: [:resources_common, :cmd], resource_name: "#{resource_name} database")
-        option :A, type: :boolean, default: false, desc: I18n.t(:async, scope: [:cloudsql, :cmd_create])
-        option :i, type: :numeric, default: 10, desc: I18n.t(:interval, scope: [:cloudsql, :cmd_create])
-        option :t, type: :numeric, default: 600, desc: I18n.t(:timeout, scope: [:cloudsql, :cmd_create])
+        desc "create NAME", I18n.t(:create, scope: [:resources, :common, :cmd], resource_name: "#{resource_name} database")
+        option :A, type: :boolean, default: false, desc: I18n.t(:async, scope: [:resources, :cloudsql, :cmd_create])
+        option :i, type: :numeric, default: 10, desc: I18n.t(:interval, scope: [:resources, :cloudsql, :cmd_create])
+        option :t, type: :numeric, default: 600, desc: I18n.t(:timeout, scope: [:resources, :cloudsql, :cmd_create])
         def create(name)
           o = load_selection!(Stage)
           params = {

data/lib/magellan/cli/resources/deletable.rb

@@ -10,7 +10,7 @@ module Magellan
         def self.included(klass)
           klass.module_eval do
 
-            desc "delete NAME", I18n.t(:delete, scope: [:resources_common, :cmd], resource_name: resource_name)
+            desc "delete NAME", I18n.t(:delete, scope: [:resources, :common, :cmd], resource_name: resource_name)
             def delete(name)
               q = build_query("name" => name).update(default_query)
               r = get_first_result!(self.class.resource_name, "/admin/#{resource_key}.json", q)

data/lib/magellan/cli/resources/organization.rb

@@ -11,7 +11,7 @@ module Magellan
         self.resource_key = "magellan~auth~organization"
         # self.field_associations = {"creator_id" => {name: "creator", class: "User"} }
 
-        desc "create NAME", I18n.t(:create, scope: [:resources_common, :cmd], resource_name: resource_name)
+        desc "create NAME", I18n.t(:create, scope: [:resources, :common, :cmd], resource_name: resource_name)
         def create(name)
           params = {
             parameter_name => {

data/lib/magellan/cli/resources/project.rb

@@ -13,14 +13,14 @@ module Magellan
         self.hidden_fields = %w[default_nebula_id created_at updated_at].map(&:freeze).freeze
         self.field_associations = {"organization_id" => {name: "organization", class: "Organization"} }
 
-        desc "update ATTRIBUTES", I18n.t(:update, scope: [:resources_common, :cmd], resource_name: resource_name)
+        desc "update ATTRIBUTES", I18n.t(:update, scope: [:resources, :common, :cmd], resource_name: resource_name)
         def update(attrs)
           s = load_selection!(self.class)
           attrs = JSON.parse(File.readable?(attrs) ? File.read(attrs) : attrs)
           put_json("/admin/project/#{s['id']}/edit", {"project" => attrs})
         end
 
-        desc "create NAME", I18n.t(:create, scope: [:resources_common, :cmd], resource_name: resource_name)
+        desc "create NAME", I18n.t(:create, scope: [:resources, :common, :cmd], resource_name: resource_name)
         def create(name)
           o = load_selection!(Organization)
           params = {

data/lib/magellan/cli/resources/stage.rb

@@ -17,8 +17,8 @@ module Magellan
         VERSION_RESOURCE_KEY = "stage~version".freeze
         VERSION_PARAMETER_NAME = "stage_version".freeze
 
-        desc "create NAME [-t development|staging|production|other]", "Create a new #{resource_name} with Name and Type"
-        option :t, type: :string, default: "development", desc: "-t development|staging|production. specify Stage Type"
+        desc "create NAME [-t development|staging|production|other]", I18n.t(:create, scope: [:resources, :stage, :cmd], resource_name: resource_name)
+        option :t, type: :string, default: "development", desc: I18n.t(:type, scope: [:resources, :stage, :cmd_create])
         def create(name)
           type = options["t"]
           unless %w{ development staging production other }.include?(type)
@@ -36,7 +36,7 @@ module Magellan
           select(name)
         end
 
-        desc "select NAME", I18n.t(:select, scope: [:resources_common, :cmd], res_name: resource_name)
+        desc "select NAME", I18n.t(:select, scope: [:resources, :common, :cmd], res_name: resource_name)
         def select(name)
           if selected = load_selections[parameter_name]
             deselect unless selected["name"] == name
@@ -54,7 +54,7 @@ module Magellan
           update_first_result(VERSION_PARAMETER_NAME, "/admin/stage~version.json", q, %w[id])
         end
 
-        desc "deselect", I18n.t(:deselect, scope: [:resources_common, :cmd], res_name: resource_name)
+        desc "deselect", I18n.t(:deselect, scope: [:resources, :common, :cmd], res_name: resource_name)
         def deselect
           update_selections! do |s|
             s.delete(parameter_name)
@@ -63,12 +63,12 @@ module Magellan
           deselect_dependants
         end
 
-        desc "planning", I18n.t(:planning, scope: [:stage, :cmd])
+        desc "planning", I18n.t(:planning, scope: [:resources, :stage, :cmd])
         def planning
           switch_version(1)
         end
 
-        desc "current", I18n.t(:current, scope: [:stage, :cmd])
+        desc "current", I18n.t(:current, scope: [:resources, :stage, :cmd])
         def current
           switch_version(2)
         end
@@ -81,7 +81,7 @@ module Magellan
           end
         end
 
-        desc "prepare", I18n.t(:prepare, scope: [:stage, :cmd], containers_name: Container.resource_name.pluralize)
+        desc "prepare", I18n.t(:prepare, scope: [:resources, :stage, :cmd], containers_name: Container.resource_name.pluralize)
         def prepare
           s = load_selection!(self.class)
           id = s["id"]
@@ -89,7 +89,7 @@ module Magellan
           Container.new.show_list(r["result"])
         end
 
-        desc "repair", I18n.t(:repair, scope: [:stage, :cmd], resource_name: resource_name)
+        desc "repair", I18n.t(:repair, scope: [:resources, :stage, :cmd], resource_name: resource_name)
         def repair
           r = call_repair
           puts r["success"] ? "\e[32msucceeded to repair stage\e[0m" : "\e[31mfailed to repair stage\e[0m"
@@ -103,17 +103,17 @@ module Magellan
           end
         end
 
-        desc "update ATTRIBUTES", I18n.t(:update, scope: [:resources_common, :cmd], resource_name: resource_name)
+        desc "update ATTRIBUTES", I18n.t(:update, scope: [:resources, :common, :cmd], resource_name: resource_name)
         def update(attrs)
           s = load_selection!(self.class)
           attrs = JSON.parse(File.readable?(attrs) ? File.read(attrs) : attrs)
           put_json("/admin/stage~title/#{s['id']}/edit", {"stage_title" => attrs})
         end
 
-        desc "release_now", I18n.t(:release_now, scope: [:stage, :cmd])
-        option :A, type: :boolean, default: false, desc: I18n.t(:async, scope: [:stage, :cmd_release_now])
-        option :i, type: :numeric, default: 10, desc: I18n.t(:interval, scope: [:stage, :cmd_release_now])
-        option :t, type: :numeric, default: 600, desc: I18n.t(:timeout, scope: [:stage, :cmd_release_now])
+        desc "release_now", I18n.t(:release_now, scope: [:resources, :stage, :cmd])
+        option :A, type: :boolean, default: false, desc: I18n.t(:async, scope: [:resources, :stage, :cmd_release_now])
+        option :i, type: :numeric, default: 10, desc: I18n.t(:interval, scope: [:resources, :stage, :cmd_release_now])
+        option :t, type: :numeric, default: 600, desc: I18n.t(:timeout, scope: [:resources, :stage, :cmd_release_now])
         def release_now
           spacer = "\r" << (" " * 20)
           stage = load_selection!(self.class)
@@ -166,7 +166,7 @@ module Magellan
           end
         end
 
-        desc "logs", I18n.t(:logs, scope: [:stage, :cmd], workers_name: Worker.resource_name.pluralize)
+        desc "logs", I18n.t(:logs, scope: [:resources, :stage, :cmd], workers_name: Worker.resource_name.pluralize)
         def logs
           s = load_selection!(self.class)
           id = s["id"]
@@ -178,7 +178,7 @@ module Magellan
           end
         end
 
-        desc "set_container_num NUM", I18n.t(:set_container_num, scope: [:stage, :cmd], containers_name: Container.resource_name.pluralize, image_name: Image.resource_name)
+        desc "set_container_num NUM", I18n.t(:set_container_num, scope: [:resources, :stage, :cmd], containers_name: Container.resource_name.pluralize, image_name: Image.resource_name)
         def set_container_num(num)
           s = load_selection!(self.class)
           v = load_selection!(VERSION_PARAMETER_NAME)
@@ -186,7 +186,7 @@ module Magellan
           post_json("/admin/stage~version/#{v["id"]}/set_container_num.json", { container_num: num, container_image_id: i["id"] })
         end
 
-        desc "reload", I18n.t(:reload, scope: [:stage, :cmd])
+        desc "reload", I18n.t(:reload, scope: [:resources, :stage, :cmd])
         def reload
           s = load_selection!(self.class)
           select(s["name"])

data/lib/magellan/cli/resources/team.rb

@@ -10,7 +10,7 @@ module Magellan
         self.resource_dependency = { "organization" =>  Organization.parameter_name }
         self.field_associations = {"organization_id" => {name: "organization", class: "Organization"} }
 
-        desc "create NAME ROLE", I18n.t(:create, scope: [:team, :cmd], resource_name: resource_name)
+        desc "create NAME ROLE", I18n.t(:create, scope: [:resources, :team, :cmd], resource_name: resource_name)
         def create(name, role)
           unless %w{ reader admin }.include?(role)
             raise "ROLE should be 'reader' or 'admin'"
@@ -28,7 +28,7 @@ module Magellan
         end
 
 =begin
-        desc "invite EMAIL", I18n.t(:invite, scope: [:team, :cmd], resource_name: resource_name)
+        desc "invite EMAIL", I18n.t(:invite, scope: [:resources, :team, :cmd], resource_name: resource_name)
         def invite(email)
           o = load_selection!(self.class)
           params = {

data/lib/magellan/cli/resources/transaction_router.rb

@@ -9,7 +9,7 @@ module Magellan
         self.resource_key = "functions~transaction_router"
         self.resource_dependency = {"stage" => Stage.parameter_name}
 
-        desc "create NAME", I18n.t(:create, scope: [:resources_common, :cmd], resource_name: resource_name)
+        desc "create NAME", I18n.t(:create, scope: [:resources, :common, :cmd], resource_name: resource_name)
         def create(name)
           s = load_selection!(Stage::VERSION_PARAMETER_NAME)
           params = {

data/lib/magellan/cli/resources/worker.rb

@@ -14,8 +14,9 @@ module Magellan
         self.multiline_fields = %w[migration_command_1 migration_command_2 run_command environment_vars_yaml].map(&:freeze).freeze
         self.field_associations = {"stage_version_id" => {name: "stage", resource: "stage~version"} }
 
-        desc "create NAME IMAGE", I18n.t(:create, scope: [:worker, :cmd], resource_name: resource_name)
-        method_option :attributes_yaml, aliases: "-A", desc: "path to YAML file which defines attributes"
+        desc "create NAME IMAGE", I18n.t(:create, scope: [:resources, :worker, :cmd], resource_name: resource_name)
+        method_option :attributes_yaml, aliases: "-A", desc: I18n.t(:attributes_yaml, scope: [:resources, :worker, :cmd_create])
+        "path to YAML file which defines attributes"
         def create(name, image_name)
           s = load_selection!(Stage::VERSION_PARAMETER_NAME)
           attrs =
@@ -36,7 +37,7 @@ module Magellan
           select(name)
         end
 
-        desc "update ATTRIBUTES", I18n.t(:update, scope: [:worker, :cmd], resource_name: resource_name)
+        desc "update ATTRIBUTES", I18n.t(:update, scope: [:resources, :worker, :cmd], resource_name: resource_name)
         def update(attrs)
           if File.readable?(attrs)
             attrs = YAML.load_file(attrs)
@@ -52,7 +53,7 @@ module Magellan
           put_json("/admin/#{resource_key}/#{w["id"]}/edit.js", params)
         end
 
-        desc "prepare_images", I18n.t(:prepare_images, scope: [:worker, :cmd], images_name: Image.resource_name.pluralize, worker_name: Worker.resource_name)
+        desc "prepare_images", I18n.t(:prepare_images, scope: [:resources, :worker, :cmd], images_name: Image.resource_name.pluralize, worker_name: Worker.resource_name)
         def prepare_images
           s = load_selection!(Worker)
           id = s["id"]

data/lib/magellan/cli/version.rb

@@ -1,5 +1,5 @@
 module Magellan
   module Cli
-    VERSION = "0.4.4"
+    VERSION = "0.5.0"
   end
 end

data/lib/magellan/cli.rb

@@ -13,6 +13,8 @@ module Magellan
     autoload :Login    , "magellan/cli/login"
     autoload :Ssl      , "magellan/cli/ssl"
 
+    autoload :Messaging, "magellan/cli/messaging"
+
     autoload :Error     , "magellan/cli/errors"
     autoload :LoginError, "magellan/cli/errors"
 

data/magellan-cli.gemspec

@@ -25,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "text-table", "~> 1.2.3"
   spec.add_runtime_dependency "i18n"
   spec.add_runtime_dependency "psych", ">= 2.0.0", "<= 2.0.8"
+  spec.add_runtime_dependency "libmagellan", "~> 0.2.2"
 
   spec.add_development_dependency "bundler", "~> 1.6"
   spec.add_development_dependency "rake", "~> 10.0"

data/reference/en/client_version.md

@@ -0,0 +1,83 @@
+---
+layout: index
+breadcrumb: <a href="/">Top</a> / <a href="/reference">Reference</a> / <a href="/reference/magellan-cli">magellan-cli</a> / client_version
+---
+
+## Commands
+
+- [magellan-cli list](#list)
+- [magellan-cli show [ID]](#show)
+- [magellan-cli select NAME](#select)
+- [magellan-cli deselect](#deselect)
+- [magellan-cli create VERSION](#create)
+- [magellan-cli delete VERSION](#delete)
+- [magellan-cli help [COMMAND]](#help)
+
+## Global Options
+
+```text
+Options:
+  -V, [--verbose]  
+  -D, [--dryrun]   
+  -v, [--version]  
+
+```
+
+
+## Details
+### <a name="list"></a>list
+
+```text
+magellan-cli list
+```
+
+Show a list of the client_versions
+
+### <a name="show"></a>show
+
+```text
+magellan-cli show [ID]
+```
+
+Show the detail of the client_version specified by ID
+
+### <a name="select"></a>select
+
+```text
+magellan-cli select NAME
+```
+
+Select the client_version by NAME
+
+### <a name="deselect"></a>deselect
+
+```text
+magellan-cli deselect
+```
+
+Deselect the client_version
+
+### <a name="create"></a>create
+
+```text
+magellan-cli create VERSION
+```
+
+Create a new client_version with VERSION
+
+### <a name="delete"></a>delete
+
+```text
+magellan-cli delete VERSION
+```
+
+Delete the client_version specified by VERSION
+
+### <a name="help"></a>help
+
+```text
+magellan-cli help [COMMAND]
+```
+
+Describe available commands or one specific command
+

data/reference/en/cloudsql.md

@@ -0,0 +1,93 @@
+---
+layout: index
+breadcrumb: <a href="/">Top</a> / <a href="/reference">Reference</a> / <a href="/reference/magellan-cli">magellan-cli</a> / cloudsql
+---
+
+## Commands
+
+- [magellan-cli list](#list)
+- [magellan-cli show [ID]](#show)
+- [magellan-cli select NAME](#select)
+- [magellan-cli deselect](#deselect)
+- [magellan-cli delete NAME](#delete)
+- [magellan-cli create NAME](#create)
+- [magellan-cli help [COMMAND]](#help)
+
+## Global Options
+
+```text
+Options:
+  -V, [--verbose]  
+  -D, [--dryrun]   
+  -v, [--version]  
+
+```
+
+
+## Details
+### <a name="list"></a>list
+
+```text
+magellan-cli list
+```
+
+Show a list of the cloudsqls
+
+### <a name="show"></a>show
+
+```text
+magellan-cli show [ID]
+```
+
+Show the detail of the cloudsql specified by ID
+
+### <a name="select"></a>select
+
+```text
+magellan-cli select NAME
+```
+
+Select the cloudsql by NAME
+
+### <a name="deselect"></a>deselect
+
+```text
+magellan-cli deselect
+```
+
+Deselect the cloudsql
+
+### <a name="delete"></a>delete
+
+```text
+magellan-cli delete NAME
+```
+
+Delete the cloudsql specified by NAME
+
+### <a name="create"></a>create
+
+```text
+magellan-cli create NAME
+```
+
+```text
+Options:
+  [-A]    # -A async mode. release_now returns soon
+  [-i=N]  # -i polling interval(seconds)
+          # Default: 10
+  [-t=N]  # -t timeout(seconds)
+          # Default: 600
+
+```
+
+Create a new cloudsql database with NAME
+
+### <a name="help"></a>help
+
+```text
+magellan-cli help [COMMAND]
+```
+
+Describe available commands or one specific command
+

data/reference/en/container.md

@@ -0,0 +1,65 @@
+---
+layout: index
+breadcrumb: <a href="/">Top</a> / <a href="/reference">Reference</a> / <a href="/reference/magellan-cli">magellan-cli</a> / container
+---
+
+## Commands
+
+- [magellan-cli list](#list)
+- [magellan-cli show [ID]](#show)
+- [magellan-cli select NAME](#select)
+- [magellan-cli deselect](#deselect)
+- [magellan-cli help [COMMAND]](#help)
+
+## Global Options
+
+```text
+Options:
+  -V, [--verbose]  
+  -D, [--dryrun]   
+  -v, [--version]  
+
+```
+
+
+## Details
+### <a name="list"></a>list
+
+```text
+magellan-cli list
+```
+
+Show a list of the containers
+
+### <a name="show"></a>show
+
+```text
+magellan-cli show [ID]
+```
+
+Show the detail of the container specified by ID
+
+### <a name="select"></a>select
+
+```text
+magellan-cli select NAME
+```
+
+Select the container by NAME
+
+### <a name="deselect"></a>deselect
+
+```text
+magellan-cli deselect
+```
+
+Deselect the container
+
+### <a name="help"></a>help
+
+```text
+magellan-cli help [COMMAND]
+```
+
+Describe available commands or one specific command
+