dash 3.2.0 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f607b635a7a5840d0bf9c4e6e4377d2ca86a17ed8a619510e08f487eb69da2e
-  data.tar.gz: cdc6b6d1ffd33421f54ff48d73c43f69926505f8686c82cf9c0f8734766bd35e
+  metadata.gz: c3a110ddc9f31ad566bce549f84ef6b216a395d9201e02747f1e062d89406f07
+  data.tar.gz: 40fcfdf62082cf07a8e7e19455fd9398567e6ace96be7426165d27309f0ef29e
 SHA512:
-  metadata.gz: 6958eebf303bac9ca6eb09a41a16c8db0b885f23b2e6b52c1f8f711c6e1e5406429d4c12a77f5ecf012f4b9c8a2c349f8721312df95ae733fc3960a08b5ea523
-  data.tar.gz: 1aab7f0ee631c4447e0ad396821e81bbb623777e8205b55544492d3b4ae13806733aaecbb5efdaae144a8df8217354369c133668b0cc82b0036c24e93e5194b7
+  metadata.gz: c9a19af8c3f5c210d01d8aa9dcdee7e2ad76018050cf7df70ca3bc04a85089702a8ec32b14eab38701e48ffa2306880333e5fd2309e109fb83b720ea27041f33
+  data.tar.gz: bf7739b92e6685eb9bc62453eed18c7ba127faf29d42c15023b890632b4c2f3b8e1481e9fc3481b189b27a86dd39c04a57d08d5c00b46fe89b2a294ed807144e

data/README.md

