uffizzi-cli 2.1.0 → 2.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fc9021c07ec1fbbbd32baab4e37dcdf3eb9b7368843701e9c0a086da8eefefe
-  data.tar.gz: ccf95b0bd9ae6fffa906a15012825a9c9d4b209263e0735ce200d5ba5ca953b8
+  metadata.gz: 0a2c29a4de6f7d90584e2e49dfdfce35d6a787d126617a90af2725153a4d97e1
+  data.tar.gz: e318f3abd73127d71c42eb96a74adf02bd200d81b3d8beeaae4e96028f01a1fe
 SHA512:
-  metadata.gz: aeb135bb03097b24c39b408e10bc31fa995d3cd4da3284eacc07be126b04a5aaf18a02e5cf432e5e9f46a24bb842c79209d3100ec8d0b94efde7f8c9a5b43ae4
-  data.tar.gz: 29d2160ec30fd61f9f5bf96ef24dea226b6388e9ab1bcf47b3c6a66a2b518df17bc9013d5d036dc5f3c6b517e30f2de0015a46d2ce933f8332113943e84a9b54
+  metadata.gz: bf7d7627bb4d280719662cf21187cd532bf7434e11bfd5a52e43b31b008203061bcc3b31e1964001f15af5e2a98ee351481318326d4c4c729f63797c70dd6802
+  data.tar.gz: e5c50211551e420d3e114fd9a70987a7c481f9cf82517d3b5cf5f5baeddaa8f43244c9afcf0d0c5d947ef1e1cbb0be771376c8394f9a4028e661821eead389ed

data/lib/uffizzi/auth_helper.rb

@@ -4,7 +4,7 @@ module Uffizzi
   module AuthHelper
     class << self
       def signed_in?
-        config_data_exists? || Uffizzi::Token.exists?
+        config_data_exists? && authorized?
       end
 
       def sign_out
@@ -16,13 +16,25 @@ module Uffizzi
         Uffizzi::Token.delete if Uffizzi::Token.exists?
       end
 
+      def check_login(project_option)
+        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
+
       private
 
       def config_data_exists?
         ConfigFile.exists? &&
-          ConfigFile.option_has_value?(:account) &&
-          ConfigFile.option_has_value?(:cookie) &&
-          ConfigFile.option_has_value?(:server)
+          ConfigFile.option_has_value?(:server) &&
+          ConfigFile.option_has_value?(:account)
+      end
+
+      def authorized?
+        ConfigFile.option_has_value?(:cookie) || Uffizzi::Token.exists?
+      end
+
+      def project_set?(project_option)
+        !project_option.nil? || (Uffizzi::ConfigFile.exists? && Uffizzi::ConfigFile.option_has_value?(:project))
       end
     end
   end

data/lib/uffizzi/cli/account.rb

@@ -25,7 +25,7 @@ module Uffizzi
     private
 
     def run(command, account_name = nil)
