uffizzi-cli 2.1.4 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cd0af3bb51a08a6c011cf4271fc886586fbb262af3419aeaa02c32aa97dc29d
-  data.tar.gz: 3f588da373233552310f0490d8e0384acdd2cce6598cb3e2dc3d8435ebda2eab
+  metadata.gz: d24e9582d66d329f45ab42194dfefbf1558843fbc94578dfc8b2127f0d7f3122
+  data.tar.gz: fa901b1e7257fc8c9384bcf11c4f41490f767dabbecbf039056aa8b0ed488f38
 SHA512:
-  metadata.gz: 2d821267fb032b76f69cf03a2d0e08318e46b87fc8ac2084550a293dbd18591b16c10a48abf5efd82ffff9288edfda9105e00f6db979eb06424c7f68a80c5b56
-  data.tar.gz: 3981689282eb4c43ce6bdd2281252cef925d609f879d73aeed3754cbf5b39c983d7927394ba81e1127db00ff372cbe6d8dec5ec2e092ccf28dfb9b4ec9e73bfd
+  metadata.gz: cda766f7ab21158e56cfb5e5ea3dabd0416de0fd1d1671c268347465db66ce4a3864f3aa51be04a6fd789848fd6d86cbf2c3e62437aaaf63803f633b5ababc2e
+  data.tar.gz: d6e79d2994cc487a7986315371715e15a85d5d42659a4ea21361ac7e289219441ba6ee5e77468dd5380e1ee5a8b9214fed0a4894bb2b7c4f26353647c3954fcc

data/lib/uffizzi/auth_helper.rb

@@ -16,7 +16,7 @@ module Uffizzi
         Uffizzi::Token.delete if Uffizzi::Token.exists?
       end
 
-      def check_login(project_option)
+      def check_login(project_option = nil)
         raise Uffizzi::Error.new('You are not logged in. Run `uffizzi login`.') unless signed_in?
         raise Uffizzi::Error.new('This command needs project to be set in config file') unless project_set?(project_option)
       end

data/lib/uffizzi/cli/cluster.rb

@@ -22,7 +22,7 @@ module Uffizzi
       run('list')
     end
 
-    desc 'create [NAME]', 'Create a cluster'
+    desc 'create [CLUSTER_NAME]', 'Create a cluster'
     method_option :name, type: :string, required: false, aliases: '-n'
     method_option :kubeconfig, type: :string, required: false, aliases: '-k'
     method_option :manifest, type: :string, required: false, aliases: '-m'
@@ -34,13 +34,13 @@ module Uffizzi
       run('create', { name: name })
     end
 
-    desc 'describe [NAME]', 'Describe a cluster'
+    desc 'describe [CLUSTER_NAME]', 'Describe a cluster'
     method_option :output, required: false, type: :string, aliases: '-o', enum: ['json', 'pretty-json']
     def describe(name)
       run('describe', cluster_name: name)
     end
 
-    desc 'delete [NAME]', 'Delete a cluster'
+    desc 'delete [CLUSTER_NAME]', 'Delete a cluster'
     method_option :'delete-config', required: false, type: :boolean, default: true
     def delete(name)
       run('delete', cluster_name: name)
@@ -61,36 +61,48 @@ module Uffizzi
       run('disconnect')
     end
 
+    desc 'sleep [CLUSTER_NAME]', 'Scales a Uffizzi cluster down to zero resource utilization'
+    def sleep(name = nil)
+      run('sleep', cluster_name: name)
+    end
+
+    desc 'wake [CLUSTER_NAME]', 'Scales up a Uffizzi cluster to its original resource'
+    def wake(name = nil)
+      run('wake', cluster_name: name)
+    end
+
     private
 
     def run(command, command_args = {})
       Uffizzi.ui.output_format = options[:output]
       Uffizzi::AuthHelper.check_login(options[:project])
-      project_slug = options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
 
       case command
       when 'list'
-        handle_list_command(project_slug)
+        handle_list_command
       when 'create'
-        handle_create_command(project_slug, command_args)
+        handle_create_command(command_args)
       when 'describe'
-        handle_describe_command(project_slug, command_args)
+        handle_describe_command(command_args)
       when 'delete'
-        handle_delete_command(project_slug, command_args)
+        handle_delete_command(command_args)
       when 'update-kubeconfig'
-        handle_update_kubeconfig_command(project_slug, command_args)
+        handle_update_kubeconfig_command(command_args)
       when 'disconnect'
         ClusterDisconnectService.handle(options)
+      when 'sleep'
+        handle_sleep_command(project_slug, command_args)
+      when 'wake'
+        handle_wake_command(project_slug, command_args)
       end
     end
 
-    def handle_list_command(project_slug)
+    def handle_list_command
       is_all = options[:all]
       response = if is_all
-        get_account_clusters(ConfigFile.read_option(:server), ConfigFile.read_option(:account, :id))
+        get_account_clusters(server, ConfigFile.read_option(:account, :id))
       else
-        oidc_token = ConfigFile.read_option(:oidc_token)
-        get_project_clusters(ConfigFile.read_option(:server), project_slug, oidc_token: oidc_token)
+        get_project_clusters(server, project_slug, oidc_token: oidc_token)
       end
 
       if ResponseHelper.ok?(response)
@@ -101,7 +113,7 @@ module Uffizzi
     end
 
     # rubocop:disable Metrics/PerceivedComplexity
-    def handle_create_command(project_slug, command_args)
+    def handle_create_command(command_args)
       Uffizzi.ui.disable_stdout if Uffizzi.ui.output_format
 
       if options[:name]
@@ -111,52 +123,51 @@ module Uffizzi
       end
 
       cluster_name = command_args[:name] || options[:name] || ClusterService.generate_name
-      creation_source = options[:"creation-source"] || ClusterService::MANUAL_CREATION_SOURCE
-      k8s_version = options[:"k8s-version"]
       Uffizzi.ui.say_error_and_exit("Cluster name: #{cluster_name} is not valid.") unless ClusterService.valid_name?(cluster_name)
 
