uffizzi-cli 2.0.37 → 2.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2764a609f5446a2b7f1a11ac9ec37619b14f441278dd220142edbab2b106876
-  data.tar.gz: 5f7196a3c7ef61b8d67685d14ce806b7651c9141de0795cb09248455602fed48
+  metadata.gz: 53375ab753d707ea69a899c201838dcc0874a185185532b64f3a3cb8b07720fa
+  data.tar.gz: 177486674f4ba6f11935536cd538ddc6e587ba5a330b738196f082b8fff96c3a
 SHA512:
-  metadata.gz: 741e72b2f9c8c20c6a1bd7631af35f55b321b785b5defb052ea98cd273df80edc31223527bf30bffd59f5f0f3c0269f771ca6473be61292e8b8e985414bd0a44
-  data.tar.gz: f3f0f3ab58fcda3b73d8ab178a79d79591f8a86e63ae7e5d78b70eb3e6188732fb7e65a3e664bb0ada2cb7d04a0cb4c51281857b2165a833d2baf193fcbf5ca2
+  metadata.gz: 7278e21c0ce0a61da3403a874d7ce1e1d9771fd9f45867e4fdf126840fb4ddbc0e86c037be58a3bd9d0311631a819081361c4626c78cf11fdab3e6c89380fee6
+  data.tar.gz: 3d09264798892e9c97074d073940922bb2e7703941496bc5a77c6ba555ba6de3e275c3151b7dbd480d9e7b6be6f350ea1e939898c33b2bcfc8e64b8f562d6193

data/lib/uffizzi/cli/cluster.rb

@@ -11,8 +11,6 @@ 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
@@ -115,7 +113,7 @@ module Uffizzi
       end
 
       cluster_name = command_args[:name] || options[:name] || ClusterService.generate_name
-      creation_source = options[:"creation-source"] || MANUAL
+      creation_source = options[:"creation-source"] || ClusterService::MANUAL_CREATION_SOURCE
 
       unless ClusterService.valid_name?(cluster_name)
         Uffizzi.ui.say_error_and_exit("Cluster name: #{cluster_name} is not valid.")

