kamal-backup 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7135af9b16454829f69ed19ca84d58045232e5db583cc54cbc1fe623bf80c4f6
-  data.tar.gz: 8f70a9143faec5b730e3e9d70a33b4bed4f1f650815f81c97c303766151fd2af
+  metadata.gz: 9a38b68b938b1d5d96996c2e0271cdff8e914600b8d134e39a0717aa8290bca7
+  data.tar.gz: 0451f17fefb476958074c0c11e37a4c0a020b8b4e6bf3fa352296369326a7925
 SHA512:
-  metadata.gz: a919c1e57b6061ce588bd73d00b87eeff13e7b312b3da1bf05d8263116eadc119facc2fedadcba62d21a4d0983835bb52b89486eb13beeeffb3673588ec39845
-  data.tar.gz: 64739bbaac082b4266d37b2dfbd70d4ad53c7010a825a037126ff4b9cfb828c0968d2dd1045c25cd82fab5371864a2405c10c0edee99152948131f8d8112bf38
+  metadata.gz: 9f3e92a83c2ead4ed47136253c730cfd5f47938f490de04b2d48df91a7673a3b4ac08e4eda0d951fa83dab3215b544e8f060d68b4285dd9f042323267a08cd5c
+  data.tar.gz: 899dfd47d6cefc53f87a72ca53ddda721bcf9c55ef019236b12a26bd56def82b5665c26958c5e8444a5168023ee49d0a51d17a632ac44e5db3f61861cb9518b7

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: it shows both versions and the sync status.
+
 Common examples:
 
 ```sh

data/lib/kamal_backup/cli.rb

@@ -54,7 +54,13 @@ module KamalBackup
         @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 +69,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]
 
@@ -345,7 +377,7 @@ module KamalBackup
     desc "version", "Print the running kamal-backup version"
     def version
       if deployment_mode?
-        exec_remote(["kamal-backup", "version"])
+        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.1"
 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.1
 platform: ruby
 authors:
 - crmne