kamal-backup 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7135af9b16454829f69ed19ca84d58045232e5db583cc54cbc1fe623bf80c4f6
-  data.tar.gz: 8f70a9143faec5b730e3e9d70a33b4bed4f1f650815f81c97c303766151fd2af
+  metadata.gz: 67d289224a384dc9f1546799c15b1bf69649060d49ff8018869b098924104704
+  data.tar.gz: 4307158e1472c2aeafbab424fbb1d2af50a1a1cc6a43b2b11ea6dfae5e3b1d42
 SHA512:
-  metadata.gz: a919c1e57b6061ce588bd73d00b87eeff13e7b312b3da1bf05d8263116eadc119facc2fedadcba62d21a4d0983835bb52b89486eb13beeeffb3673588ec39845
-  data.tar.gz: 64739bbaac082b4266d37b2dfbd70d4ad53c7010a825a037126ff4b9cfb828c0968d2dd1045c25cd82fab5371864a2405c10c0edee99152948131f8d8112bf38
+  metadata.gz: cba47d9ebf7771e7513e24ca6e7c1d30c5bc3660caeb6ab0f4ed945203baadf370778af5b887a7eb39a82664709f9210179c847c1983d29318befe03abe0e8fa
+  data.tar.gz: ff55565395d49eca645732276db416aa2f240b7511468f7d96296821c776937404862835ba977bd7005efba7ea91fb2269f7e7b0f7f4db7e751cb1b375da9ea2

data/README.md

@@ -145,6 +145,8 @@ kamal-backup version
 
 Production-side commands shell out through Kamal when you pass `-d` or `-c`. Local commands run on your machine.
 
+Remote-backed commands require the local gem version and the backup accessory version to match. If they drift, `kamal-backup` fails fast and tells you to reboot the accessory so it pulls the current `latest` image. `version` is the diagnostic exception: from an app checkout with `config/deploy.yml`, it shows both versions and the sync status even without `-d`.
+
 Common examples:
 
 ```sh

data/lib/kamal_backup/cli.rb

@@ -50,11 +50,25 @@ module KamalBackup
         !options[:destination].to_s.strip.empty? || !options[:config_file].to_s.strip.empty?
       end
 
+      def default_deploy_config?
+        File.file?(File.expand_path(KamalBridge::DEFAULT_CONFIG_FILE))
+      end
+
+      def version_remote_mode?
+        deployment_mode? || default_deploy_config?
+      end
+
       def accessory_name
         @accessory_name ||= bridge.accessory_name(preferred: local_preferences.accessory_name)
       end
 
-      def exec_remote(argv)
+      def remote_version
+        @remote_version ||= bridge.remote_version(accessory_name: accessory_name)
+      end
+
+      def exec_remote(argv, require_version_match: true)
+        ensure_remote_version_match! if require_version_match
+
         result = bridge.execute_on_accessory(
           accessory_name: accessory_name,
           command: Shellwords.join(argv)
@@ -63,6 +77,32 @@ module KamalBackup
         result
       end
 
+      def ensure_remote_version_match!
+        return if remote_version == VERSION
+
+        raise ConfigurationError, <<~MESSAGE.strip
+          local gem version #{VERSION} does not match remote accessory version #{remote_version}.
+          Reboot the backup accessory to pick up the latest image:
+          #{accessory_reboot_command}
+        MESSAGE
+      end
+
+      def accessory_reboot_command
+        argv = ["bin/kamal", "accessory", "reboot", accessory_name]
+        argv.concat(["-c", options[:config_file]]) if options[:config_file]
+        argv.concat(["-d", options[:destination]]) if options[:destination]
+        Shellwords.join(argv)
+      end
+
+      def print_remote_version_status
+        status = remote_version == VERSION ? "in sync" : "out of sync"
+
+        puts("local: #{VERSION}")
+        puts("remote: #{remote_version}")
+        puts("status: #{status}")
+        puts("fix: #{accessory_reboot_command}") if status == "out of sync"
+      end
+
       def confirm!(message)
         return if options[:yes]
 
@@ -344,8 +384,8 @@ module KamalBackup
 
     desc "version", "Print the running kamal-backup version"
     def version
-      if deployment_mode?
-        exec_remote(["kamal-backup", "version"])
+      if version_remote_mode?
+        print_remote_version_status
       else
         puts(VERSION)
       end

data/lib/kamal_backup/kamal_bridge.rb

@@ -46,6 +46,17 @@ module KamalBackup
       capture_kamal(kamal_exec_argv(accessory_name, command))
     end
 
+    def remote_version(accessory_name:)
+      result = execute_on_accessory(accessory_name: accessory_name, command: "kamal-backup version")
+      version = result.stdout.to_s.strip
+
+      if version.empty?
+        raise ConfigurationError, "could not determine remote kamal-backup version from accessory #{accessory_name}"
+      else
+        version
+      end
+    end
+
     private
       def config
         @config ||= begin

data/lib/kamal_backup/version.rb

@@ -1,3 +1,3 @@
 module KamalBackup
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kamal-backup
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - crmne