data/lib/uffizzi/cli/dev.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+require 'uffizzi/services/command_service'
+require 'uffizzi/services/cluster_service'
+require 'uffizzi/services/dev_service'
+require 'uffizzi/services/kubeconfig_service'
+
+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
+    def start(config_path = 'skaffold.yaml')
+      DevService.check_skaffold_existence
+      DevService.check_running_daemon if options[:quiet]
+      DevService.check_skaffold_config_existence(config_path)
+      check_login
+      cluster_id, cluster_name = start_create_cluster
+      kubeconfig = wait_cluster_creation(cluster_name)
+
+      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)
+      end
+    end
+
+    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)
+
+      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 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)
+    end
+
+    def start_create_cluster
+      cluster_name = ClusterService.generate_name
+      creation_source = ClusterService::MANUAL_CREATION_SOURCE
+      params = cluster_creation_params(cluster_name, creation_source)
+      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)
+
+      cluster_id = response.dig(:body, :cluster, :id)
+      cluster_name = response.dig(:body, :cluster, :name)
+
+      [cluster_id, 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))
+
+      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])
+
+      Uffizzi.ui.say("Cluster with name: #{cluster_data[:name]} was created.")
+
+      save_kubeconfig(parsed_kubeconfig, kubeconfig_path)
+      update_clusters_config(cluster_data[:id], kubeconfig_path: kubeconfig_path)
+    end
+
+    def save_kubeconfig(kubeconfig, kubeconfig_path)
+      KubeconfigService.save_to_filepath(kubeconfig_path, kubeconfig) do |kubeconfig_by_path|
+        merged_kubeconfig = KubeconfigService.merge(kubeconfig_by_path, kubeconfig)
+
+        new_current_context = KubeconfigService.get_current_context(kubeconfig)
+        new_kubeconfig = KubeconfigService.update_current_context(merged_kubeconfig, new_current_context)
+
+        next new_kubeconfig if kubeconfig_by_path.nil?
+
+        previous_current_context = KubeconfigService.get_current_context(kubeconfig_by_path)
+        save_previous_current_context(kubeconfig_path, previous_current_context)
+        new_kubeconfig
+      end
+    end
+
+    def update_clusters_config(id, params)
+      clusters_config = Uffizzi::ConfigHelper.update_clusters_config_by_id(id, params)
+      ConfigFile.write_option(:clusters, clusters_config)
+    end
+
+    def cluster_creation_params(name, creation_source)
+      oidc_token = Uffizzi::ConfigFile.read_option(:oidc_token)
+
+      {
+        cluster: {
+          name: name,
+          manifest: nil,
+          creation_source: creation_source,
+        },
+        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 = {
+        cluster_name: cluster_name,
+        oidc_token: ConfigFile.read_option(:oidc_token),
+      }
+      response = delete_cluster(ConfigFile.read_option(:server), project_slug, params)
+
+      if ResponseHelper.no_content?(response)
+        Uffizzi.ui.say("Cluster #{cluster_name} deleted")
+      else
+        ResponseHelper.handle_failed_response(response)
+      end
+    end
+
+    def exclude_kubeconfig(cluster_id, kubeconfig)
+      cluster_config = Uffizzi::ConfigHelper.cluster_config_by_id(cluster_id)
+      return if cluster_config.nil?
+
+      kubeconfig_path = cluster_config[:kubeconfig_path]
+      ConfigFile.write_option(:clusters, Uffizzi::ConfigHelper.clusters_config_without(cluster_id))
+
+      KubeconfigService.save_to_filepath(kubeconfig_path, kubeconfig) do |kubeconfig_by_path|
+        return if kubeconfig_by_path.nil?
+
+        new_kubeconfig = KubeconfigService.exclude(kubeconfig_by_path, kubeconfig)
+        new_current_context = find_previous_current_context(new_kubeconfig, kubeconfig_path)
+        KubeconfigService.update_current_context(new_kubeconfig, new_current_context)
+      end
+    end
+
+    def find_previous_current_context(kubeconfig, kubeconfig_path)
+      prev_current_context = Uffizzi::ConfigHelper.previous_current_context_by_path(kubeconfig_path)&.fetch(:current_context, nil)
+
+      if KubeconfigService.find_cluster_contexts_by_name(kubeconfig, prev_current_context).present?
+        prev_current_context
+      end
+    end
+
+    def save_previous_current_context(kubeconfig_path, current_context)
+      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 parse_kubeconfig(kubeconfig)
+      return if kubeconfig.nil?
+
+      Psych.safe_load(Base64.decode64(kubeconfig))
+    end
+
+    def launch_demonise_skaffold(config_path)
+      Uffizzi.process.daemon(true)
+
+      at_exit do
+        File.delete(DevService.pid_path) if File.exist?(DevService.pid_path)
+      end
+
+      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 project_slug
+      @project_slug ||= ConfigFile.read_option(:project)
+    end
+  end
+end

data/lib/uffizzi/cli.rb

@@ -71,6 +71,10 @@ module Uffizzi
       Disconnect.new.run(credential_type)
     end
 
+    desc 'dev', 'dev'
+    require_relative 'cli/dev'
+    subcommand 'dev', Cli::Dev
+
     map preview: :compose
 
     class << self

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/disconnect_service.rb

@@ -9,8 +9,6 @@ class ClusterDisconnectService
     def handle(options)
       kubeconfig_path = options[:kubeconfig] || KubeconfigService.default_path
       is_ask_origin_current_context = options[:ask]
-
-      prev_current_context = Uffizzi::ConfigHelper.previous_current_context_by_path(kubeconfig_path)&.fetch(:current_context, nil)
       kubeconfig = KubeconfigService.read_kubeconfig(kubeconfig_path)
 
       if kubeconfig.nil?
@@ -18,12 +16,14 @@ class ClusterDisconnectService
       end
 
       contexts = KubeconfigService.get_cluster_contexts(kubeconfig)
-      current_context = KubeconfigService.get_current_context(kubeconfig)
 
       if contexts.empty?
         return Uffizzi.ui.say("No contexts by kubeconfig path #{kubeconfig_path}")
       end
 
+      prev_current_context = Uffizzi::ConfigHelper.previous_current_context_by_path(kubeconfig_path)&.fetch(:current_context, nil)
+      current_context = KubeconfigService.get_current_context(kubeconfig)
+
       if KubeconfigService.find_cluster_contexts_by_name(kubeconfig, prev_current_context).present? &&
           prev_current_context != current_context &&
           !is_ask_origin_current_context

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/shell.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'awesome_print'
+require 'open3'
 
 module Uffizzi
   module UI
@@ -54,6 +55,14 @@ module Uffizzi
         $stdout.stat.pipe?
       end
 
+      def popen2e(command, &block)
+        Open3.popen2e(command, &block)
+      end
+
+      def capture3(command)
+        Open3.capture3(command)
+      end
+
       private
 
       def format_to_json(data)

data/lib/uffizzi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Uffizzi
-  VERSION = '2.0.37'
+  VERSION = '2.1.2'
 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

@@ -17,7 +17,7 @@ https://docs\.uffizzi\.com/references/cli/
 .fi
 .SH "FLAGS"
 .nf
-\-\- name
+\-\-name
     Option is deprecated and will be removed in the newer versions\.
     Please use a positional argument instead: uffizzi cluster create my\-awesome\-name\.
 

data/man/uffizzi-dev-start

@@ -0,0 +1,99 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-DEV\-START" "" "October 2023" ""
+.SH "NAME"
+\fBuffizzi\-dev\-start\fR \- start a development environment
+.SH "SYNOPSIS"
+.nf
+uffizzi dev start [CONFIG_FILE] [FLAGS]
+.fi
+.SH "DESCRIPTION"
+.nf
+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
+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 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 dev start \e
+      \-\-kubeconfig="/path/to/alternate/kubeconfig"
+.fi
+

data/man/uffizzi-dev-start.ronn

@@ -0,0 +1,90 @@
+uffizzi-dev-start - start a development environment
+================================================================
+
+## SYNOPSIS
+    uffizzi dev start [CONFIG_FILE] [FLAGS]
+
+## DESCRIPTION
+    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
+     --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.
+
+## EXAMPLES
+    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 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 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.0.37
+  version: 2.1.2
 platform: ruby
 authors:
 - Josh Thurman
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2023-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -423,6 +423,7 @@ files:
 - lib/uffizzi/cli/common.rb
 - lib/uffizzi/cli/config.rb
 - lib/uffizzi/cli/connect.rb
+- lib/uffizzi/cli/dev.rb
 - lib/uffizzi/cli/disconnect.rb
 - lib/uffizzi/cli/login.rb
 - lib/uffizzi/cli/login_by_identity_token.rb
@@ -449,6 +450,7 @@ files:
 - 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
@@ -518,6 +520,10 @@ files:
 - man/uffizzi-connect-ghcr
 - man/uffizzi-connect-ghcr.ronn
 - 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