-      params = cluster_creation_params(
-        name: cluster_name,
-        creation_source: creation_source,
-        manifest_file_path: options[:manifest],
-        k8s_version: k8s_version,
-      )
-      response = create_cluster(ConfigFile.read_option(:server), project_slug, params)
+      unless ClusterService.valid_name?(cluster_name)
+        Uffizzi.ui.say_error_and_exit("Cluster name: #{cluster_name} is not valid.")
+      end
+
+      params = cluster_creation_params(cluster_name)
+      response = create_cluster(server, project_slug, params)
 
       return ResponseHelper.handle_failed_response(response) unless ResponseHelper.created?(response)
 
       spinner = TTY::Spinner.new("[:spinner] Creating cluster #{cluster_name}...", format: :dots)
       spinner.auto_spin
-      cluster_data = ClusterService.wait_cluster_deploy(project_slug, cluster_name, ConfigFile.read_option(:oidc_token))
+      cluster_data = ClusterService.wait_cluster_deploy(project_slug, cluster_name, oidc_token)
 
       if ClusterService.failed?(cluster_data[:state])
         spinner.error
-        Uffizzi.ui.say_error_and_exit("Cluster with name: #{cluster_name} failed to be created.")
+        Uffizzi.ui.say_error_and_exit("Cluster #{cluster_name} failed to be created.")
       end
 
       spinner.success
       handle_succeed_create_response(cluster_data)
     rescue SystemExit, Interrupt, SocketError
-      handle_interrupt_creation(cluster_name, ConfigFile.read_option(:server), project_slug)
+      handle_interrupt_creation(cluster_name)
     end
     # rubocop:enable Metrics/PerceivedComplexity
 
-    def handle_describe_command(project_slug, command_args)
-      cluster_data = fetch_cluster_data(project_slug, command_args[:cluster_name])
+    def handle_describe_command(command_args)
+      cluster_data = ClusterService.fetch_cluster_data(command_args[:cluster_name], **cluster_api_connection_params)
+      render_data = ClusterService.build_render_data(cluster_data)
 
-      handle_succeed_describe(cluster_data)
+      Uffizzi.ui.output_format = Uffizzi::UI::Shell::PRETTY_LIST
+      Uffizzi.ui.say(render_data)
     end
 
-    def handle_delete_command(project_slug, command_args)
+    def handle_delete_command(command_args)
       cluster_name = command_args[:cluster_name]
       is_delete_kubeconfig = options[:'delete-config']
 
-      return handle_delete_cluster(project_slug, cluster_name) unless is_delete_kubeconfig
+      return handle_delete_cluster(cluster_name) unless is_delete_kubeconfig
 
-      cluster_data = fetch_cluster_data(project_slug, cluster_name)
+      cluster_data = ClusterService.fetch_cluster_data(cluster_name, **cluster_api_connection_params)
       kubeconfig = parse_kubeconfig(cluster_data[:kubeconfig])
 
-      handle_delete_cluster(project_slug, cluster_name)
+      handle_delete_cluster(cluster_name)
       exclude_kubeconfig(cluster_data[:id], kubeconfig) if kubeconfig.present?
     end
 
@@ -180,12 +191,12 @@ module Uffizzi
       end
     end
 
-    def handle_delete_cluster(project_slug, cluster_name)
+    def handle_delete_cluster(cluster_name)
       params = {
         cluster_name: cluster_name,
-        oidc_token: ConfigFile.read_option(:oidc_token),
+        oidc_token: oidc_token,
       }
-      response = delete_cluster(ConfigFile.read_option(:server), project_slug, params)
+      response = delete_cluster(server, project_slug, params)
 
       if ResponseHelper.no_content?(response)
         Uffizzi.ui.say("Cluster #{cluster_name} deleted")
@@ -194,9 +205,10 @@ module Uffizzi
       end
     end
 
-    def handle_update_kubeconfig_command(project_slug, command_args)
+    def handle_update_kubeconfig_command(command_args)
       kubeconfig_path = options[:kubeconfig] || KubeconfigService.default_path
-      cluster_data = fetch_cluster_data(project_slug, command_args[:cluster_name])
+      cluster_name = command_args[:cluster_name]
+      cluster_data = ClusterService.fetch_cluster_data(cluster_name, **cluster_api_connection_params)
 
       unless cluster_data[:kubeconfig].present?
         say_error_update_kubeconfig(cluster_data)
@@ -218,13 +230,48 @@ module Uffizzi
         new_kubeconfig
       end
 
-      update_clusters_config(cluster_data[:id], kubeconfig_path: kubeconfig_path)
+      update_clusters_config(cluster_data[:id], name: cluster_name, kubeconfig_path: kubeconfig_path)
 
       return if options[:quiet]
 
       Uffizzi.ui.say("Kubeconfig was updated by the path: #{kubeconfig_path}")
     end
 
+    def handle_sleep_command(project_slug, command_args)
+      cluster_name = command_args[:cluster_name] || ConfigFile.read_option(:current_cluster)&.fetch(:name)
+      return handle_missing_cluster_name_error if cluster_name.nil?
+
+      response = scale_down_cluster(ConfigFile.read_option(:server), project_slug, cluster_name)
+      return ResponseHelper.handle_failed_response(response) unless ResponseHelper.ok?(response)
+
+      spinner = TTY::Spinner.new("[:spinner] Scaling down cluster #{cluster_name}...", format: :dots)
+      spinner.auto_spin
+      ClusterService.wait_cluster_scale_down(project_slug, cluster_name)
+
+      spinner.success
+      Uffizzi.ui.say("Cluster #{cluster_name} was successfully scaled down")
+    end
+
+    def handle_wake_command(project_slug, command_args)
+      cluster_name = command_args[:cluster_name] || ConfigFile.read_option(:current_cluster)&.fetch(:name)
+      return handle_missing_cluster_name_error if cluster_name.nil?
+
+      response = scale_up_cluster(ConfigFile.read_option(:server), project_slug, cluster_name)
+      return ResponseHelper.handle_failed_response(response) unless ResponseHelper.ok?(response)
+
+      spinner = TTY::Spinner.new("[:spinner] Waking up cluster #{cluster_name}...", format: :dots)
+      spinner.auto_spin
+      cluster_data = ClusterService.wait_cluster_scale_up(project_slug, cluster_name)
+
+      if ClusterService.failed_scaling_up?(cluster_data[:state])
+        spinner.error
+        Uffizzi.ui.say_error_and_exit("Failed to wake up cluster #{cluster_name}.")
+      end
+
+      spinner.success
+      Uffizzi.ui.say("Cluster #{cluster_name} was successfully scaled up")
+    end
+
     def say_error_update_kubeconfig(cluster_data)
       if ClusterService.failed?(cluster_data[:state])
         Uffizzi.ui.say_error_and_exit('Kubeconfig is empty because cluster failed to be created.')