-      return Uffizzi.ui.say('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       case command
       when 'list'

data/lib/uffizzi/cli/cluster.rb

@@ -6,13 +6,10 @@ require 'uffizzi'
 require 'uffizzi/auth_helper'
 require 'uffizzi/helpers/config_helper'
 require 'uffizzi/services/preview_service'
-require 'uffizzi/services/command_service'
 require 'uffizzi/services/cluster_service'
 require 'uffizzi/services/kubeconfig_service'
 require 'uffizzi/services/cluster/disconnect_service'
 
-MANUAL = 'manual'
-
 module Uffizzi
   class Cli::Cluster < Thor
     class Error < StandardError; end
@@ -32,6 +29,7 @@ module Uffizzi
     method_option :'update-current-context', type: :boolean, required: false, default: true
     method_option :output, required: false, type: :string, aliases: '-o', enum: ['json', 'pretty-json']
     method_option :'creation-source', required: false, type: :string
+    method_option :'k8s-version', required: false, type: :string
     def create(name = nil)
       run('create', { name: name })
     end
@@ -67,9 +65,7 @@ module Uffizzi
 
     def run(command, command_args = {})
       Uffizzi.ui.output_format = options[:output]
-      raise Uffizzi::Error.new('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      raise Uffizzi::Error.new('This command needs project to be set in config file') unless CommandService.project_set?(options)
-
+      Uffizzi::AuthHelper.check_login(options[:project])
       project_slug = options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
 
       case command
@@ -115,14 +111,16 @@ module Uffizzi
       end
 
       cluster_name = command_args[:name] || options[:name] || ClusterService.generate_name
-      creation_source = options[:"creation-source"] || MANUAL
-
-      unless ClusterService.valid_name?(cluster_name)
-        Uffizzi.ui.say_error_and_exit("Cluster name: #{cluster_name} is not valid.")
-      end
-
-      manifest_file_path = options[:manifest]
-      params = cluster_creation_params(cluster_name, creation_source, manifest_file_path)
+      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)
 
       return ResponseHelper.handle_failed_response(response) unless ResponseHelper.created?(response)
@@ -241,7 +239,7 @@ module Uffizzi
       end
     end
 
-    def cluster_creation_params(name, creation_source, manifest_file_path)
+    def cluster_creation_params(name:, creation_source:, manifest_file_path:, k8s_version:)
       manifest_content = load_manifest_file(manifest_file_path)
       oidc_token = Uffizzi::ConfigFile.read_option(:oidc_token)
 
@@ -250,6 +248,7 @@ module Uffizzi
           name: name,
           manifest: manifest_content,
           creation_source: creation_source,
+          k8s_version: k8s_version,
         },
         token: oidc_token,
       }
@@ -305,6 +304,7 @@ module Uffizzi
         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?
@@ -337,7 +337,6 @@ module Uffizzi
     end
 
     def save_kubeconfig(kubeconfig, kubeconfig_path)
-      kubeconfig_path = kubeconfig_path.nil? ? KubeconfigService.default_path : kubeconfig_path
       is_update_current_context = options[:'update-current-context']
 
       KubeconfigService.save_to_filepath(kubeconfig_path, kubeconfig) do |kubeconfig_by_path|
@@ -356,6 +355,8 @@ module Uffizzi
           merged_kubeconfig
         end
       end
+
+      Uffizzi.ui.say("Kubeconfig was updated by the path: #{kubeconfig_path}") if is_update_current_context
     end
 
     def update_clusters_config(id, params)

data/lib/uffizzi/cli/dev.rb

@@ -1,20 +1,32 @@
 # frozen_string_literal: true
 
-require 'uffizzi/services/command_service'
 require 'uffizzi/services/cluster_service'
+require 'uffizzi/services/dev_service'
 require 'uffizzi/services/kubeconfig_service'
+require 'uffizzi/auth_helper'
 
 module Uffizzi
   class Cli::Dev < Thor
     include ApiClient
 
     desc 'start [CONFIG]', 'Start dev environment'
+    method_option :quiet, type: :boolean, aliases: :q
+    method_option :'default-repo', type: :string
+    method_option :kubeconfig, type: :string
+    method_option :'k8s-version', required: false, type: :string
     def start(config_path = 'skaffold.yaml')
-      check_skaffold_existence
-      check_login
+      Uffizzi::AuthHelper.check_login(options[:project])
+      DevService.check_skaffold_existence
+      DevService.check_running_daemon if options[:quiet]
+      DevService.check_skaffold_config_existence(config_path)
       cluster_id, cluster_name = start_create_cluster
       kubeconfig = wait_cluster_creation(cluster_name)
-      launch_scaffold(config_path)
+
+      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
@@ -22,17 +34,28 @@ module Uffizzi
       end
     end
 
-    private
+    desc 'stop', 'Stop dev environment'
+    def stop
+      return Uffizzi.ui.say('Uffizzi dev is not running') unless File.exist?(DevService.pid_path)
+
+      pid = File.read(DevService.pid_path).to_i
+      File.delete(DevService.pid_path)
 
