puma-redeploy 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65da7c1d7658a5e9bc5e955e5c3392dce1c9300ae20cfec2220e60f15804fb0b
-  data.tar.gz: 984a126a32edbf6289aeda36855d801923ab54f4b959b561eb8b41d1e08bba93
+  metadata.gz: 9ed0d1a89c2ce26afe253893f3a716e346edb7b7bfe109c0acf6c1cc2599db23
+  data.tar.gz: 39a7a76965ca098d9dcfb0586d5d96f3c47326fafd4aa22b3a6a9f68d7358e4b
 SHA512:
-  metadata.gz: 6988a62ccf3b83669e8f4e4e361bc48b062f1df6c7cc704903034dac9385f29c6648faaf04393ac88f9a78fa83301ec6820c74043237baa52d99536987a3ba4f
-  data.tar.gz: c962806cc92fe13e2b14aae40cd0d9413b14fb249c3eb72f106686b143217e08e40fb2e49068ea15a1be7893a5248ca79e0c6ef3c86bff5c29ddf026414b2be6
+  metadata.gz: dfd1f53e8d88ea177310c7797428f924ac4b865dcce699a6f299be86510a6d1b702b86fbc934cba9c727f3df6a2834194c6ecfde4b113b7a0ebf845b264989fc
+  data.tar.gz: c9bd80080b88819fbd3a03ec49cd8649fa80dbc6b10d15d2a2f063b97ed74aabb276aac02df48a6a1744033af0240be17ca95ef6b85a88626ff65f306e638575

data/CHANGELOG.md

@@ -1,9 +1,13 @@
-
 # Changelog
 
-## v0.2.x (NEXT)
+## v0.3.x (NEXT)
 
-**Features:**
+
+## v0.3.0
+
+**Breaking Changes:**
+- Rename load_archive to archive-loader
+- Add options flags to archive-loader
 
 **Fixes and enhancements:**
 

data/README.md

@@ -4,10 +4,12 @@ The puma-redeploy gem is a puma plugin that allows you to redeploy a new version
 
 Key Points:
 * Encourages the separation of the build process from deployment
+* Runtime container does not include application code
 * 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..)
+* Pluggable handlers to detect redeploy (File, S3, Artifactory, etc..)
 
+**Note** - Currently there are File and S3 handlers for loading archives.
 
 ![image](https://user-images.githubusercontent.com/121275/219976698-80575b17-17b7-4861-8c10-675f3f615e25.png)
 
@@ -39,10 +41,9 @@ Update your `config/puma.rb` config file with the following
 # Add the puma-redeploy plugin
 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 redeploy watch file from an environment variable. This can a file system location or S3 URL. For example `/app/pkg/watch.me` or `s3://puma-test-app-archives/watch.me`.
+redeploy_watch_file ENV['WATCH_FILE']
+
 
 # Specify the number of seconds between checking watch file. Defaults to 30.
 redeploy_watch_delay 15
@@ -50,14 +51,31 @@ redeploy_watch_delay 15
 ```
 
 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/test_app_0.0.1.zip
+/app/pkg/test_app_0.0.3.zip
 ```
 
 For example when using S3:
 ```
-s3://puma-test-app-archives/test_app_0.0.1.zip
+s3://puma-test-app-archives/test_app_0.0.3.zip
+```
+
+### Archive Loader
+The `archive-loader` is a cli used to fetch and deploy the application archive prior to starting the puma server. This is useful when the application code does not exist in the runtime container.
+
+```shell
+archive-loader
+Usage: archive-loader [options]. Used to load the archive prior to starting the puma app server.
+    -a, --app-dir=DIR                [Required] Location of application directory within the container.
+    -w, --watch=WATCH                [Required] Location of watch file (file or s3 location).
+    -h, --help                       Prints this help
+```
+
+For example this will fetch and unzip the application archive and then start puma.
+```shell
+archive-loader /app /app/pkg/watch.me && bundle exec puma -C config/puma.rb
 ```
 
 ## Development

data/bin/archive-loader

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require 'puma-redeploy'
+require 'logger'
+require 'optparse'
+
+def deploy_archive(app_dir, watch_file, logger)
+  handler = Puma::Redeploy::DeployerFactory.create(target: app_dir, watch_file:,
+                                                   logger:)
+  handler.deploy(source: handler.archive_file)
+end
+
+def option_parser(opts)
+  OptionParser.new do |o|
+    o.banner = 'Usage: archive-loader [options]. Used to load the archive prior to starting the puma app server.'
+
+    o.on '-a', '--app-dir=DIR', '[Required] Location of application directory within the container.' do |arg|
+      opts[:app_dir] = arg
+    end
+
+    o.on '-w', '--watch=WATCH', '[Required] Location of watch file (file or s3 location).' do |arg|
+      opts[:watch] = arg
+    end
+
+    o.on('-h', '--help', 'Prints this help') do
+      puts o
+      exit
+    end
+  end
+end
+
+def logger
+  Logger.new($stdout)
+end
+
+ops = {}
+parser = option_parser(ops)
+parser.parse!(ARGV)
+
+unless ops[:app_dir] && ops[:watch]
+  puts parser.help
+  exit 1
+end
+
+deploy_archive(ops[:app_dir], ops[:watch], logger)

data/lib/puma/redeploy/version.rb

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

data/puma-redeploy.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
   spec.license       = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 3.1.0')
 
-  spec.executables = ['load_archive']
+  spec.executables = ['archive-loader']
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/tbeauvais/puma-redeploy'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puma-redeploy
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - tbeauvais
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-21 00:00:00.000000000 Z
+date: 2023-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-s3
@@ -142,7 +142,7 @@ description: Puma plugin to redeploy and reload app from a remote artifact. This
 email:
 - tbeauvais1@gmail.com
 executables:
-- load_archive
+- archive-loader
 extensions: []
 extra_rdoc_files: []
 files:
@@ -158,7 +158,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/load_archive
+- bin/archive-loader
 - lib/puma-redeploy.rb
 - lib/puma/plugin/redeploy.rb
 - lib/puma/redeploy/base_handler.rb

data/bin/load_archive

@@ -1,26 +0,0 @@
-#!/usr/bin/env ruby
-
-# frozen_string_literal: true
-
-require 'puma-redeploy'
-require 'logger'
-
-def deploy_archive(app_dir, watch_file, logger)
-  handler = Puma::Redeploy::DeployerFactory.create(target: app_dir, watch_file:,
-                                                   logger:)
-  handler.deploy(source: handler.archive_file)
-end
-
-logger = Logger.new($stdout)
-
-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]
-
-deploy_archive(app_dir, watch_file, logger)