@@ -2,7 +2,7 @@
 
 From bare metal to cloud VMs, deploy web apps anywhere with zero downtime. dash uses [dash-proxy](https://github.com/zoolutions/dash-proxy) to seamlessly switch requests between containers, load-balance across multiple hosts, batch SAN certificates, and issue wildcard certs via DNS-01. Works across multiple servers, using SSHKit to execute commands. Originally built for Rails apps, dash works with any type of web app that can be containerized with Docker.
 
-dash began as a fork of [basecamp/kamal](https://github.com/basecamp/kamal) and made a clean break in 2026 — it ships the features upstream wouldn't merge (proxy load balancing, readiness gates, response caching, traffic shaping, and more) and moves at its own pace. Existing kamal deployments upgrade in place: the on-server artifacts (`.kamal/` directory, `kamal-proxy` container, `KAMAL_*` secrets) are unchanged.
+dash began as a fork of [basecamp/kamal](https://github.com/basecamp/kamal) and made a clean break in 2026 — it ships the features upstream wouldn't merge (proxy load balancing, readiness gates, response caching, traffic shaping, and more) and moves at its own pace. Existing kamal deployments upgrade in place: the on-server artifacts (`.kamal/` directory, `kamal-proxy` container) are unchanged, `KAMAL_*` env vars are still set alongside their `DASH_*` twins, and a `.kamal/` directory in your own repo is still read — `dash migrate` moves it to `.dash/` when you're ready.
 
 ## Installation
 

data/bin/dash

@@ -3,10 +3,10 @@
 # Prevent failures from being reported twice.
 Thread.report_on_exception = false
 
-require "kamal"
+require "dash"
 
 begin
-  Kamal::Cli::Main.start(ARGV)
+  Dash::Cli::Main.start(ARGV)
 rescue SSHKit::Runner::ExecuteError => e
   puts "  \e[31mERROR (#{e.cause.class}): #{e.message}\e[0m"
   puts e.cause.backtrace if ENV["VERBOSE"]

data/lib/{kamal → dash}/cli/accessory.rb

@@ -1,12 +1,12 @@
 require "active_support/core_ext/array/conversions"
 require "concurrent/array"
 
-class Kamal::Cli::Accessory < Kamal::Cli::Base
+class Dash::Cli::Accessory < Dash::Cli::Base
   desc "boot [NAME]", "Boot new accessory service on host (use NAME=all to boot all accessories)"
   def boot(name, prepare: true)
     modify(lock: true) do
       if name == "all"
-        KAMAL.accessory_names.each { |accessory_name| boot(accessory_name) }
+        DASH.accessory_names.each { |accessory_name| boot(accessory_name) }
       else
         prepare(name) if prepare
 
@@ -25,7 +25,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
           upload(name)
 
           on(hosts) do |host|
-            execute *KAMAL.auditor.record("Booted #{name} accessory"), verbosity: :debug
+            execute *DASH.auditor.record("Booted #{name} accessory"), verbosity: :debug
             execute *accessory.ensure_env_directory
             upload! accessory.secrets_io, accessory.secrets_path, mode: "0600"
             execute *accessory.run(host: host)
@@ -78,7 +78,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
   def reboot(name)
     modify(lock: true) do
       if name == "all"
-        KAMAL.accessory_names.each { |accessory_name| reboot(accessory_name) }
+        DASH.accessory_names.each { |accessory_name| reboot(accessory_name) }
       else
         prepare(name)
         pull_image(name)
@@ -94,7 +94,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     modify(lock: true) do
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.auditor.record("Started #{name} accessory"), verbosity: :debug
+          execute *DASH.auditor.record("Started #{name} accessory"), verbosity: :debug
           execute *accessory.start
           if accessory.running_proxy?
             target = capture_with_info(*accessory.container_id_for(container_name: accessory.service_name, only_running: true)).strip
@@ -110,7 +110,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     modify(lock: true) do
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.auditor.record("Stopped #{name} accessory"), verbosity: :debug
+          execute *DASH.auditor.record("Stopped #{name} accessory"), verbosity: :debug
           execute *accessory.stop, raise_on_non_zero_exit: false
 
           if accessory.running_proxy?
@@ -134,7 +134,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
   def details(name)
     quiet = options[:quiet]
     if name == "all"
-      KAMAL.accessory_names.each { |accessory_name| details(accessory_name) }
+      DASH.accessory_names.each { |accessory_name| details(accessory_name) }
     else
       type = "Accessory #{name}"
       with_accessory(name) do |accessory, hosts|
@@ -157,7 +157,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     with_raw_output(raw) do
       pre_connect_if_required
 
-      cmd = Kamal::Utils.join_commands(cmd)
+      cmd = Dash::Utils.join_commands(cmd)
       quiet = options[:quiet]
 
       with_accessory(name) do |accessory, hosts|
@@ -168,21 +168,21 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
 
         when options[:interactive]
           say "Launching interactive command via SSH from new container...", :magenta
-          on(accessory.hosts.first) { execute *KAMAL.registry.login }
+          on(accessory.hosts.first) { execute *DASH.registry.login }
           run_locally { exec accessory.execute_in_new_container_over_ssh(cmd) }
 
         when options[:reuse]
           say "Launching command from existing container...", :magenta
           on(hosts) do |host|
-            execute *KAMAL.auditor.record("Executed cmd '#{cmd}' on #{name} accessory"), verbosity: :debug
+            execute *DASH.auditor.record("Executed cmd '#{cmd}' on #{name} accessory"), verbosity: :debug
             puts_by_host host, capture_with_info(*accessory.execute_in_existing_container(cmd), strip: !raw), quiet: quiet, raw: raw
           end
 
         else
           say "Launching command from new container...", :magenta
           on(hosts) do |host|
-            execute *KAMAL.registry.login
-            execute *KAMAL.auditor.record("Executed cmd '#{cmd}' on #{name} accessory"), verbosity: :debug
+            execute *DASH.registry.login
+            execute *DASH.auditor.record("Executed cmd '#{cmd}' on #{name} accessory"), verbosity: :debug
             puts_by_host host, capture_with_info(*accessory.execute_in_new_container(cmd), strip: !raw), quiet: quiet, raw: raw
           end
         end
@@ -225,7 +225,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     modify(lock: true) do
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.auditor.record("Pull #{name} accessory image"), verbosity: :debug
+          execute *DASH.auditor.record("Pull #{name} accessory image"), verbosity: :debug
           execute *accessory.pull_image
         end
       end
@@ -238,7 +238,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     confirming "This will remove all containers, images and data directories for #{name}. Are you sure?" do
       modify(lock: true) do
         if name == "all"
-          KAMAL.accessory_names.each { |accessory_name| remove_accessory(accessory_name) }
+          DASH.accessory_names.each { |accessory_name| remove_accessory(accessory_name) }
         else
           remove_accessory(name)
         end
@@ -251,7 +251,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     modify(lock: true) do
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.auditor.record("Remove #{name} accessory container"), verbosity: :debug
+          execute *DASH.auditor.record("Remove #{name} accessory container"), verbosity: :debug
           execute *accessory.remove_container
         end
       end
@@ -263,7 +263,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     modify(lock: true) do
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.auditor.record("Removed #{name} accessory image"), verbosity: :debug
+          execute *DASH.auditor.record("Removed #{name} accessory image"), verbosity: :debug
           execute *accessory.remove_image
         end
       end
@@ -287,10 +287,10 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
   def upgrade(name)
     confirming "This will restart all accessories" do
       modify(lock: true) do
-        host_groups = options[:rolling] ? KAMAL.accessory_hosts : [ KAMAL.accessory_hosts ]
+        host_groups = options[:rolling] ? DASH.accessory_hosts : [ DASH.accessory_hosts ]
         host_groups.each do |hosts|
           host_list = Array(hosts).join(",")
-          KAMAL.with_specific_hosts(hosts) do
+          DASH.with_specific_hosts(hosts) do
             say "Upgrading #{name} accessories on #{host_list}...", :magenta
             reboot name
             say "Upgraded #{name} accessories on #{host_list}...", :magenta
@@ -302,8 +302,8 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
 
   private
     def with_accessory(name)
-      if KAMAL.config.accessory(name)
-        accessory = KAMAL.accessory(name)
+      if DASH.config.accessory(name)
+        accessory = DASH.accessory(name)
         yield accessory, accessory_hosts(accessory)
       else
         error_on_missing_accessory(name)
@@ -311,7 +311,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     end
 
     def error_on_missing_accessory(name)
-      options = KAMAL.accessory_names.presence
+      options = DASH.accessory_names.presence
 
       error \
         "No accessory by the name of '#{name}'" +
@@ -319,7 +319,7 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     end
 
     def accessory_hosts(accessory)
-      KAMAL.accessory_hosts & accessory.hosts
+      DASH.accessory_hosts & accessory.hosts
     end
 
     def remove_accessory(name)
@@ -332,8 +332,8 @@ class Kamal::Cli::Accessory < Kamal::Cli::Base
     def prepare(name)
       with_accessory(name) do |accessory, hosts|
         on(hosts) do
-          execute *KAMAL.registry.login(registry_config: accessory.registry)
-          execute *KAMAL.docker.create_network
+          execute *DASH.registry.login(registry_config: accessory.registry)
+          execute *DASH.docker.create_network
         rescue SSHKit::Command::Failed => e
           raise unless e.message.include?("already exists")
         end

data/lib/dash/cli/alias/command.rb

@@ -0,0 +1,10 @@
+class Dash::Cli::Alias::Command < Thor::DynamicCommand
+  def run(instance, args = [])
+    if (command = DASH.resolve_alias(name))
+      DASH.reset
+      Dash::Cli::Main.start(Shellwords.split(command) + ARGV[1..-1])
+    else
+      super
+    end
+  end
+end

data/lib/{kamal → dash}/cli/app/assets.rb

@@ -1,4 +1,4 @@
-class Kamal::Cli::App::Assets
+class Dash::Cli::App::Assets
   attr_reader :host, :role, :sshkit
   delegate :execute, :capture_with_info, :info, to: :sshkit
   delegate :assets?, to: :role
@@ -19,6 +19,6 @@ class Kamal::Cli::App::Assets
 
   private
     def app
-      @app ||= KAMAL.app(role: role, host: host)
+      @app ||= DASH.app(role: role, host: host)
     end
 end

data/lib/{kamal → dash}/cli/app/boot.rb

@@ -1,4 +1,4 @@
-class Kamal::Cli::App::Boot
+class Dash::Cli::App::Boot
   attr_reader :host, :role, :version, :barrier, :sshkit, :cli
   delegate :execute, :capture_with_info, :capture_with_pretty_json, :info, :error, :upload!, to: :sshkit
   delegate :run_hook, to: :cli
@@ -55,14 +55,14 @@ class Kamal::Cli::App::Boot
       execute *app.run(hostname: hostname)
       if running_proxy?
         endpoint = capture_with_info(*app.container_id_for_version(version)).strip
-        raise Kamal::Cli::BootError, "Failed to get endpoint for #{role} on #{host}, did the container boot?" if endpoint.empty?
+        raise Dash::Cli::BootError, "Failed to get endpoint for #{role} on #{host}, did the container boot?" if endpoint.empty?
 
         run_hook "pre-proxy-deploy", hosts: host.to_s, role: role.name
-        info "Deploying #{role} on #{host} via kamal-proxy (waiting up to #{KAMAL.config.deploy_timeout}s for it to become healthy)..."
+        info "Deploying #{role} on #{host} via kamal-proxy (waiting up to #{DASH.config.deploy_timeout}s for it to become healthy)..."
         execute *app.deploy(target: endpoint)
         run_hook "post-proxy-deploy", hosts: host.to_s, role: role.name
       else
-        Kamal::Cli::Healthcheck::Poller.wait_for_healthy(role: role) { health_status }
+        Dash::Cli::Healthcheck::Poller.wait_for_healthy(role: role) { health_status }
       end
     rescue => e
       error "Failed to boot #{role} on #{host}"
@@ -104,48 +104,48 @@ class Kamal::Cli::App::Boot
       run_stop_hook "post-app-stop", old_version
 
       execute *app.clean_up_assets if assets?
-      execute *app.clean_up_error_pages if KAMAL.config.error_pages_path
+      execute *app.clean_up_error_pages if DASH.config.error_pages_path
     end
 
     # The new version is already live by the time the old one is stopped, so a failing
     # drain hook must not fail the deploy — warn and stop the old container anyway.
     def run_stop_hook(hook, old_version)
       run_hook hook, hosts: host.to_s, role: role.name, version: old_version
-    rescue Kamal::Cli::HookError => e
+    rescue Dash::Cli::HookError => e
       error "#{e.message}\nContinuing anyway: #{version} is already live for #{role} on #{host}."
     end
 
     def release_barrier
       if barrier.open
-        info "First #{KAMAL.primary_role} container is healthy on #{host}, booting any other roles"
+        info "First #{DASH.primary_role} container is healthy on #{host}, booting any other roles"
       end
     end
 
     def wait_at_barrier
-      info "Waiting for the first healthy #{KAMAL.primary_role} container before booting #{role} on #{host}..."
+      info "Waiting for the first healthy #{DASH.primary_role} container before booting #{role} on #{host}..."
       barrier.wait
-      info "First #{KAMAL.primary_role} container is healthy, booting #{role} on #{host}..."
-    rescue Kamal::Cli::Healthcheck::Error
-      info "First #{KAMAL.primary_role} container is unhealthy, not booting #{role} on #{host}"
+      info "First #{DASH.primary_role} container is healthy, booting #{role} on #{host}..."
+    rescue Dash::Cli::Healthcheck::Error
+      info "First #{DASH.primary_role} container is unhealthy, not booting #{role} on #{host}"
       raise
     end
 
     def close_barrier
       if barrier.close
-        info "First #{KAMAL.primary_role} container is unhealthy on #{host}, not booting any other roles"
+        info "First #{DASH.primary_role} container is unhealthy on #{host}, not booting any other roles"
       end
     end
 
     def barrier_role?
-      role == KAMAL.primary_role
+      role == DASH.primary_role
     end
 
     def app
-      @app ||= KAMAL.app(role: role, host: host)
+      @app ||= DASH.app(role: role, host: host)
     end
 
     def auditor
-      @auditor = KAMAL.auditor(role: role)
+      @auditor = DASH.auditor(role: role)
     end
 
     def audit(message)

data/lib/{kamal → dash}/cli/app/error_pages.rb

@@ -1,4 +1,4 @@
-class Kamal::Cli::App::ErrorPages
+class Dash::Cli::App::ErrorPages
   ERROR_PAGES_GLOB = "{4??.html,5??.html}"
 
   attr_reader :host, :sshkit
@@ -10,10 +10,10 @@ class Kamal::Cli::App::ErrorPages
   end
 
   def run
-    if KAMAL.config.error_pages_path
+    if DASH.config.error_pages_path
       with_error_pages_tmpdir do |local_error_pages_dir|
-        execute *KAMAL.app.create_error_pages_directory
-        upload! local_error_pages_dir, KAMAL.config.proxy_boot.error_pages_directory, mode: "0700", recursive: true
+        execute *DASH.app.create_error_pages_directory
+        upload! local_error_pages_dir, DASH.config.proxy_boot.error_pages_directory, mode: "0700", recursive: true
       end
     end
   end
@@ -21,10 +21,10 @@ class Kamal::Cli::App::ErrorPages
   private
     def with_error_pages_tmpdir
       Dir.mktmpdir("kamal-error-pages") do |tmpdir|
-        error_pages_dir = File.join(tmpdir, KAMAL.config.version)
+        error_pages_dir = File.join(tmpdir, DASH.config.version)
         FileUtils.mkdir(error_pages_dir)
 
-        if (files = Dir[File.join(KAMAL.config.error_pages_path, ERROR_PAGES_GLOB)]).any?
+        if (files = Dir[File.join(DASH.config.error_pages_path, ERROR_PAGES_GLOB)]).any?
           FileUtils.cp(files, error_pages_dir)
           yield error_pages_dir
         end

data/lib/{kamal → dash}/cli/app/rollout_boot.rb

@@ -1,4 +1,4 @@
-class Kamal::Cli::App::RolloutBoot
+class Dash::Cli::App::RolloutBoot
   attr_reader :host, :role, :version, :sshkit
   delegate :execute, :capture_with_info, :error, :upload!, to: :sshkit
 
@@ -18,7 +18,7 @@ class Kamal::Cli::App::RolloutBoot
       stop_rollout_target
       raise
     end
-  rescue Kamal::Cli::BootError => e
+  rescue Dash::Cli::BootError => e
     error e.message
     raise
   end
@@ -26,7 +26,7 @@ class Kamal::Cli::App::RolloutBoot
   private
     def ensure_not_already_deployed
       if capture_with_info(*app.container_id_for_version(version), raise_on_non_zero_exit: false).present?
-        raise Kamal::Cli::BootError, "Version #{version} is already deployed for #{role} on #{host}, roll out a different version"
+        raise Dash::Cli::BootError, "Version #{version} is already deployed for #{role} on #{host}, roll out a different version"
       end
     end
 
@@ -40,7 +40,7 @@ class Kamal::Cli::App::RolloutBoot
       execute *app.run(hostname: hostname)
 
       endpoint = capture_with_info(*app.container_id_for_version(version)).strip
-      raise Kamal::Cli::BootError, "Failed to get endpoint for #{role} on #{host}, did the container boot?" if endpoint.empty?
+      raise Dash::Cli::BootError, "Failed to get endpoint for #{role} on #{host}, did the container boot?" if endpoint.empty?
 
       execute *app.rollout_deploy(target: endpoint)
     end
@@ -50,10 +50,10 @@ class Kamal::Cli::App::RolloutBoot
     end
 
     def app
-      @app ||= KAMAL.app(role: role, host: host)
+      @app ||= DASH.app(role: role, host: host)
     end
 
     def audit(message)
-      execute *KAMAL.auditor(role: role).record(message), verbosity: :debug
+      execute *DASH.auditor(role: role).record(message), verbosity: :debug
     end
 end

data/lib/{kamal → dash}/cli/app/ssl_certificates.rb

@@ -1,4 +1,4 @@
-class Kamal::Cli::App::SslCertificates
+class Dash::Cli::App::SslCertificates
   attr_reader :host, :role, :sshkit
   delegate :execute, :info, :upload!, to: :sshkit
 
@@ -24,7 +24,7 @@ class Kamal::Cli::App::SslCertificates
     end
 
     # The client CA arrives the same way the server certificate does: as
-    # secret content named in .kamal/secrets, resolved here at upload time.
+    # secret content named in .dash/secrets, resolved here at upload time.
     if role.proxy.client_ca?
       upload!(StringIO.new(role.proxy.client_ca_pem_content), role.proxy.host_client_ca, mode: "0644")
     end
@@ -32,6 +32,6 @@ class Kamal::Cli::App::SslCertificates
 
   private
     def app
-      @app ||= KAMAL.app(role: role, host: host)
+      @app ||= DASH.app(role: role, host: host)
     end
 end