-    def check_login
-      raise Uffizzi::Error.new('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      raise Uffizzi::Error.new('This command needs project to be set in config file') unless CommandService.project_set?(options)
+      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)
     end
 
+    private
+
     def start_create_cluster
-      cluster_name = ClusterService.generate_name
-      creation_source = MANUAL
-      params = cluster_creation_params(cluster_name, creation_source)
+      params = cluster_creation_params(
+        name: ClusterService.generate_name,
+        creation_source: ClusterService::MANUAL_CREATION_SOURCE,
+        k8s_version: options[:"k8s-version"],
+      )
       Uffizzi.ui.say('Start creating a cluster')
       response = create_cluster(ConfigFile.read_option(:server), project_slug, params)
       return ResponseHelper.handle_failed_response(response) unless ResponseHelper.created?(response)
@@ -56,7 +79,7 @@ module Uffizzi
     end
 
     def handle_succeed_cluster_creation(cluster_data)
-      kubeconfig_path = KubeconfigService.default_path
+      kubeconfig_path = options[:kubeconfig] || KubeconfigService.default_path
       parsed_kubeconfig = parse_kubeconfig(cluster_data[:kubeconfig])
 
       Uffizzi.ui.say("Cluster with name: #{cluster_data[:name]} was created.")
@@ -85,7 +108,7 @@ module Uffizzi
       ConfigFile.write_option(:clusters, clusters_config)
     end
 
-    def cluster_creation_params(name, creation_source)
+    def cluster_creation_params(name:, creation_source:, k8s_version:)
       oidc_token = Uffizzi::ConfigFile.read_option(:oidc_token)
 
       {
@@ -93,12 +116,15 @@ module Uffizzi
           name: name,
           manifest: nil,
           creation_source: creation_source,
+          k8s_version: k8s_version,
         },
         token: oidc_token,
       }
     end
 
     def handle_delete_cluster(cluster_id, cluster_name, kubeconfig)
