puma-redeploy 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71217e13019896c5b071db53e1b149ddb34d5dd5cf98eb5cd2da7f189c335f6a
-  data.tar.gz: 32b87f0dd6e54ca89bc0be6032d60c37fb6e88f6fd58eae15e25cb4bc13aebad
+  metadata.gz: 65da7c1d7658a5e9bc5e955e5c3392dce1c9300ae20cfec2220e60f15804fb0b
+  data.tar.gz: 984a126a32edbf6289aeda36855d801923ab54f4b959b561eb8b41d1e08bba93
 SHA512:
-  metadata.gz: bcf4d8732453d835c898595bff21c84a31d8b1f5b30f5cf9a46f1f6c33d3e5dfdf4fcbcc9416a698caa70acb17b4fa319144e3a8e0f3f85af944e5d914ba1ab8
-  data.tar.gz: e7bbea1217f1eaa8f1bab4d3d0d4d9a798f477d42a28fe79b682251b8e3dd0f5525e4a63aea3dfec880e20c182060dbc81e4b72c05eea53e539f29bcc84ad6d7
+  metadata.gz: 6988a62ccf3b83669e8f4e4e361bc48b062f1df6c7cc704903034dac9385f29c6648faaf04393ac88f9a78fa83301ec6820c74043237baa52d99536987a3ba4f
+  data.tar.gz: c962806cc92fe13e2b14aae40cd0d9413b14fb249c3eb72f106686b143217e08e40fb2e49068ea15a1be7893a5248ca79e0c6ef3c86bff5c29ddf026414b2be6

data/.github/workflows/publish_gem.yml

@@ -1,4 +1,4 @@
-name: Build and publish gem to github package
+name: Build and Publish Gem
 
 on:
   workflow_dispatch:

data/.gitignore

@@ -11,3 +11,5 @@
 .rspec_status
 Gemfile.lock
 .DS_Store
+archive.1.0.0.zip
+watch.me

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.1
   DisplayCopNames: true
   SuggestExtensions: false
   NewCops: enable
@@ -20,3 +20,18 @@ Metrics/MethodLength:
 
 RSpec/NestedGroups:
   Max: 4
+
+RSpec/MultipleMemoizedHelpers:
+  Max: 12
+
+RSpec/ExampleLength:
+  Max: 6
+
+RSpec/ExpectInHook:
+  Enabled: false
+
+RSpec/StubbedMock:
+  Enabled: false
+
+RSpec/MessageSpies:
+  Enabled: false

data/CHANGELOG.md

@@ -1,12 +1,24 @@
 
 # Changelog
 
-## v0.1.1 (NEXT)
+## v0.2.x (NEXT)
 
 **Features:**
 
-- Your contribution here
+**Fixes and enhancements:**
+
+## v0.2.1
+
+**Features:**
+
+- Add support for S3 handler
+
+**Fixes and enhancements:**
+
+- Refactor file handler to use new base handler class
+
+## v0.1.1
 
 **Fixes and enhancements:**
 
-- Add CHANGELOG.md
+- Initial File based handler support

data/README.md