@@ -239,13 +286,15 @@ module Uffizzi
       end
     end
 
-    def cluster_creation_params(name:, creation_source:, manifest_file_path:, k8s_version:)
+    def cluster_creation_params(cluster_name)
+      creation_source = options[:"creation-source"] || ClusterService::MANUAL_CREATION_SOURCE
+      manifest_file_path = options[:manifest]
+      k8s_version = options[:"k8s-version"]
       manifest_content = load_manifest_file(manifest_file_path)
-      oidc_token = Uffizzi::ConfigFile.read_option(:oidc_token)
 
       {
         cluster: {
-          name: name,
+          name: cluster_name,
           manifest: manifest_content,
           creation_source: creation_source,
           k8s_version: k8s_version,
@@ -262,7 +311,7 @@ module Uffizzi
       raise Uffizzi::Error.new(e.message)
     end
 
-    def handle_interrupt_creation(cluster_name, server, project_slug)
+    def handle_interrupt_creation(cluster_name)
       deletion_response = delete_cluster(server, project_slug, cluster_name: cluster_name)
       deletion_message = if ResponseHelper.no_content?(deletion_response)
         "The cluster #{cluster_name} has been disabled."
@@ -298,29 +347,12 @@ module Uffizzi
       end.join("\n")
     end
 
-    def handle_succeed_describe(cluster_data)
-      prepared_cluster_data = {
-        name: cluster_data[:name],
-        status: cluster_data[:state],
-        created: Time.strptime(cluster_data[:created_at], '%Y-%m-%dT%H:%M:%S.%N').strftime('%a %b %d %H:%M:%S %Y'),
-        url: cluster_data[:host],
-        k8s_version: cluster_data[:k8s_version],
-      }
-
-      rendered_cluster_data = if Uffizzi.ui.output_format.nil?
-        prepared_cluster_data.map { |k, v| "- #{k.to_s.upcase}: #{v}" }.join("\n").strip
-      else
-        prepared_cluster_data
-      end
-
-      Uffizzi.ui.say(rendered_cluster_data)
-    end
-
     def handle_succeed_create_response(cluster_data)
       kubeconfig_path = options[:kubeconfig] || KubeconfigService.default_path
       is_update_current_context = options[:'update-current-context']
       parsed_kubeconfig = parse_kubeconfig(cluster_data[:kubeconfig])
       rendered_cluster_data = render_cluster_data(cluster_data)
+      cluster_name = cluster_data[:name]
 
       Uffizzi.ui.enable_stdout
       Uffizzi.ui.say("Cluster with name: #{rendered_cluster_data[:name]} was created.")
@@ -332,7 +364,7 @@ module Uffizzi
       Uffizzi.ui.say(rendered_cluster_data) if Uffizzi.ui.output_format
 
       save_kubeconfig(parsed_kubeconfig, kubeconfig_path)
-      update_clusters_config(cluster_data[:id], kubeconfig_path: kubeconfig_path)
+      update_clusters_config(cluster_data[:id], name: cluster_name, kubeconfig_path: kubeconfig_path)
       GithubService.write_to_github_env(rendered_cluster_data) if GithubService.github_actions_exists?
     end
 
@@ -362,6 +394,7 @@ module Uffizzi
     def update_clusters_config(id, params)
       clusters_config = Uffizzi::ConfigHelper.update_clusters_config_by_id(id, params)
       ConfigFile.write_option(:clusters, clusters_config)
+      ConfigFile.write_option(:current_cluster, ConfigHelper.cluster_config_by_id(id))
     end
 
     def render_cluster_data(cluster_data)
@@ -380,25 +413,37 @@ module Uffizzi
       Psych.safe_load(Base64.decode64(kubeconfig))
     end
 
-    def fetch_cluster_data(project_slug, cluster_name)
-      params = {
-        cluster_name: cluster_name,
-        oidc_token: ConfigFile.read_option(:oidc_token),
-      }
-      response = get_cluster(ConfigFile.read_option(:server), project_slug, params)
-
-      if ResponseHelper.ok?(response)
-        response.dig(:body, :cluster)
-      else
-        ResponseHelper.handle_failed_response(response)
-      end
-    end
-
     def save_previous_current_context(kubeconfig_path, current_context)
       return if kubeconfig_path.nil? || ConfigHelper.previous_current_context_by_path(kubeconfig_path).present?
 
       previous_current_contexts = Uffizzi::ConfigHelper.set_previous_current_context_by_path(kubeconfig_path, current_context)
       ConfigFile.write_option(:previous_current_contexts, previous_current_contexts)
     end
+
+    def handle_missing_cluster_name_error
+      Uffizzi.ui.say("No kubeconfig found at #{KubeconfigService.default_path}")
+      Uffizzi.ui.say('Please update the current context or provide a cluster name.')
+      Uffizzi.ui.say('$uffizzi cluster sleep my-cluster')
+    end
+
+    def cluster_api_connection_params
+      {
+        server: server,
+        project_slug: project_slug,
+        oidc_token: oidc_token,
+      }
+    end
+
+    def oidc_token
+      @oidc_token ||= ConfigFile.read_option(:oidc_token)
+    end
+
+    def project_slug
+      @project_slug ||= options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
+    end
+
+    def server
+      @server ||= ConfigFile.read_option(:server)
+    end
   end
 end

data/lib/uffizzi/cli/dev.rb

@@ -15,77 +15,121 @@ module Uffizzi
     method_option :kubeconfig, type: :string
     method_option :'k8s-version', required: false, type: :string
     def start(config_path = 'skaffold.yaml')
-      Uffizzi::AuthHelper.check_login(options[:project])
+      run('start', config_path: config_path)
+    end
+
+    desc 'stop', 'Stop dev environment'
+    def stop
+      run('stop')
+    end
+
+    desc 'describe', 'Describe dev environment'
+    def describe
+      run('describe')
+    end
+
+    desc 'delete', 'Delete dev environment'
+    def delete
+      run('delete')
+    end
+
+    private
+
+    def run(command, command_args = {})
+      Uffizzi::AuthHelper.check_login
+
+      case command
+      when 'start'
+        handle_start_command(command_args)
+      when 'stop'
+        handle_stop_command
+      when 'describe'
+        handle_describe_command
+      when 'delete'
+        handle_delete_command
+      end
+    end
+
+    def handle_start_command(command_args)
+      config_path = command_args[:config_path]
       DevService.check_skaffold_existence
-      DevService.check_running_daemon if options[:quiet]
+      DevService.check_no_running_process!
       DevService.check_skaffold_config_existence(config_path)
-      cluster_id, cluster_name = start_create_cluster
-      kubeconfig = wait_cluster_creation(cluster_name)
+
+      if dev_environment.empty?
+        DevService.set_startup_state
+        cluster_name = start_create_cluster
+        wait_cluster_creation(cluster_name)
+        DevService.set_dev_environment_config(cluster_name, config_path, options)
+        DevService.set_cluster_deployed_state
+      end
 
       if options[:quiet]
         launch_demonise_skaffold(config_path)
       else
-        DevService.start_basic_skaffold(config_path, options)
-      end
-    ensure
-      if defined?(cluster_name).present? && defined?(cluster_id).present?
-        kubeconfig = defined?(kubeconfig).present? ? kubeconfig : nil
-        handle_delete_cluster(cluster_id, cluster_name, kubeconfig)
+        launch_basic_skaffold(config_path)
       end
     end
 
-    desc 'stop', 'Stop dev environment'
-    def stop
-      return Uffizzi.ui.say('Uffizzi dev is not running') unless File.exist?(DevService.pid_path)
+    def handle_stop_command
+      DevService.check_running_process!
+      DevService.stop_process
+      Uffizzi.ui.say('Uffizzi dev was stopped')
+    end
 
-      pid = File.read(DevService.pid_path).to_i
-      File.delete(DevService.pid_path)
+    def handle_describe_command
+      DevService.check_environment_exist!
 
-      Uffizzi.process.kill('QUIT', pid)
-      Uffizzi.ui.say('Uffizzi dev was stopped')
-    rescue Errno::ESRCH
-      Uffizzi.ui.say('Uffizzi dev is not running')
-      File.delete(DevService.pid_path)
+      cluster_data = fetch_dev_env_cluster!
+      cluster_render_data = ClusterService.build_render_data(cluster_data)
+      dev_environment_render_data = cluster_render_data.merge(config_path: dev_environment[:config_path])
+
+      Uffizzi.ui.output_format = Uffizzi::UI::Shell::PRETTY_LIST
+      Uffizzi.ui.say(dev_environment_render_data)
     end
 
-    private
+    def handle_delete_command
+      DevService.check_environment_exist!
+
+      if DevService.process_running?
+        DevService.stop_process
+        Uffizzi.ui.say('Uffizzi dev was stopped')
+      end
+
+      cluster_data = fetch_dev_env_cluster!
+      handle_delete_cluster(cluster_data)
+      DevService.clear_dev_environment_config
+    end
 
     def start_create_cluster
-      params = cluster_creation_params(
-        name: ClusterService.generate_name,
-        creation_source: ClusterService::MANUAL_CREATION_SOURCE,
-        k8s_version: options[:"k8s-version"],
-      )
+      params = cluster_creation_params
       Uffizzi.ui.say('Start creating a cluster')
-      response = create_cluster(ConfigFile.read_option(:server), project_slug, params)
+      response = create_cluster(server, project_slug, params)
       return ResponseHelper.handle_failed_response(response) unless ResponseHelper.created?(response)
 
-      cluster_id = response.dig(:body, :cluster, :id)
-      cluster_name = response.dig(:body, :cluster, :name)
-
-      [cluster_id, cluster_name]
+      response.dig(:body, :cluster, :name)
     end
 
     def wait_cluster_creation(cluster_name)
       Uffizzi.ui.say('Checking the cluster status...')
-      cluster_data = ClusterService.wait_cluster_deploy(project_slug, cluster_name, ConfigFile.read_option(:oidc_token))
+      cluster_data = ClusterService.wait_cluster_deploy(project_slug, cluster_name, oidc_token)
 
       if ClusterService.failed?(cluster_data[:state])
         Uffizzi.ui.say_error_and_exit("Cluster with name: #{cluster_name} failed to be created.")
       end
 
       handle_succeed_cluster_creation(cluster_data)
-      parse_kubeconfig(cluster_data[:kubeconfig])
     end
 
     def handle_succeed_cluster_creation(cluster_data)
       kubeconfig_path = options[:kubeconfig] || KubeconfigService.default_path
       parsed_kubeconfig = parse_kubeconfig(cluster_data[:kubeconfig])
+      cluster_name = cluster_data[:name]
 
-      Uffizzi.ui.say("Cluster with name: #{cluster_data[:name]} was created.")
+      Uffizzi.ui.say("Cluster with name: #{cluster_name} was created.")
 
       save_kubeconfig(parsed_kubeconfig, kubeconfig_path)
-      update_clusters_config(cluster_data[:id], kubeconfig_path: kubeconfig_path)
+      update_clusters_config(cluster_data[:id], name: cluster_name, kubeconfig_path: kubeconfig_path)
     end
 
     def save_kubeconfig(kubeconfig, kubeconfig_path)
@@ -108,30 +152,30 @@ module Uffizzi
       ConfigFile.write_option(:clusters, clusters_config)
     end
 
-    def cluster_creation_params(name:, creation_source:, k8s_version:)
-      oidc_token = Uffizzi::ConfigFile.read_option(:oidc_token)
-
+    def cluster_creation_params
       {
         cluster: {
-          name: name,
+          name: ClusterService.generate_name,
           manifest: nil,
-          creation_source: creation_source,
-          k8s_version: k8s_version,
+          creation_source: ClusterService::MANUAL_CREATION_SOURCE,
+          k8s_version: options[:"k8s-version"],
         },
         token: oidc_token,
       }
     end
 
-    def handle_delete_cluster(cluster_id, cluster_name, kubeconfig)
-      return if cluster_id.nil? || cluster_name.nil?
+    def handle_delete_cluster(cluster_data)
+      cluster_id = cluster_data[:id]
+      cluster_name = cluster_data[:name]
+      kubeconfig = parse_kubeconfig(cluster_data[:kubeconfig])
 
       exclude_kubeconfig(cluster_id, kubeconfig) if kubeconfig.present?
 
       params = {
         cluster_name: cluster_name,
-        oidc_token: ConfigFile.read_option(:oidc_token),
+        oidc_token: oidc_token,
       }
-      response = delete_cluster(ConfigFile.read_option(:server), project_slug, params)
+      response = delete_cluster(server, project_slug, params)
 
       if ResponseHelper.no_content?(response)
         Uffizzi.ui.say("Cluster #{cluster_name} deleted")
@@ -179,19 +223,58 @@ module Uffizzi
       Uffizzi.process.daemon(true)
 
       at_exit do
-        File.delete(DevService.pid_path) if File.exist?(DevService.pid_path)
+        DevService.delete_pid
       end
 
+      DevService.save_pid
       File.delete(DevService.logs_path) if File.exist?(DevService.logs_path)
-      File.write(DevService.pid_path, Uffizzi.process.pid)
       DevService.start_check_pid_file_existence
       DevService.start_demonised_skaffold(config_path, options)
     rescue StandardError => e
       File.open(DevService.logs_path, 'a') { |f| f.puts(e.message) }
     end
 
+    def launch_basic_skaffold(config_path)
+      at_exit do
+        DevService.delete_pid
+      end
+
+      DevService.save_pid
+      DevService.start_check_pid_file_existence
+      DevService.start_basic_skaffold(config_path, options)
+    end
+
+    def fetch_dev_env_cluster!
+      if DevService.startup?
+        Uffizzi.ui.say_error_and_exit('Dev environment not started yet')
+      end
+
+      cluster_name = dev_environment[:cluster_name]
+      ClusterService.fetch_cluster_data(cluster_name, **cluster_api_connection_params)
+    end
+
+    def dev_environment
+      @dev_environment ||= DevService.dev_environment
+    end
+
+    def cluster_api_connection_params
+      {
+        server: server,
+        project_slug: project_slug,
+        oidc_token: oidc_token,
+      }
+    end
+
     def project_slug
       @project_slug ||= ConfigFile.read_option(:project)
     end
+
+    def oidc_token
+      @oidc_token ||= ConfigFile.read_option(:oidc_token)
+    end
+
+    def server
+      @server ||= ConfigFile.read_option(:server)
+    end
   end
 end

data/lib/uffizzi/clients/api/api_client.rb

@@ -262,6 +262,20 @@ module ApiClient
     build_response(response)
   end
 
+  def scale_down_cluster(server, project_slug, cluster_name)
+    uri = scale_down_cluster_uri(server, project_slug, cluster_name)
+    response = http_client.make_put_request(uri)
+
+    build_response(response)
+  end
+
+  def scale_up_cluster(server, project_slug, cluster_name)
+    uri = scale_up_cluster_uri(server, project_slug, cluster_name)
+    response = http_client.make_put_request(uri)
+
+    build_response(response)
+  end
+
   def create_access_token(server, session_id)
     uri = access_tokens_url(server)
 

data/lib/uffizzi/clients/api/api_routes.rb

@@ -110,6 +110,14 @@ module ApiRoutes
     "#{server}/api/cli/v1/projects/#{project_slug}/clusters/#{cluster_name}?token=#{oidc_token}"
   end
 
+  def scale_up_cluster_uri(server, project_slug, cluster_name)
+    "#{server}/api/cli/v1/projects/#{project_slug}/clusters/#{cluster_name}/scale_up"
+  end
+
+  def scale_down_cluster_uri(server, project_slug, cluster_name)
+    "#{server}/api/cli/v1/projects/#{project_slug}/clusters/#{cluster_name}/scale_down"
+  end
+
   def access_token_url(server, code)
     "#{server}/api/cli/v1/access_tokens/#{code}"
   end

data/lib/uffizzi/helpers/config_helper.rb

@@ -2,7 +2,7 @@
 
 module Uffizzi
   module ConfigHelper
-    CLUSTER_PARAMS = [:kubeconfig_path].freeze
+    CLUSTER_PARAMS = [:kubeconfig_path, :name].freeze
 
     class ConfigParamsError < StandardError
       def initialize(unavailable_params, key)
@@ -52,6 +52,14 @@ module Uffizzi
         cluster_previous_current_contexts.detect { |c| c[:kubeconfig_path] == path }
       end
 
+      def set_dev_environment(cluster_name, params = {})
+        { cluster_name: cluster_name }.merge(params)
+      end
+
+      def dev_environment
+        read_option_from_config(:dev_environment) || {}
+      end
+
       private
 
       def clusters

data/lib/uffizzi/services/cluster_service.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
+require 'uffizzi/response_helper'
 require 'uffizzi/clients/api/api_client'
 
 class ClusterService
   CLUSTER_STATE_DEPLOYING_NAMESPACE = 'deploying_namespace'
   CLUSTER_STATE_DEPLOYING = 'deploying'
   CLUSTER_STATE_DEPLOYED = 'deployed'
+  CLUSTER_STATE_SCALING_DOWN = 'scaling_down'
+  CLUSTER_STATE_SCALING_UP = 'scaling_up'
+  CLUSTER_FAILED_SCALING_UP = 'failed_scaling_up'
   CLUSTER_STATE_FAILED_DEPLOY_NAMESPACE = 'failed_deploy_namespace'
   CLUSTER_STATE_FAILED = 'failed'
   CLUSTER_NAME_MAX_LENGTH = 15
@@ -26,6 +30,18 @@ class ClusterService
       [CLUSTER_STATE_FAILED_DEPLOY_NAMESPACE, CLUSTER_STATE_FAILED].include?(cluster_state)
     end
 
+    def scaling_up?(cluster_state)
+      cluster_state === CLUSTER_STATE_SCALING_UP
+    end
+
+    def scaling_down?(cluster_state)
+      cluster_state === CLUSTER_STATE_SCALING_DOWN
+    end
+
+    def failed_scaling_up?(cluster_state)
+      cluster_state === CLUSTER_FAILED_SCALING_UP
+    end
+
     def wait_cluster_deploy(project_slug, cluster_name, oidc_token)
       loop do
         params = {
@@ -43,6 +59,38 @@ class ClusterService
       end
     end
 
+    def wait_cluster_scale_up(project_slug, cluster_name)
+      loop do
+        params = {
+          cluster_name: cluster_name,
+        }
+        response = get_cluster(Uffizzi::ConfigFile.read_option(:server), project_slug, params)
+        return Uffizzi::ResponseHelper.handle_failed_response(response) unless Uffizzi::ResponseHelper.ok?(response)
+
+        cluster_data = response.dig(:body, :cluster)
+
+        return cluster_data unless scaling_up?(cluster_data[:state])
+
+        sleep(5)
+      end
+    end
+
+    def wait_cluster_scale_down(project_slug, cluster_name)
+      loop do
+        params = {
+          cluster_name: cluster_name,
+        }
+        response = get_cluster(Uffizzi::ConfigFile.read_option(:server), project_slug, params)
+        return Uffizzi::ResponseHelper.handle_failed_response(response) unless Uffizzi::ResponseHelper.ok?(response)
+
+        cluster_data = response.dig(:body, :cluster)
+
+        return unless scaling_down?(cluster_data[:state])
+
+        sleep(3)
+      end
+    end
+
     def generate_name
       name = Faker::Internet.domain_word[0..CLUSTER_NAME_MAX_LENGTH]
 
@@ -57,5 +105,28 @@ class ClusterService
       regex = /\A[a-zA-Z0-9-]*\z/
       regex.match?(name)
     end
+
+    def fetch_cluster_data(cluster_name, server:, project_slug:, oidc_token:)
+      params = {
+        cluster_name: cluster_name,
+        oidc_token: oidc_token,
+      }
+      response = get_cluster(server, project_slug, params)
+
+      if Uffizzi::ResponseHelper.ok?(response)
+        response.dig(:body, :cluster)
+      else
+        Uffizzi::ResponseHelper.handle_failed_response(response)
+      end
+    end
+
+    def build_render_data(cluster_data)
+      {
+        name: cluster_data[:name],
+        status: cluster_data[:state],
+        created: Time.strptime(cluster_data[:created_at], '%Y-%m-%dT%H:%M:%S.%N').strftime('%a %b %d %H:%M:%S %Y'),
+        url: cluster_data[:host],
+      }
+    end
   end
 end

data/lib/uffizzi/services/dev_service.rb

@@ -3,21 +3,50 @@
 require 'uffizzi/clients/api/api_client'
 
 class DevService
+  DEFAULT_REGISTRY_REPO = 'registry.uffizzi.com'
+  STARTUP_STATE = 'startup'
+  CLUSTER_DEPLOYED_STATE = 'cluster_deployed'
+
   class << self
     include ApiClient
 
-    DEFAULT_REGISTRY_REPO = 'registry.uffizzi.com'
+    def check_no_running_process!
+      if process_running?
+        Uffizzi.ui.say_error_and_exit("You have already started uffizzi dev. To stop the process do 'uffizzi dev stop'")
+      end
+    end
 
-    def check_running_daemon
-      return unless File.exist?(pid_path)
+    def check_running_process!
+      unless process_running?
+        Uffizzi.ui.say_error_and_exit('Uffizzi dev is not running')
+      end
+    end
 
-      pid = File.read(pid_path)
-      File.delete(pid_path) if pid.blank?
-      Uffizzi.process.kill(0, pid.to_i)
+    def check_environment_exist!
+      if dev_environment.empty?
+        Uffizzi.ui.say_error_and_exit('Uffizzi dev does not exist')
+      end
+    end
+
+    def stop_process
+      dev_pid = running_pid
+      skaffold_pid = running_skaffold_pid
+
+      Uffizzi.process.kill('INT', skaffold_pid)
+      Uffizzi.process.kill('INT', dev_pid)
+      delete_pid
+    rescue Errno::ESRCH
+      delete_pid
+    end
+
+    def process_running?
+      pid = running_pid
+      return false unless pid.positive?
 
-      Uffizzi.ui.say_error_and_exit("You have already started uffizzi dev as daemon. To stop the process do 'uffizzi dev stop'")
+      Uffizzi.process.kill(0, pid.to_i)
+      true
     rescue Errno::ESRCH
-      File.delete(pid_path)
+      false
     end
 
     def start_check_pid_file_existence
@@ -34,6 +63,9 @@ class DevService
       cmd = build_skaffold_dev_command(config_path, options)
 
       Uffizzi.ui.popen2e(cmd) do |_stdin, stdout_and_stderr, wait_thr|
+        pid = wait_thr.pid
+        skaffold_pid = find_skaffold_pid(pid)
+        save_skaffold_pid(skaffold_pid)
         stdout_and_stderr.each { |l| Uffizzi.ui.say(l) }
         wait_thr.value
       end
@@ -44,6 +76,10 @@ class DevService
       cmd = build_skaffold_dev_command(config_path, options)
 
       Uffizzi.ui.popen2e(cmd) do |_stdin, stdout_and_stderr, wait_thr|
+        pid = wait_thr.pid
+        skaffold_pid = find_skaffold_pid(pid)
+        save_skaffold_pid(skaffold_pid)
+
         File.open(logs_path, 'a') do |f|
           stdout_and_stderr.each do |line|
             f.puts(line)
@@ -80,6 +116,10 @@ class DevService
       File.join(Uffizzi::ConfigFile::CONFIG_DIR, 'uffizzi_dev.pid')
     end
 
+    def skaffold_pid_path
+      File.join(Uffizzi::ConfigFile::CONFIG_DIR, 'skaffold_dev.pid')
+    end
+
     def logs_path
       File.join(Uffizzi::ConfigFile::CONFIG_DIR, 'uffizzi_dev.log')
     end
@@ -104,5 +144,67 @@ class DevService
 
       File.expand_path(path)
     end
+
+    def running_pid
+      return nil.to_i unless File.exist?(pid_path)
+
+      File.read(pid_path).to_i
+    end
+
+    def save_pid
+      File.write(pid_path, Uffizzi.process.pid)
+    end
+
+    def delete_pid
+      File.delete(pid_path) if File.exist?(pid_path)
+      File.delete(skaffold_pid_path) if File.exist?(skaffold_pid_path)
+    end
+
+    def running_skaffold_pid
+      return nil.to_i unless File.exist?(skaffold_pid_path)
+
+      File.read(skaffold_pid_path).to_i
+    end
+
+    def save_skaffold_pid(pid)
+      File.write(skaffold_pid_path, pid)
+    end
+
+    def set_dev_environment_config(cluster_name, config_path, options)
+      params = options.merge(config_path: File.expand_path(config_path))
+      new_dev_environment = Uffizzi::ConfigHelper.set_dev_environment(cluster_name, params)
+      Uffizzi::ConfigFile.write_option(:dev_environment, new_dev_environment)
+    end
+
+    def set_startup_state
+      new_dev_environment = dev_environment.merge(state: STARTUP_STATE)
+      Uffizzi::ConfigFile.write_option(:dev_environment, new_dev_environment)
+    end
+
+    def set_cluster_deployed_state
+      new_dev_environment = dev_environment.merge(state: CLUSTER_DEPLOYED_STATE)
+      Uffizzi::ConfigFile.write_option(:dev_environment, new_dev_environment)
+    end
+
+    def startup?
+      dev_environment[:state] == STARTUP_STATE
+    end
+
+    def clear_dev_environment_config
+      Uffizzi::ConfigFile.write_option(:dev_environment, {})
+    end
+
+    def dev_environment
+      Uffizzi::ConfigHelper.dev_environment
+    end
+
+    def find_skaffold_pid(ppid)
+      ppid_regex = /\w*\s+\d+\s+#{ppid}.*\sskaffold dev/
+      pid_regex = /\w*\s+(\d+)\s+#{ppid}.*\sskaffold dev/
+
+      io = Uffizzi.ui.popen('ps -ef')
+      ps = io.readlines.detect { |l| l.match?(ppid_regex) }
+      ps.match(pid_regex)[1]
+    end
   end
 end

data/lib/uffizzi/shell.rb

@@ -11,6 +11,7 @@ module Uffizzi
 
       PRETTY_JSON = 'pretty-json'
       REGULAR_JSON = 'json'
+      PRETTY_LIST = 'pretty-list'
 
       def initialize
         @shell = Thor::Shell::Basic.new
@@ -55,6 +56,10 @@ module Uffizzi
         $stdout.stat.pipe?
       end
 
+      def popen(command)
+        IO.popen(command)
+      end
+
       def popen2e(command, &block)
         Open3.popen2e(command, &block)
       end
@@ -73,12 +78,25 @@ module Uffizzi
         JSON.pretty_generate(data)
       end
 
+      def format_to_pretty_list(data)
+        case data
+        when Array
+          data.map { |v| format_to_pretty_list(v) }.join("\n\n")
+        when Hash
+          data.map { |k, v| "- #{k.to_s.upcase}: #{v}" }.join("\n").strip
+        else
+          data
+        end
+      end
+
       def format_message(message)
         case output_format
         when PRETTY_JSON
           format_to_pretty_json(message)
         when REGULAR_JSON
           format_to_json(message)
+        when PRETTY_LIST
+          format_to_pretty_list(message)
         else
           message
         end

data/lib/uffizzi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Uffizzi
-  VERSION = '2.1.4'
+  VERSION = '2.2.1'
 end

data/man/uffizzi

@@ -1,6 +1,6 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "UFFIZZI" "" "September 2023" ""
+.TH "UFFIZZI" "" "October 2023" ""
 .SH "NAME"
 \fBuffizzi\fR \- manage Uffizzi resources
 .SH "SYNOPSIS"
@@ -33,6 +33,9 @@ GROUP is one of the following:
  project
      Manage Uffizzi project resources including compose files for
      specifying compose environment (preview) configurations and secrets
+
+ dev
+     Creates a Uffizzi cluster preconfigured for development workflows
 .fi
 .SH "COMMAND"
 .nf

data/man/uffizzi-cluster-sleep.ronn

@@ -0,0 +1,30 @@
+$ uffizzi cluster sleep -h
+uffizzi-cluster-sleep - put a cluster to sleep (non-destructive)
+================================================================
+
+## SYNOPSIS
+    uffizzi cluster sleep [CLUSTER_NAME]
+
+## DESCRIPTION
+    Scales a Uffizzi cluster down to zero resource utilization 
+    while keeping the namespace and any stateful resources,
+    like persistent volume claims. If no CLUSTER_NAME is 
+    specified, the kubeconfig current context is used.
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## OPTIONS
+    CLUSTER_NAME
+    The name of the target Uffizzi cluster
+
+## EXAMPLES
+    To put the Uffizzi cluster in the current context to 
+    sleep, run:
+
+        $ uffizzi cluster sleep
+
+    To put a Uffizzi cluster outside the current context to 
+    sleep, run:
+
+        $ uffizzi cluster sleep my-cluster

data/man/uffizzi-cluster-wake.ronn

@@ -0,0 +1,28 @@
+$ uffizzi cluster wake -h
+uffizzi-cluster-wake - wake a cluster that is sleeping
+================================================================
+
+## SYNOPSIS
+    uffizzi cluster wake [CLUSTER_NAME]
+
+## DESCRIPTION
+    Scales up a Uffizzi cluster to its original resource 
+    utilization from zero (see 'uffizzi cluster sleep -h'). 
+    If no CLUSTER_NAME is specified, the kubeconfig current 
+    context is used.
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## OPTIONS
+    CLUSTER_NAME
+    The name of the target Uffizzi cluster
+
+## EXAMPLES
+    To wake the Uffizzi cluster in the current context, run:
+
+        $ uffizzi cluster wake
+
+    To wake a Uffizzi cluster outside the current context, run:
+
+        $ uffizzi cluster wake my-cluster

data/man/uffizzi-cluster.ronn

@@ -25,6 +25,12 @@ uffizzi-cluster - manage clusters
      list
         List all clusters
 
+     sleep
+        Put a cluster to sleep (non-destructive)
+
+     wake
+        Wake a cluster that is sleeping
+
      update-kubeconfig
         Update kubeconfig file
 

data/man/uffizzi-dev

@@ -0,0 +1,51 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-DEV" "" "October 2023" ""
+.SH "NAME"
+\fBuffizzi\-dev\fR \- manage dev environments
+.SH "SYNOPSIS"
+.nf
+uffizzi dev COMMAND
+.fi
+.SH "DESCRIPTION"
+.nf
+Manage Uffizzi development environments\.
+
+Use these commands for building, pushing, and deploying your
+project changes to a remote development cluster\. Cloud\-based
+dev environments offer many benefits compared to traditional
+local development, including:
+  \- More similar to production deployments
+  \- Access to more memory and CPU for resource\-intensive
+    apps
+  \- Scalability and flexibility for microservices apps
+  \- Faster build times
+  \- Avoid accumulation of build artifacts on local machine
+  \- App components available at public URLs or IP addresses
+  \- TLS certificates for HTTPS
+  \- Better team collaboration via shareable links
+
+For more information on Uffizzi clusters, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "COMMANDS"
+.nf
+COMMAND is one of the following:
+
+ start
+    Start a dev environment
+
+ stop
+    Stop a dev environment
+
+ describe
+    Display details of a dev environment
+
+ ingress
+    Display ingress hosts
+.fi
+.SH "HELP"
+.nf
+Run \'uffizzi dev COMMAND \-\-help\' for more information on a command\.
+.fi
+

data/man/uffizzi-dev-describe

@@ -0,0 +1,36 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-DEV\-DESCRIBE" "" "October 2023" ""
+.SH "NAME"
+\fBuffizzi\-dev\-describe\fR
+.P
+$ uffizzi dev describe \-h uffizzi\-dev\-describe \- show metadata for a dev environment ================================================================
+.SH "SYNOPSIS"
+.nf
+uffizzi dev describe <NAME>
+.fi
+.SH "DESCRIPTION"
+.nf
+Shows metadata for a dev environment
+
+This command can fail for the following reasons:
+    \- The dev environment specified does not exist\.
+    \- The dev environment specified belongs to a different project\.
+
+For more information on Uffizzi clusters, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[NAME]
+    NAME for the dev environment you want to describe\.
+    This is an optional argument\.
+.fi
+.SH "EXAMPLES"
+.nf
+The following command prints metadata for the dev
+environment:
+
+    $ uffizzi dev describe
+.fi
+

data/man/uffizzi-dev-describe.ronn

@@ -0,0 +1,27 @@
+$ uffizzi dev describe -h
+uffizzi-dev-describe - show metadata for a dev environment
+================================================================
+
+## SYNOPSIS
+    uffizzi dev describe <NAME>
+
+## DESCRIPTION
+    Shows metadata for a dev environment
+
+    This command can fail for the following reasons:
+        - The dev environment specified does not exist.
+        - The dev environment specified belongs to a different project.
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [NAME]
+        NAME for the dev environment you want to describe.
+        This is an optional argument.
+
+## EXAMPLES
+    The following command prints metadata for the dev
+    environment:
+
+        $ uffizzi dev describe

data/man/uffizzi-dev.ronn

@@ -0,0 +1,43 @@
+uffizzi-dev - manage dev environments
+================================================================
+
+## SYNOPSIS
+    uffizzi dev COMMAND
+
+## DESCRIPTION
+    Manage Uffizzi development environments.
+
+    Use these commands for building, pushing, and deploying your
+    project changes to a remote development cluster. Cloud-based
+    dev environments offer many benefits compared to traditional
+    local development, including:
+      - More similar to production deployments
+      - Access to more memory and CPU for resource-intensive
+        apps
+      - Scalability and flexibility for microservices apps
+      - Faster build times
+      - Avoid accumulation of build artifacts on local machine
+      - App components available at public URLs or IP addresses
+      - TLS certificates for HTTPS
+      - Better team collaboration via shareable links
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## COMMANDS
+    COMMAND is one of the following:
+
+     start
+        Start a dev environment
+
+     stop
+        Stop a dev environment
+
+     describe
+        Display details of a dev environment
+
+     ingress
+        Display ingress hosts
+
+## HELP
+    Run 'uffizzi dev COMMAND --help' for more information on a command.

data/man/uffizzi.ronn

@@ -29,6 +29,9 @@ uffizzi - manage Uffizzi resources
          Manage Uffizzi project resources including compose files for
          specifying compose environment (preview) configurations and secrets
 
+     dev
+         Creates a Uffizzi cluster preconfigured for development workflows
+
 ## COMMAND
     COMMAND is one of the following:
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uffizzi-cli
 version: !ruby/object:Gem::Version
-  version: 2.1.4
+  version: 2.2.1
 platform: ruby
 authors:
 - Josh Thurman
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-10-16 00:00:00.000000000 Z
+date: 2023-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -480,8 +480,10 @@ files:
 - man/uffizzi-cluster-disconnect.ronn
 - man/uffizzi-cluster-list
 - man/uffizzi-cluster-list.ronn
+- man/uffizzi-cluster-sleep.ronn
 - man/uffizzi-cluster-update-kubeconfig
 - man/uffizzi-cluster-update-kubeconfig.ronn
+- man/uffizzi-cluster-wake.ronn
 - man/uffizzi-cluster.ronn
 - man/uffizzi-compose
 - man/uffizzi-compose-create
@@ -519,10 +521,14 @@ files:
 - man/uffizzi-connect-ghcr
 - man/uffizzi-connect-ghcr.ronn
 - man/uffizzi-connect.ronn
+- man/uffizzi-dev
+- man/uffizzi-dev-describe
+- man/uffizzi-dev-describe.ronn
 - man/uffizzi-dev-start
 - man/uffizzi-dev-start.ronn
 - man/uffizzi-dev-stop
 - man/uffizzi-dev-stop.ronn
+- man/uffizzi-dev.ronn
 - man/uffizzi-disconnect
 - man/uffizzi-disconnect.ronn
 - man/uffizzi-login