+      return if cluster_id.nil? || cluster_name.nil?
+
       exclude_kubeconfig(cluster_id, kubeconfig) if kubeconfig.present?
 
       params = {
@@ -149,25 +175,19 @@ module Uffizzi
       Psych.safe_load(Base64.decode64(kubeconfig))
     end
 
-    def launch_scaffold(config_path)
-      Uffizzi.ui.say('Start skaffold')
-      cmd = "skaffold dev --filename='#{config_path}'"
+    def launch_demonise_skaffold(config_path)
+      Uffizzi.process.daemon(true)
 
-      Uffizzi.ui.popen2e(cmd) do |_stdin, stdout_and_stderr, wait_thr|
-        stdout_and_stderr.each { |l| puts l }
-        wait_thr.value
+      at_exit do
+        File.delete(DevService.pid_path) if File.exist?(DevService.pid_path)
       end
-    end
-
-    def check_skaffold_existence
-      cmd = 'skaffold version'
-      stdout_str, stderr_str = Uffizzi.ui.capture3(cmd)
-
-      return if stdout_str.present? && stderr_str.blank?
 
-      Uffizzi.ui.say_error_and_exit(stderr_str)
+      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
-      Uffizzi.ui.say_error_and_exit(e.message)
+      File.open(DevService.logs_path, 'a') { |f| f.puts(e.message) }
     end
 
     def project_slug

data/lib/uffizzi/cli/preview/service.rb

@@ -4,7 +4,6 @@ require 'uffizzi'
 require 'uffizzi/auth_helper'
 require 'uffizzi/response_helper'
 require 'uffizzi/services/preview_service'
-require 'uffizzi/services/command_service'
 
 module Uffizzi
   class Cli::Preview::Service < Thor
@@ -12,8 +11,7 @@ module Uffizzi
 
     desc 'logs [LOGS_TYPE] [DEPLOYMENT_ID] [CONTAINER_NAME]', 'Show the logs for a container service of a preview'
     def logs(logs_type, deployment_name, container_name = args)
-      return Uffizzi.ui.say('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      return Uffizzi.ui.say('This command needs project to be set in config file') unless CommandService.project_set?(options)
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       deployment_id = PreviewService.read_deployment_id(deployment_name)
       response = service_logs_response(logs_type, deployment_id, container_name)
@@ -28,8 +26,7 @@ module Uffizzi
 
     desc 'list [DEPLOYMENT_ID]', 'List the container services of a given compose environment (preview)'
     def list(deployment_name)
-      return Uffizzi.ui.say('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      return Uffizzi.ui.say('This command needs project to be set in config file') unless CommandService.project_set?(options)
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       project_slug = options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
       server = ConfigFile.read_option(:server)

data/lib/uffizzi/cli/preview.rb

@@ -3,7 +3,6 @@
 require 'uffizzi'
 require 'uffizzi/auth_helper'
 require 'uffizzi/services/preview_service'
-require 'uffizzi/services/command_service'
 require 'uffizzi/services/github_service'
 
 module Uffizzi
@@ -55,8 +54,7 @@ module Uffizzi
 
     def run(command, file_path: nil, deployment_name: nil)
       Uffizzi.ui.output_format = options[:output]
-      raise Uffizzi::Error.new('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      raise Uffizzi::Error.new('This command needs project to be set in config file') unless CommandService.project_set?(options)
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       project_slug = options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
 

data/lib/uffizzi/cli/project/compose.rb

@@ -5,7 +5,6 @@ require 'uffizzi/auth_helper'
 require 'uffizzi/response_helper'
 require 'uffizzi/services/compose_file_service'
 require 'uffizzi/services/env_variables_service'
-require 'uffizzi/services/command_service'
 
 module Uffizzi
   class Cli::Project::Compose < Thor
@@ -29,8 +28,7 @@ module Uffizzi
     private
 
     def run(command)
-      return Uffizzi.ui.say('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
-      return Uffizzi.ui.say('This command needs project to be set in config file') unless CommandService.project_set?(options)
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       project_slug = options[:project].nil? ? ConfigFile.read_option(:project) : options[:project]
       file_path = options[:file]

data/lib/uffizzi/cli/project.rb

@@ -55,7 +55,7 @@ module Uffizzi
     private
 
     def run(command, project_slug: nil)
-      return Uffizzi.ui.say('You are not logged in.') unless Uffizzi::AuthHelper.signed_in?
+      Uffizzi::AuthHelper.check_login(options[:project])
 
       case command
       when 'list'

data/lib/uffizzi/config_file.rb

@@ -5,6 +5,7 @@ require 'uffizzi/helpers/file_helper'
 
 module Uffizzi
   class ConfigFile
+    CONFIG_DIR = "#{Dir.home}/.config/uffizzi"
     CONFIG_PATH = "#{Dir.home}/.config/uffizzi/config_default.json"
 
     class << self

data/lib/uffizzi/services/cluster_service.rb

@@ -9,6 +9,7 @@ class ClusterService
   CLUSTER_STATE_FAILED_DEPLOY_NAMESPACE = 'failed_deploy_namespace'
   CLUSTER_STATE_FAILED = 'failed'
   CLUSTER_NAME_MAX_LENGTH = 15
+  MANUAL_CREATION_SOURCE = 'manual'
 
   class << self
     include ApiClient

data/lib/uffizzi/services/dev_service.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require 'uffizzi/clients/api/api_client'
+
+class DevService
+  class << self
+    include ApiClient
+
+    DEFAULT_REGISTRY_REPO = 'registry.uffizzi.com'
+
+    def check_running_daemon
+      return unless File.exist?(pid_path)
+
+      pid = File.read(pid_path)
+      File.delete(pid_path) if pid.blank?
+      Uffizzi.process.kill(0, pid.to_i)
+
+      Uffizzi.ui.say_error_and_exit("You have already started uffizzi dev as daemon. To stop the process do 'uffizzi dev stop'")
+    rescue Errno::ESRCH
+      File.delete(pid_path)
+    end
+
+    def start_check_pid_file_existence
+      Thread.new do
+        loop do
+          Uffizzi.process.kill('QUIT', Uffizzi.process.pid) unless File.exist?(pid_path)
+          sleep(1)
+        end
+      end
+    end
+
+    def start_basic_skaffold(config_path, options)
+      Uffizzi.ui.say('Start skaffold')
+      cmd = build_skaffold_dev_command(config_path, options)
+
+      Uffizzi.ui.popen2e(cmd) do |_stdin, stdout_and_stderr, wait_thr|
+        stdout_and_stderr.each { |l| Uffizzi.ui.say(l) }
+        wait_thr.value
+      end
+    end
+
+    def start_demonised_skaffold(config_path, options)
+      File.write(logs_path, "Start skaffold\n")
+      cmd = build_skaffold_dev_command(config_path, options)
+
+      Uffizzi.ui.popen2e(cmd) do |_stdin, stdout_and_stderr, wait_thr|
+        File.open(logs_path, 'a') do |f|
+          stdout_and_stderr.each do |line|
+            f.puts(line)
+            f.flush
+          end
+        end
+
+        wait_thr.value
+      end
+    end
+
+    def check_skaffold_existence
+      cmd = 'skaffold version'
+      stdout_str, stderr_str = Uffizzi.ui.capture3(cmd)
+
+      return if stdout_str.present? && stderr_str.blank?
+
+      Uffizzi.ui.say_error_and_exit(stderr_str)
+    rescue StandardError => e
+      Uffizzi.ui.say_error_and_exit(e.message)
+    end
+
+    def check_skaffold_config_existence(config_path)
+      msg = 'A valid dev environment configuration is required. Please provide a valid config,'\
+            "\r\n"\
+            'or run `skaffold init` to generate a skaffold.yaml configuration.'\
+            "\r\n"\
+            'See the `uffizzi dev start --help` page for supported configs and usage details.'
+
+      Uffizzi.ui.say_error_and_exit(msg) unless File.exist?(config_path)
+    end
+
+    def pid_path
+      File.join(Uffizzi::ConfigFile::CONFIG_DIR, 'uffizzi_dev.pid')
+    end
+
+    def logs_path
+      File.join(Uffizzi::ConfigFile::CONFIG_DIR, 'uffizzi_dev.log')
+    end
+
+    def build_skaffold_dev_command(config_path, options)
+      cmd = [
+        'skaffold dev',
+        "--filename='#{config_path}'",
+        "--default-repo='#{default_registry_repo(options[:'default-repo'])}'",
+        "--kubeconfig='#{default_kubeconfig_path(options[:kubeconfig])}'",
+      ]
+
+      cmd.join(' ')
+    end
+
+    def default_registry_repo(repo)
+      repo || DEFAULT_REGISTRY_REPO
+    end
+
+    def default_kubeconfig_path(kubeconfig_path)
+      path = kubeconfig_path || KubeconfigService.default_path
+
+      File.expand_path(path)
+    end
+  end
+end

data/lib/uffizzi/services/kubeconfig_service.rb

@@ -81,7 +81,9 @@ class KubeconfigService
     end
 
     def default_path
-      kubeconfig_env_path || Uffizzi.configuration.default_kubeconfig_path
+      path = kubeconfig_env_path || Uffizzi.configuration.default_kubeconfig_path
+
+      File.expand_path(path)
     end
 
     def read_kubeconfig(filepath)

data/lib/uffizzi/version.rb

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

data/lib/uffizzi.rb

@@ -36,5 +36,9 @@ module Uffizzi
     def root
       @root ||= Pathname.new(File.expand_path('..', __dir__))
     end
+
+    def process
+      @process ||= Process
+    end
   end
 end

data/man/uffizzi-cluster-create.ronn

@@ -1,3 +1,4 @@
+uffizzi cluster create -h
 uffizzi-cluster-create - create a cluster
 ================================================================
 
@@ -12,9 +13,17 @@ uffizzi-cluster-create - create a cluster
     https://docs.uffizzi.com/references/cli/
 
 ## FLAGS
+
     --name
         Option is deprecated and will be removed in the newer versions.
-        Please use a positional argument instead: uffizzi cluster create my-awesome-name.
+        Please use a positional argument instead: uffizzi cluster create 
+        my-awesome-name.
+
+    --k8s-version=<api-version>
+        Specify which version of the Kubernetes API to use when creating 
+        the cluster, formatted as [MAJOR].[MINOR]. Defaults to 1.27. 
+        Minor versions point to the latest release of the corresponding k3s 
+        minor version. See https://github.com/k3s-io/k3s/releases
 
     --kubeconfig="/path/to/your/kubeconfig"
         Path to kubeconfig file

data/man/uffizzi-dev-start

@@ -1,29 +1,99 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "UFFIZZI\-DEV\-START" "" "September 2023" ""
+.TH "UFFIZZI\-DEV\-START" "" "October 2023" ""
 .SH "NAME"
-\fBuffizzi\-dev\-start\fR \- start development environment
+\fBuffizzi\-dev\-start\fR \- start a development environment
 .SH "SYNOPSIS"
 .nf
-uffizzi dev start [SKAFFOLD_CONFIG_FILE_PATH]
+uffizzi dev start [CONFIG_FILE] [FLAGS]
 .fi
 .SH "DESCRIPTION"
 .nf
-Creates a new cluster and start skaffold\. If no SKAFFOLD_CONFIG_FILE_PATH is specified,
-the default path will be used\.
-Default SKAFFOLD_CONFIG_FILE_PATH is \'skaffold\.yaml\'
+Creates a Uffizzi cluster preconfigured for development
+workflows, including building, pushing, and deploying
+your changes every time project files are saved\.
+current\-context is updated in kubeconfig file\.
+
+This command watches for file changes in a given local
+project directory, as specified in your configuration file\.
+It then serializes those changes and redeploys them onto
+a Uffizzi cluster\.
+
+The command looks for a configuration at the specified
+path CONFIG_FILE\. Skaffold configurations are currently
+supported\. For help creating a skaffold\.yaml file, see:
+https://skaffold\.dev/docs/init/
+
+If a kubeconfig exists
 
 For more information on Uffizzi clusters, see:
 https://docs\.uffizzi\.com/references/cli/
 .fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[CONFIG_FILE]
+    Path to the development environment configuration file\.
+    Currently supports skaffold\.yaml files\.
+.fi
+.SH "FLAGS"
+.nf
+ \-\-build="<local\-or\-remote>"
+    This option specifies whether to build images on the
+    local environment or on the remote Uffizzi cluster\.
+    Possible values are "local" or "remote"\.
+
+ \-\-default\-repo="<container\-registry\-domain>"
+    A public or private repo used to push/pull build
+    artifacts\. Overrides the global default image registry:
+    "registry\.uffizzi\.com"\. See `uffizzi connect \-h` for
+    adding private registry credentials\.
+
+ \-\-quiet, \-q
+    Run the development process in detached mode (i\.e\., in
+    the background)\. Without this option, logs are streamed
+    to the terminal in the foreground\. Run \'uffizzi dev stop`
+    to stop the detached process\.
+
+ \-\-help, \-h
+    Show this message and exit\.
+
+ \-\-kubeconfig="/path/to/your/kubeconfig"
+    Path to kubeconfig file\. If this option is not specified,
+    this command looks for the file at ~/\.kube/config\.
+.fi
 .SH "EXAMPLES"
 .nf
-To start development environment, run:
+If your configuration file is in the current working
+directory and you want to use an auto\-generated name,
+run:
 
     $ uffizzi dev start
 
-To start development environment with custom skaffold\.yaml file, run:
+To start a dev environment using a skaffold\.yaml config
+file in directory \'~/foo\', run:
+
+    $ uffizzi dev start ~/foo/skaffold\.yaml
+
+To start a dev environment in quiet  mode,
+run:
+
+    $ uffizzi dev start \-\-quiet
+
+To push your build artifacts to a private Docker Hub repo
+called \'acme/foo\', first add your Docker Hub credentials:
+
+    $ uffizzi connect docker\-hub
+    (See `uffizzi connect \-h` for other registry options)
+
+\|\.\|\.\|\.then override the default repo:
+
+    $ uffizzi dev start \e
+      \-\-default\-repo="hub\.docker\.com/acme/foo"
+
+To start a dev environment using an alternate kubeconfig file,
+run:
 
-    $ uffizzi cluster create /path/to/skaffold\.yaml
+    $ uffizzi dev start \e
+      \-\-kubeconfig="/path/to/alternate/kubeconfig"
 .fi
 

data/man/uffizzi-dev-start.ronn

@@ -1,22 +1,91 @@
-uffizzi-dev-start - start development environment
+uffizzi-dev-start - start a development environment
 ================================================================
 
 ## SYNOPSIS
-    uffizzi dev start [SKAFFOLD_CONFIG_FILE_PATH]
+    uffizzi dev start [CONFIG_FILE] [FLAGS]
 
 ## DESCRIPTION
-    Creates a new cluster and start skaffold. If no SKAFFOLD_CONFIG_FILE_PATH is specified,
-    the default path will be used.
-    Default SKAFFOLD_CONFIG_FILE_PATH is 'skaffold.yaml'
+    Creates a Uffizzi cluster preconfigured for development
+    workflows, including building, pushing, and deploying
+    your changes every time project files are saved.
+    current-context is updated in kubeconfig file.
+
+    This command watches for file changes in a given local
+    project directory, as specified in your configuration file.
+    It then serializes those changes and redeploys them onto
+    a Uffizzi cluster.
+
+    The command looks for a configuration at the specified
+    path CONFIG_FILE. Skaffold configurations are currently
+    supported. For help creating a skaffold.yaml file, see:
+    https://skaffold.dev/docs/init/
+
+    If a kubeconfig exists
 
     For more information on Uffizzi clusters, see:
     https://docs.uffizzi.com/references/cli/
 
+## POSITIONAL ARGUMENTS
+    [CONFIG_FILE]
+        Path to the development environment configuration file.
+        Currently supports skaffold.yaml files.
+
+## FLAGS
+     --k8s-version=<api-version>
+        Specify which version of the Kubernetes API to use when creating 
+        the cluster, formatted as [MAJOR].[MINOR]. Defaults to 1.27. 
+        Minor versions point to the latest release of the corresponding k3s 
+        minor version. See https://github.com/k3s-io/k3s/releases
+
+     --default-repo="<container-registry-domain>"
+        A public or private repo used to push/pull build
+        artifacts. Overrides the global default image registry:
+        "registry.uffizzi.com". See `uffizzi connect -h` for
+        adding private registry credentials.
+
+     --quiet, -q
+        Run the development process in detached mode (i.e., in
+        the background). Without this option, logs are streamed
+        to the terminal in the foreground. Run 'uffizzi dev stop`
+        to stop the detached process.
+
+     --help, -h
+        Show this message and exit.
+
+     --kubeconfig="/path/to/your/kubeconfig"
+        Path to kubeconfig file. If this option is not specified,
+        this command looks for the file at ~/.kube/config.
+
 ## EXAMPLES
-    To start development environment, run:
+    If your configuration file is in the current working
+    directory and you want to use an auto-generated name,
+    run:
 
         $ uffizzi dev start
 
-    To start development environment with custom skaffold.yaml file, run:
+    To start a dev environment using a skaffold.yaml config
+    file in directory '~/foo', run:
+
+        $ uffizzi dev start ~/foo/skaffold.yaml
+
+    To start a dev environment in quiet  mode,
+    run:
+
+        $ uffizzi dev start --quiet
+
+    To push your build artifacts to a private Docker Hub repo
+    called 'acme/foo', first add your Docker Hub credentials:
+
+        $ uffizzi connect docker-hub
+        (See `uffizzi connect -h` for other registry options)
+
+    ...then override the default repo:
+
+        $ uffizzi dev start \
+          --default-repo="hub.docker.com/acme/foo"
+
+    To start a dev environment using an alternate kubeconfig file,
+    run:
 
-        $ uffizzi cluster create /path/to/skaffold.yaml
+        $ uffizzi dev start \
+          --kubeconfig="/path/to/alternate/kubeconfig"

data/man/uffizzi-dev-stop

@@ -0,0 +1,41 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-DEV\-STOP" "" "October 2023" ""
+.SH "NAME"
+\fBuffizzi\-dev\-stop\fR \- stop a development environment
+.SH "SYNOPSIS"
+.nf
+uffizzi dev stop
+.fi
+.SH "DESCRIPTION"
+.nf
+Stops a dev environment and deletes the backing
+Uffizzi cluster resources, including any persistent
+volumes, and the namespace itself\. The Uffizzi
+cluster config is deleted from the kubeconfig file\.
+
+This command watches for file changes in a given local
+project directory, as specified in your configuration file\.
+It then serializes those changes and redeploys them onto
+a Uffizzi cluster\.
+
+The command looks for a configuration at the specified
+path CONFIG_FILE\. Skaffold configurations are currently
+supported\. For help creating a skaffold\.yaml file, see:
+https://skaffold\.dev/docs/init/
+
+For more information on Uffizzi clusters, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "FLAGS"
+.nf
+ \-\-help, \-h
+    Show this message and exit\.
+.fi
+.SH "EXAMPLES"
+.nf
+To stop a dev environment, run:
+
+    $ uffizzi dev stop
+.fi
+

data/man/uffizzi-dev-stop.ronn

@@ -0,0 +1,33 @@
+uffizzi-dev-stop - stop a development environment
+================================================================
+
+## SYNOPSIS
+    uffizzi dev stop
+
+## DESCRIPTION
+    Stops a dev environment and deletes the backing
+    Uffizzi cluster resources, including any persistent
+    volumes, and the namespace itself. The Uffizzi
+    cluster config is deleted from the kubeconfig file.
+
+    This command watches for file changes in a given local
+    project directory, as specified in your configuration file.
+    It then serializes those changes and redeploys them onto
+    a Uffizzi cluster.
+
+    The command looks for a configuration at the specified
+    path CONFIG_FILE. Skaffold configurations are currently
+    supported. For help creating a skaffold.yaml file, see:
+    https://skaffold.dev/docs/init/
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## FLAGS
+     --help, -h
+        Show this message and exit.
+
+## EXAMPLES
+    To stop a dev environment, run:
+
+        $ uffizzi dev stop

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uffizzi-cli
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.3
 platform: ruby
 authors:
 - Josh Thurman
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-29 00:00:00.000000000 Z
+date: 2023-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -448,8 +448,8 @@ files:
 - lib/uffizzi/response_helper.rb
 - lib/uffizzi/services/cluster/disconnect_service.rb
 - lib/uffizzi/services/cluster_service.rb
-- lib/uffizzi/services/command_service.rb
 - lib/uffizzi/services/compose_file_service.rb
+- lib/uffizzi/services/dev_service.rb
 - lib/uffizzi/services/env_variables_service.rb
 - lib/uffizzi/services/github_service.rb
 - lib/uffizzi/services/kubeconfig_service.rb
@@ -521,6 +521,8 @@ files:
 - man/uffizzi-connect.ronn
 - man/uffizzi-dev-start
 - man/uffizzi-dev-start.ronn
+- man/uffizzi-dev-stop
+- man/uffizzi-dev-stop.ronn
 - man/uffizzi-disconnect
 - man/uffizzi-disconnect.ronn
 - man/uffizzi-login

data/lib/uffizzi/services/command_service.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-class CommandService
-  class << self
-    def project_set?(options)
-      !options[:project].nil? || (Uffizzi::ConfigFile.exists? && Uffizzi::ConfigFile.option_has_value?(:project))
-    end
-  end
-end