tomo-plugin-aws_sqs 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a5b782131008005080a7cc35ea61db18c311989ec26c702a3040c6ccc484ffeb
+  data.tar.gz: 6e00c8a1d411fe7397723c2f8155730dd75966382dff3862db24f44680658205
+SHA512:
+  metadata.gz: b7fbe9b9d6612f6df7ce13f8c79a24fc34365fd0a7522defc35a1759bd72b630a4b4187f5dd4779bb45b44ebd04e9db3933f0c5cff8ebad5b9012318b52b6f93
+  data.tar.gz: afa276555aefd9da584f933b249f6b375edfaac9d178307459e85adb11292506854097f094434b8ad7e3f7254c19a7804c2dcc079403effd4a67bea3c4223e54

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Matt Brictson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,143 @@
+# tomo-plugin-aws_sqs
+
+[![Gem Version](https://badge.fury.io/rb/tomo-plugin-aws_sqs.svg)](https://rubygems.org/gems/tomo-plugin-aws_sqs)
+[![Circle](https://circleci.com/gh/gauravtiwari/tomo-plugin-aws_sqs/tree/main.svg?style=shield)](https://app.circleci.com/pipelines/github/gauravtiwari/tomo-plugin-aws_sqs?branch=main)
+[![Code Climate](https://codeclimate.com/github/gauravtiwari/tomo-plugin-aws_sqs/badges/gpa.svg)](https://codeclimate.com/github/gauravtiwari/tomo-plugin-aws_sqs)
+
+This is a [tomo](https://github.com/mattbrictson/tomo) plugin that provides tasks for managing [aws_sqs](https://github.com/bensheldon/aws_sqs) via [systemd](https://en.wikipedia.org/wiki/Systemd), based on the recommendations in the aws_sqs documentation. This plugin assumes that you are also using the tomo `rbenv` and `env` plugins, and that you are using a systemd-based Linux distribution like Ubuntu 18 LTS.
+
+---
+
+- [Installation](#installation)
+- [Settings](#settings)
+- [Tasks](#tasks)
+- [Support](#support)
+- [License](#license)
+- [Code of conduct](#code-of-conduct)
+- [Contribution guide](#contribution-guide)
+
+## Installation
+
+Run:
+
+```
+$ gem install tomo-plugin-aws_sqs
+```
+
+Or add it to your Gemfile:
+
+```ruby
+gem "tomo-plugin-aws_sqs"
+```
+
+Then add the following to `.tomo/config.rb`:
+
+```ruby
+plugin "aws_sqs"
+
+setup do
+  # ...
+  run "aws_sqs:setup_systemd"
+end
+
+deploy do
+  # ...
+  # Place this task at *after* core:symlink_current
+  run "aws_sqs:restart"
+end
+```
+
+### enable-linger
+
+This plugin installs aws_sqs as a user-level service using systemctl --user. This allows aws_sqs to be installed, started, stopped, and restarted without a root user or sudo. However, when provisioning the host you must make sure to run the following command as root to allow the aws_sqs process to continue running even after the tomo deploy user disconnects:
+
+```
+# run as root
+$ loginctl enable-linger <DEPLOY_USER>
+```
+
+## Settings
+
+| Name                                     | Purpose                                                                                                                                                                                                         |
+| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `aws_sqs_systemd_service`               | Name of the systemd unit that will be used to manage good*job <br>**Default:** `"aws_sqs*%{application}.service"`                                                                                              |
+| `aws_sqs_systemd_service_path`          | Location where the systemd unit will be installed <br>**Default:** `".config/systemd/user/%{aws_sqs_systemd_service}"`
+| `aws_sqs_systemd_command`          | Command to run  <br>**Default:** `"bundle exec aws_sqs_active_job --queue default"`                                                                                         |
+| `aws_sqs_systemd_service_template_path` | Local path to the ERB template that will be used to create the systemd unit <br>**Default:** [service.erb](https://github.com/gauravtiwari/tomo-plugin-aws_sqs/blob/main/lib/tomo/plugin/aws_sqs/service.erb) |
+
+## Tasks
+
+### aws_sqs:setup_systemd
+
+Configures systemd to manage aws_sqs. This means that aws_sqs will automatically be restarted if it crashes, or if the host is rebooted. This task essentially does two things:
+
+1. Installs a `aws_sqs.service` systemd unit
+1. Enables it using `systemctl --user enable`
+
+Note that these units will be installed and run for the deploy user. You can use `:aws_sqs_systemd_service_template_path` to provide your own template and customize how aws_sqs and systemd are configured.
+
+`aws_sqs:setup_systemd` is intended for use as a [setup](https://tomo-deploy.com/commands/setup/) task. It must be run before aws_sqs can be started during a deploy.
+
+### aws_sqs:restart
+
+Gracefully restarts the aws_sqs service via systemd, or starts it if it isn't running already. Equivalent to:
+
+```
+systemctl --user restart aws_sqs.service
+```
+
+### aws_sqs:start
+
+Starts the aws_sqs service via systemd, if it isn't running already. Equivalent to:
+
+```
+systemctl --user start aws_sqs.service
+```
+
+### aws_sqs:stop
+
+Stops the aws_sqs service via systemd. Equivalent to:
+
+```
+systemctl --user stop aws_sqs.service
+```
+
+### aws_sqs:status
+
+Prints the status of the aws_sqs systemd service. Equivalent to:
+
+```
+systemctl --user status aws_sqs.service
+```
+
+### aws_sqs:log
+
+Uses `journalctl` (part of systemd) to view the log output of the aws_sqs service. This task is intended for use as a [run](https://tomo-deploy.com/commands/run/) task and accepts command-line arguments. The arguments are passed through to the `journalctl` command. For example:
+
+```
+$ tomo run -- aws_sqs:log -f
+```
+
+Will run this remote script:
+
+```
+journalctl -q --user-unit=aws_sqs.service -f
+```
+
+## Support
+
+If you want to report a bug, or have ideas, feedback or questions about the gem, [let me know via GitHub issues](https://github.com/gauravtiwari/tomo-plugin-aws_sqs/issues/new) and I will do my best to provide a helpful answer. Happy hacking!
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](LICENSE.txt).
+
+Most of the code is taken from https://github.com/mattbrictson/tomo-plugin-sidekiq
+
+## Code of conduct
+
+Everyone interacting in this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+
+## Contribution guide
+
+Pull requests are welcome! Thanks @mattbrictson for Tomo 🙏

data/lib/tomo/plugin/aws_sqs/service.erb

@@ -0,0 +1,22 @@
+[Unit]
+Description=AwsSqs for <%= settings[:application] %>
+After=syslog.target network.target
+ConditionPathExists=<%= paths.current %>
+
+[Service]
+ExecReload=/usr/bin/kill -TSTP $MAINPID
+ExecStart=/bin/bash -lc 'exec <%= settings[:aws_sqs_systemd_command] %>'
+Restart=on-failure
+RestartSec=1
+StandardError=syslog
+StandardOutput=syslog
+SyslogIdentifier=%n
+Type=simple
+WorkingDirectory=<%= paths.current %>
+
+# Greatly reduce Ruby memory fragmentation and heap usage
+# https://www.mikeperham.com/2018/04/25/taming-rails-memory-bloat/
+Environment=MALLOC_ARENA_MAX=2
+
+[Install]
+WantedBy=default.target

data/lib/tomo/plugin/aws_sqs/tasks.rb

@@ -0,0 +1,48 @@
+module Tomo::Plugin::AwsSqs
+  class Tasks < Tomo::TaskLibrary
+    SystemdUnit = Struct.new(:name, :template, :path)
+
+    def setup_systemd
+      linger_must_be_enabled!
+
+      remote.mkdir_p service.path.dirname
+      remote.write template: service.template, to: service.path
+
+      remote.run "systemctl --user daemon-reload"
+      remote.run "systemctl", "--user", "enable", service.name
+    end
+
+    %i[reload restart start stop status].each do |action|
+      define_method(action) do
+        remote.run "systemctl", "--user", action, service.name
+      end
+    end
+
+    def log
+      remote.attach "journalctl", "-q", raw("--user-unit=#{service.name.shellescape}"), *settings[:run_args]
+    end
+
+    private
+
+    def service
+      SystemdUnit.new(
+        settings[:aws_sqs_systemd_service],
+        paths.aws_sqs_systemd_service_template,
+        paths.aws_sqs_systemd_service
+      )
+    end
+
+    def linger_must_be_enabled!
+      linger_users = remote.list_files("/var/lib/systemd/linger", raise_on_error: false)
+      return if dry_run? || linger_users.include?(remote.host.user)
+
+      die <<~ERROR.strip
+        Linger must be enabled for the #{remote.host.user} user in order for
+        aws_sqs to stay running in the background via systemd. Run the following
+        command as root:
+
+          loginctl enable-linger #{remote.host.user}
+      ERROR
+    end
+  end
+end

data/lib/tomo/plugin/aws_sqs/version.rb

@@ -0,0 +1,8 @@
+module Tomo
+  module Plugin
+  end
+end
+
+module Tomo::Plugin::AwsSqs
+  VERSION = "1.0.0".freeze
+end

data/lib/tomo/plugin/aws_sqs.rb

@@ -0,0 +1,13 @@
+require "tomo"
+require_relative "aws_sqs/tasks"
+require_relative "aws_sqs/version"
+
+module Tomo::Plugin::AwsSqs
+  extend Tomo::PluginDSL
+
+  tasks Tomo::Plugin::AwsSqs::Tasks
+  defaults aws_sqs_systemd_service: "aws_sqs_%{application}.service",
+           aws_sqs_systemd_service_path: ".config/systemd/user/%{aws_sqs_systemd_service}",
+           aws_sqs_systemd_service_template_path: File.expand_path("aws_sqs/service.erb", __dir__),
+           aws_sqs_systemd_command: "bundle exec aws_sqs_active_job --queue default"
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: tomo-plugin-aws_sqs
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Matt Brictson
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2022-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tomo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description:
+email:
+- opensource@gauravtiwari.com
+- gaurav@gauravtiwari.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/tomo/plugin/aws_sqs.rb
+- lib/tomo/plugin/aws_sqs/service.erb
+- lib/tomo/plugin/aws_sqs/tasks.rb
+- lib/tomo/plugin/aws_sqs/version.rb
+homepage: https://github.com/gauravtiwari/tomo-plugin-aws_sqs
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/gauravtiwari/tomo-plugin-aws_sqs/issues
+  changelog_uri: https://github.com/gauravtiwari/tomo-plugin-aws_sqs/releases
+  source_code_uri: https://github.com/gauravtiwari/tomo-plugin-aws_sqs
+  homepage_uri: https://github.com/gauravtiwari/tomo-plugin-aws_sqs
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Aws::Sqs background tasks for tomo
+test_files: []