@@ -6,12 +6,13 @@ Key Points:
 * Encourages the separation of the build process from deployment
 * Leverages Puma [phased-restart](https://github.com/puma/puma/blob/master/docs/restart.md#phased-restart) to ensure uptime deploy
 * Deploys in seconds
+* Plugable handlers to detect redeploy (File, S3, Artifactory, etc..)
 
 
 ![image](https://user-images.githubusercontent.com/121275/219976698-80575b17-17b7-4861-8c10-675f3f615e25.png)
 
 
-Example application can be found [here](https://github.com/tbeauvais/sinatra-api-base)
+Example application can be found [here](https://github.com/tbeauvais/puma-redeploy-test-app)
 
 
 ## Installation
@@ -40,16 +41,23 @@ plugin :redeploy
 
 # specify the redeploy watch file
 redeploy_watch_file './watch_me'
+# For S3 this must be a S3 URL
+redeploy_watch_file 's3://puma-test-app-archives/watch.me'
 
 # Specify the number of seconds between checking watch file. Defaults to 30.
 redeploy_watch_delay 15
 
 ```
 
-The watch file must contain the path to the current archive.
-For example:
+The watch file must contain the path to the current archive. This can be a file path or S3 URL.
+For example when using a file:
 ```
-/sinatra_test/pkg/my_application_0.0.1.zip
+/sinatra_test/pkg/test_app_0.0.1.zip
+```
+
+For example when using S3:
+```
+s3://puma-test-app-archives/test_app_0.0.1.zip
 ```
 
 ## Development

data/bin/load_archive

@@ -6,8 +6,8 @@ require 'puma-redeploy'
 require 'logger'
 
 def deploy_archive(app_dir, watch_file, logger)
-  handler = Puma::Redeploy::DeployerFactory.create(target: app_dir, watch_file: watch_file,
-                                                   logger: logger)
+  handler = Puma::Redeploy::DeployerFactory.create(target: app_dir, watch_file:,
+                                                   logger:)
   handler.deploy(source: handler.archive_file)
 end
 
@@ -17,14 +17,10 @@ if ARGV.size != 2
   logger.error 'You must specify the application directory and watch file'
   logger.info 'load_archive <app directory> <watch file>'
   logger.info 'e.g. load_archive /app /build/pkg/watch.me'
+  exit(1)
 end
 
 app_dir = ARGV[0]
 watch_file = ARGV[1]
 
-if File.exist?(watch_file) && Dir.exist?(app_dir)
-  deploy_archive(app_dir, watch_file, logger)
-else
-  logger.error "watch_file #{watch_file} does not exist" unless File.exist?(watch_file)
-  logger.error "app_dir #{app_dir} does not exist" unless Dir.exist?(app_dir)
-end
+deploy_archive(app_dir, watch_file, logger)

data/lib/puma/plugin/redeploy.rb

@@ -13,8 +13,8 @@ Puma::Plugin.create do
     in_background do
       logger = launcher.options[:redeploy_logger] || Logger.new($stdout)
       watch_file = launcher.options[:redeploy_watch_file]
-      handler = Puma::Redeploy::DeployerFactory.create(target: launcher.restart_dir, watch_file: watch_file,
-                                                       logger: logger)
+      handler = Puma::Redeploy::DeployerFactory.create(target: launcher.restart_dir, watch_file:,
+                                                       logger:)
 
       delay = launcher.options[:redeploy_watch_delay] || 30
       monitor_loop(handler, delay, launcher, logger)

data/lib/puma/redeploy/base_handler.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module Puma
+  module Redeploy
+    # base redeploy handler
+    class BaseHandler
+      extend Forwardable
+      attr_reader :watch_file
+
+      def initialize(watch_file:, deployer:, logger:)
+        @watch_file = watch_file
+        @logger = logger
+        @deployer = deployer
+      end
+
+      def needs_redeploy?
+        return false unless (mtime = touched_at) != @touched_at
+
+        @touched_at = mtime
+        true
+      end
+
+      def_delegators :@deployer, :deploy
+
+      private
+
+      attr_accessor :logger
+    end
+  end
+end

data/lib/puma/redeploy/deployer_factory.rb

@@ -2,11 +2,19 @@
 
 module Puma
   module Redeploy
-    # Creates instance if deployer implementation
+    # Creates instance of the redeploy handler based on the watch file location
     class DeployerFactory
       def self.create(target:, watch_file:, logger:)
-        file_deployer = Puma::Redeploy::FileDeployer.new(target: target, logger: logger)
-        Puma::Redeploy::FileHandler.new(watch_file: watch_file, deployer: file_deployer, logger: logger)
+        file_deployer = Puma::Redeploy::ZipDeployer.new(target:, logger:)
+        if watch_file.start_with?('s3')
+          Puma::Redeploy::S3Handler.new(watch_file:, deployer: file_deployer, logger:, s3_client:)
+        else
+          Puma::Redeploy::FileHandler.new(watch_file:, deployer: file_deployer, logger:)
+        end
+      end
+
+      def self.s3_client
+        Aws::S3::Client.new
       end
     end
   end

data/lib/puma/redeploy/file_handler.rb

@@ -5,33 +5,18 @@ require 'forwardable'
 module Puma
   module Redeploy
     # file based redeploy handler
-    class FileHandler
-      extend Forwardable
-      attr_reader :watch_file
-
+    class FileHandler < BaseHandler
       def initialize(watch_file:, deployer:, logger:)
-        @watch_file = watch_file
-        @logger = logger
+        super
         @touched_at = touched_at
-        @deployer = deployer
-      end
-
-      def_delegators :@deployer, :deploy
-      def needs_redeploy?
-        return false unless (mtime = touched_at) != @touched_at
-
-        @touched_at = mtime
-        true
       end
 
       def archive_file
-        File.read(watch_file)&.strip
+        File.read(watch_file).strip
       end
 
       private
 
-      attr_accessor :logger
-
       def touched_at
         if File.exist?(watch_file)
           File.mtime(watch_file)

data/lib/puma/redeploy/s3_handler.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'aws-sdk-s3'
+
+module Puma
+  module Redeploy
+    # S3 based redeploy handler
+    class S3Handler < BaseHandler
+      attr_reader :bucket_name, :object_key, :s3_client
+
+      def initialize(watch_file:, deployer:, logger:, s3_client:)
+        super(watch_file:, deployer:, logger:)
+        @s3_client = s3_client
+        @bucket_name, @object_key = s3_object_reference(watch_file)
+        @touched_at = touched_at
+      end
+
+      def archive_file
+        s3_url = read_watch_object
+        archive_bucket_name, archive_object_key = s3_object_reference(s3_url)
+
+        response = s3_client.get_object(bucket: archive_bucket_name, key: archive_object_key)
+
+        file_name = local_file_path(archive_object_key)
+        # Write the object data to a local file
+        File.binwrite(file_name, response.body.read)
+        file_name
+      end
+
+      private
+
+      def s3_object_reference(watch_file)
+        s3_uri = URI.parse(watch_file)
+        [s3_uri.host, s3_uri.path[1..]]
+      end
+
+      def local_file_path(object_key)
+        File.basename(object_key)
+      end
+
+      def read_watch_object
+        # Get the object data from S3
+        object = s3_client.get_object(bucket: bucket_name, key: object_key)
+
+        object.body.read.strip
+      end
+
+      def touched_at
+        head_object = s3_client.head_object(bucket: bucket_name, key: object_key)
+
+        if head_object
+          head_object.last_modified
+        else
+          logger.info "The S3 object #{bucket_name}/#{object_key} does not exist"
+          0
+        end
+      end
+    end
+  end
+end

data/lib/puma/redeploy/version.rb

@@ -2,6 +2,6 @@
 
 module Puma
   module Redeploy
-    VERSION = '0.1.1'
+    VERSION = '0.2.1'
   end
 end

data/lib/puma/redeploy/{file_deployer.rb → zip_deployer.rb}

@@ -5,7 +5,7 @@ require 'open3'
 module Puma
   module Redeploy
     # Deploys zip archive
-    class FileDeployer
+    class ZipDeployer
       def initialize(target:, logger:)
         @target = target
         @logger = logger

data/lib/puma_redeploy.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-Dir.glob("#{__dir__}/puma/redeploy/**/*.rb").sort.each { |file| require file }
+Dir.glob("#{__dir__}/puma/redeploy/**/*.rb").each { |file| require file }
 
 module Puma
   module Redeploy

data/puma-redeploy.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
                        'will be pulled and the app will be reloaded.'
   spec.homepage      = 'https://github.com/tbeauvais/puma-redeploy'
   spec.license       = 'MIT'
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.7.0')
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.1.0')
 
   spec.executables = ['load_archive']
 
@@ -30,6 +30,8 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'bin'
   spec.require_paths = ['lib']
 
+  spec.add_runtime_dependency 'aws-sdk-s3', '~> 1.120.0'
+
   spec.add_development_dependency 'rake', '~> 13.0.6'
   spec.add_development_dependency 'rspec', '~> 3.12.0'
   spec.add_development_dependency 'rubocop', '~> 1.43'

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: puma-redeploy
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - tbeauvais
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-14 00:00:00.000000000 Z
+date: 2023-04-21 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-s3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.120.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.120.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -147,11 +161,13 @@ files:
 - bin/load_archive
 - lib/puma-redeploy.rb
 - lib/puma/plugin/redeploy.rb
+- lib/puma/redeploy/base_handler.rb
 - lib/puma/redeploy/deployer_factory.rb
 - lib/puma/redeploy/dsl.rb
-- lib/puma/redeploy/file_deployer.rb
 - lib/puma/redeploy/file_handler.rb
+- lib/puma/redeploy/s3_handler.rb
 - lib/puma/redeploy/version.rb
+- lib/puma/redeploy/zip_deployer.rb
 - lib/puma_redeploy.rb
 - puma-redeploy.gemspec
 homepage: https://github.com/tbeauvais/puma-redeploy
@@ -170,7 +186,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="