hamal 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 56130bfb0f299aed7a21f84abc68ffb3a980c31cbe136158198456d9be7483c1
+  data.tar.gz: baca257ab1ed431884d57d4d909eb11a8a47dbacdd06a0095c2999594cf29e18
+SHA512:
+  metadata.gz: 1434a5cfab400a3ed32271cf516ce83e2663dce98470e6ed48b08d5d6875ceeabb7c03b2d4527a06c6aa4b93530f0e5b1ea7670fe42d81531d896a9676644857
+  data.tar.gz: e430a46b3a1dacd99fcd191c71095977ac889752b2de0c4fdb16ec22284d925016a0a9abd44e4bfa11d69204993d1b3ced27818073da4e37a9b8a7938a6be194

data/.rubocop.yml

@@ -0,0 +1,157 @@
+AllCops:
+  SuggestExtensions: false
+  NewCops: enable
+
+# I can set other things than accessors.
+Naming/AccessorMethodName:
+  Enabled: false
+
+# Don't complain on missing documentation for every class.
+Style/Documentation:
+  Enabled: false
+
+# No frozen string literals
+Style/FrozenStringLiteralComment:
+  EnforcedStyle: never
+
+# Let me write them typographic (–) dashes in comments.
+Style/AsciiComments:
+  Enabled: false
+
+# Don't enforce Kernel#lambda.
+Style/Lambda:
+  Enabled: false
+
+# Since module_function is a visibility modifier, you can't have private
+# singleton methods. E.g. in some cases, we _do_ need to use extend self.
+Style/ModuleFunction:
+  Enabled: false
+
+# I like them and am gonna use them in multiline blocks. A nice way to enable
+# their usage by disabling their cop.
+Style/NumberedParameters:
+  Enabled: false
+
+# Let me use and/or precedence in conditions, please!
+Style/AndOr:
+  Enabled: false
+
+# I think this results in uglier code, depending on the situation.
+#
+# Example:
+#
+#   if old_password or password
+#     change_password(old_password, password)
+#   end
+#
+# Versus:
+#
+#   change_password(old_password, password) if old_password or password
+#
+# It depends, but if I have a complex condition or a longer line, I prefer the
+# more explicit if condition.
+Style/IfUnlessModifier:
+  Enabled: false
+
+# Recently, I tend to prefer the named boolean operators. Yeah, they do have
+# different precedence, but still.
+Style/Not:
+  Enabled: false
+
+# I don't think this results in better code. We're flatting it out, while it is
+# really nested. Why hide that?
+Style/GuardClause:
+  Enabled: false
+
+Style/StabbyLambdaParentheses:
+  Enabled: false
+
+# Some of our admin code is generated by administrate. I don't wanna change
+# this autogenerated code.
+Style/TrailingCommaInHashLiteral:
+  Enabled: false
+
+# Some of our admin code is generated by administrate. I don't wanna change
+# this autogenerated code.
+Style/TrailingCommaInArguments:
+  Enabled: false
+
+# Some of our admin code is generated by administrate. I don't wanna change
+# this autogenerated code.
+Style/SymbolArray:
+  Enabled: false
+
+# Prefer double quotes because at this time I like them quite better.
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/AccessModifierDeclarations:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+# Dogfood the no-parens love.
+Style/MethodCallWithArgsParentheses:
+  Enabled: true
+  EnforcedStyle: omit_parentheses
+  AllowParenthesesInMultilineCall: true
+  AllowParenthesesInChaining: true
+  AllowParenthesesInCamelCaseMethod: true
+
+Style/MutableConstant:
+  Enabled: false
+
+# I like the value omission hash syntax.
+Style/HashSyntax:
+  EnforcedShorthandSyntax: always
+
+# This is an application, not a library. We don't need to go that far.
+Style/DocumentDynamicEvalDefinition:
+  Enabled: false
+
+# I do that a lot. Think it's okay.
+Lint/AssignmentInCondition:
+  Enabled: false
+
+# Let's not enforce arbitrary metrics.
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+# Sometimes life leaves you no choice. True story.
+Lint/SuppressedException:
+  Enabled: false
+
+Layout/DefEndAlignment:
+  EnforcedStyleAlignWith: start_of_line
+
+# I think it's safe to ignore the 80 chars limit.
+Layout/LineLength:
+  Enabled: false
+
+Layout/LineContinuationLeadingSpace:
+  Enabled: false
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Layout/SpaceInLambdaLiteral:
+  Enabled: false

data/README.md

@@ -0,0 +1,344 @@
+Hamal is a simple deploy tool for self-hosted Rails application. Learn how it
+works, how to configure it, and how to provision new servers.
+
+Not to be confused with Kamal. 😉
+
+**PLACEHOLDERS**: Some commands and configuration snippets described in this
+configuration are app-specific, i.e. their exact contents will vary from app to
+app. In order to make this documentation generic, the `#{app_name}` and
+`#{app_domain}` placeholders are used in such places. Replace the placeholders
+with the respective values in `config/deploy.yml` before executing the commands
+/ copying the configuration.
+
+# Overview
+
+`hamal` implements a simple deploy process for a self-hosted app on a server
+that you administer. It:
+
+1. Connects to the server via SSH. All subsequent stages happen on the server.
+2. Fetches the code that will be deployed from GitHub.
+3. Builds a Docker image containing the app's code.
+4. Uses that image to run the app in a container.
+5. Configures nginx to expose the app container to the Internet.
+
+## Prerequisites
+
+To deploy the app to a server, you will need:
+
+- A bare-bones Ubuntu 22.04 server.
+- SSH access as `root` to that server.
+
+# Provision
+
+When you want to deploy the app on a new server, prepare it for service first
+by following the steps in this section.
+
+## System settings (on the server)
+
+### Update packages
+
+Install latest updates. You'd likely want to do this periodically.
+
+```
+apt update
+apt upgrade
+```
+
+Note: If provisioning an ARM64 Hetzner server, make sure the mirrors in
+`/etc/apt/sources.list` are using `http://mirror.hetzner.com/ubuntu-ports/packages/`
+URLs instead of `http://mirror.hetzner.com/ubuntu/packages/`
+(see https://status.hetzner.com/incident/43b5f083-cb30-4c01-b904-b611206eb172).
+
+### Tighten SSH config
+
+In `/etc/ssh/sshd_config`:
+
+- Set `PasswordAuthentication` to `no`
+- Comment out the `Subsystem sftp` line
+
+### Restart for changes to take effect
+
+```
+reboot
+```
+
+## Docker
+
+Follow the [official docs](https://docs.docker.com/engine/install/ubuntu/).
+The following should just work:
+
+```
+curl -fsSL https://get.docker.com | sh
+```
+
+## nginx
+
+### Install
+
+Follow the [official docs](https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-open-source/#installing-prebuilt-ubuntu-packages).
+In short:
+
+```
+apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
+curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
+# Verify keyring (see official docs for that)
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" | tee /etc/apt/sources.list.d/nginx.list
+echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" | tee /etc/apt/preferences.d/99nginx
+apt update
+apt install nginx
+systemctl start nginx
+```
+
+### Configure (part 1, before we have an SSL certificate)
+
+We need this first incomplete part of the nginx configuration so that we can
+issue an SSL certificate.
+
+Create the directory that will serve static content for the SSL verification
+process:
+
+```
+mkdir /usr/share/nginx/cert_validations
+```
+
+Replace the contents of `/etc/nginx/nginx.conf` with the following:
+
+```
+user nginx;
+worker_processes auto;
+
+error_log /var/log/nginx/error.log notice;
+pid       /var/run/nginx.pid;
+
+events {
+  worker_connections 1024;
+}
+
+http {
+  include      /etc/nginx/mime.types;
+  default_type application/octet-stream;
+
+  log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                  '$status $body_bytes_sent "$http_referer" '
+                  '"$http_user_agent" "$http_x_forwarded_for"';
+  access_log /var/log/nginx/access.log main;
+
+  sendfile on;
+  keepalive_timeout 65;
+
+  ssl_session_cache   shared:SSL:10m;
+  ssl_session_timeout 10m;
+
+  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+  proxy_set_header X-Forwarded-Proto $scheme;
+  proxy_set_header Host $http_host;
+
+  server {
+    listen 80;
+
+    location /.well-known/acme-challenge/ {
+      root /usr/share/nginx/cert_validations;
+    }
+  }
+}
+```
+
+Apply the changes:
+
+```
+nginx -s reload
+```
+
+### Issue SSL certificate
+
+Install certbot:
+
+```
+apt install snapd
+snap install core
+snap refresh core
+snap install --classic certbot
+```
+
+Issue a certificate:
+
+```
+certbot certonly -m genadi@hey.com --webroot -w /usr/share/nginx/cert_validations -d #{app_domain}
+```
+
+Let's Encrypt certificates are only valid for 90 days and need to be renewed
+regularly. There's no need to manually create a cron, though, the certbot snap
+installation has already taken care of this by registering a
+`snap.certbot.renew.timer` systemd timer (check `systemctl list-timers`).
+
+Test that the renewal process is properly set up:
+
+```
+certbot renew --dry-run
+```
+
+You should see a success message for the certificate we just issued.
+
+### Configure (part 2, after we have an SSL certificate)
+
+Create `/etc/nginx/#{app_name}.conf.template` with the following contents:
+
+```
+server {
+  listen      443 ssl;
+  server_name #{app_domain};
+
+  ssl_certificate     /etc/letsencrypt/live/#{app_domain}/fullchain.pem;
+  ssl_certificate_key /etc/letsencrypt/live/#{app_domain}/privkey.pem;
+
+  location / {
+    proxy_pass http://localhost:$ACTIVE_RAILS_PORT;
+  }
+}
+```
+
+Create a temporary dummy `#{app_name}.conf` file. This will get overwritten by
+the actual deploy process, but we need it for now to bootstrap nginx with a
+valid config:
+
+```
+ACTIVE_RAILS_PORT=80 envsubst < /etc/nginx/#{app_name}.conf.template > /etc/nginx/#{app_name}.conf
+```
+
+Add the following include line at the end of the `http` block in `/etc/nginx/nginx.conf`:
+
+```
+http {
+  ...
+  include /etc/nginx/#{app_name}.conf;
+}
+```
+
+Apply the changes:
+
+```
+nginx -s reload
+```
+
+## Deploy user and directories
+
+- Create app user (with the same UID as the user created in the Dockerfile)
+
+  ```
+  useradd rails --uid 1001 --create-home --shell /bin/bash
+  ```
+
+- Create directories
+
+  ```
+  mkdir -p /var/lib/#{app_name}/db
+  mkdir -p /var/lib/#{app_name}/storage
+  mkdir -p /var/lib/#{app_name}/src
+  chown rails:rails /var/lib/#{app_name}/db /var/lib/#{app_name}/storage
+  ```
+
+## Secrets
+
+Store `RAILS_MASTER_KEY` on the server:
+
+```
+echo RAILS_MASTER_KEY=<actual_secret> > /var/lib/#{app_name}/env_file
+```
+
+## Database
+
+If this is an existing app, restore its database to `/var/lib/#{app_name}/db`.
+Make sure its owner user and group are `rails:rails`.
+
+If this is a new app, create its database by running `bin/rails db:create` in
+out of its images. You will likely have to do this at a later point, when you
+do have such an image. Examine `bin/hamal` to determine what arguments to
+`docker run` are needed, e.g. to set ENV variables and mount host directories.
+The final commands you're looking for will look something like this:
+
+```
+docker run --rm <args inferred from bin/hamal> --entrypoint '/rails/bin/rails' <app_image> -- db:create
+docker run --rm <args inferred from bin/hamal> --entrypoint '/rails/bin/rails' <app_image> -- db:schema:load
+```
+
+## GitHub
+
+Create and add a deploy key to grant the server read-only access to this
+repository. Follow the [official docs](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/managing-deploy-keys#deploy-keys).
+In short:
+
+1. Create a new SSH key for the root user on the server
+
+   ```
+   ssh-keygen -t ed25519 -C "Hetzner_<serverIP>" -f ~/.ssh/github_deploy
+   ```
+
+   Leave the passphrase empty.
+
+2. Add the key to GitHub
+
+   Open repository in GitHub, in "Settings" -> "Deploy keys" press "Add deploy
+   key". Enter a title (e.g. the `Hetzner_<serverIP>` comment), the public key
+   you just created (i.e. the contents of `.ssh/github_deploy.pub`), and press
+   "Add key".
+
+3. Configure SSH on the server to use this key when connecting to GitHub
+
+   Create `~/.ssh/config` with the following contents:
+
+   ```
+   Host github.com
+       IdentityFile ~/.ssh/github_deploy
+   ```
+
+# Configuration
+
+The deploy script expects certain configuration in `config/deploy.yml`:
+
+- `github_repo`: The repo where the app's source is located, in the form
+  `<username>/<repo_name>`.
+- `app_name`: Used as part of directory and Docker image names, so must be a
+  valid identifier: only letters, numbers, and underscores.
+- `app_domain`: The hostname that this app will be accessible at.
+- `server`: The IP address of a provisioned server.
+- `local_ports`: An array of at least two ports that will be used by the run
+  the app locally on the server. These ports will not be exposed to the
+  Internet. If you're using the server to host multiple apps using this
+  script, make sure that all apps are configured with unique ports so that
+  they do not conflict with each other.
+
+# Usage
+
+## Installation
+
+Install the `hamal` gem globally or put it in your app's `Gemfile`:
+
+```ruby
+gem "hamal"
+```
+
+## Deploy
+
+Pass the commit you want deployed to `hamal deploy`:
+
+```
+hamal deploy b04c0b567
+```
+
+Omitting the commit will deploy the latest commit on the current branch. The
+commit must have been pushed to the git repo. The deploy script does not deploy
+local commits.
+
+## --help
+
+For more commands, run `hamal --help`:
+
+```
+Usage: bin/hamal [command]
+
+Commands:
+  deploy   - Deploy the app to the server
+  console  - Run Rails console in the deployed container
+  logs     - Follow logs of the deployed container
+  sudo     - SSH into the server as administrator
+```

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/exe/hamal

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "hamal"
+
+Hamal::Commands.execute

data/lib/hamal.rb

@@ -0,0 +1,280 @@
+require "English"
+require "json"
+require "yaml"
+
+module Hamal
+  VERSION = "0.1.0"
+
+  module Config
+    def config_file = "config/deploy.yml"
+    def deployed_revision = ARGV.first.then { _1 unless _1.to_s.start_with? "-" } || `git rev-parse HEAD`.strip
+    def deployed_image = "#{app_name}:#{deployed_revision}"
+    def deploy_config = @deploy_config ||= YAML.safe_load_file(config_file)
+    def deploy_env = "production"
+    def app_name = deploy_config.fetch "app_name"
+    def app_repo = deploy_config.fetch "github_repo"
+    def app_local_ports = deploy_config.fetch("local_ports").map(&:to_s)
+    def server = deploy_config.fetch "server"
+    def project_root = "/var/lib/#{app_name}"
+  end
+
+  module Helpers
+    include Config
+
+    def on_server(user: :root, dir: nil, &) = RemoteExecutor.new(user, dir).instance_exec(&)
+
+    def log(message)
+      bold  = "\e[1m"
+      green = "\e[32m"
+      clear = "\e[0m"
+
+      message = "#{bold}#{green}#{message}#{clear}" if $stdout.tty?
+      puts message
+    end
+  end
+
+  class RemoteExecutor
+    include Helpers
+
+    ExecResult = Struct.new :output, :exit_code do
+      def success? = exit_code.zero?
+    end
+
+    def initialize(remote_user, remote_dir)
+      @remote_user = remote_user
+      @remote_dir = remote_dir
+
+      raise "Invalid remote user #{@remote_user}" unless [:root, :rails].include? @remote_user
+    end
+
+    def sh(command, interactive: false, abort_on_error: false)
+      dir_override = "cd #{@remote_dir};" if @remote_dir
+      user_override = "runuser -u rails" if @remote_user == :rails
+      ssh "#{dir_override} #{user_override} #{command}", interactive:, abort_on_error:
+    end
+
+    def sh!(command, interactive: false) = sh command, interactive:, abort_on_error: true
+
+    def ssh(remote_command, abort_on_error:, interactive: false)
+      remote_command = remote_command.gsub "'", %q('"'"')
+
+      output =
+        if interactive
+          spawn "ssh -tt root@#{server} '#{remote_command}'", out: $stdout, err: $stderr, in: $stdin
+          Process.wait
+          nil
+        else
+          `ssh root@#{server} '#{remote_command}'`.strip
+        end
+
+      abort "Failed to execute `#{remote_command}` on `#{server}`" if abort_on_error && !$CHILD_STATUS.success?
+
+      ExecResult.new output:, exit_code: $CHILD_STATUS.exitstatus
+    end
+  end
+
+  module Stages
+    include Helpers
+
+    def build_new_image
+      image_exists = on_server { sh "docker image inspect #{deployed_image}" }.success?
+      if image_exists
+        log "Using existing image #{deployed_image} for deploy"
+        return
+      end
+
+      log "Building new image #{deployed_image} for deploy"
+
+      source_dir = "#{project_root}/src/#{deployed_revision}"
+
+      on_server do
+        log "  Checking out source at revision #{deployed_revision}..."
+        sh! "rm -rf #{source_dir}"
+        sh! "git clone git@github.com:#{app_repo}.git #{source_dir}"
+      end
+      on_server dir: source_dir do
+        sh! "git checkout #{deployed_revision}"
+
+        log "  Building image..."
+        sh! "docker build -t #{deployed_image} ."
+
+        log "  Cleaning up source dir..."
+        sh! "rm -rf #{source_dir}"
+      end
+    end
+
+    def run_deploy_tasks
+      log "Running migrations"
+
+      on_server do
+        sh! "docker run --rm " \
+            "--label app=#{app_name} " \
+            "--env-file #{project_root}/env_file " \
+            "-e GIT_REVISION=#{deployed_revision} " \
+            "-v #{project_root}/db:/rails/db/#{deploy_env} " \
+            "-v #{project_root}/storage:/rails/storage " \
+            "--entrypoint '/rails/bin/rails' " \
+            "#{deployed_image} " \
+            "-- db:migrate"
+      end
+    end
+
+    def start_new_container
+      log "Starting container for new version"
+
+      # Determine which ports are currently bound and which are free for the new container
+      running_containers = on_server { sh! "docker ps -q --filter label=app=#{app_name}" }.output.split
+      bound_ports =
+        running_containers.map do |container|
+          port_settings = on_server { sh! "docker inspect --format '{{json .NetworkSettings.Ports}}' #{container}" }.output
+          port_settings = JSON.parse port_settings
+          (port_settings["3000/tcp"] || []).map { _1["HostPort"] }.compact
+        end.flatten
+
+      available_port = (app_local_ports - bound_ports).first
+      abort "No TCP port available" unless available_port
+
+      log "  Using port #{available_port} for new container"
+      on_server do
+        sh! "docker run -d --rm " \
+            "--label app=#{app_name} " \
+            "--env-file #{project_root}/env_file " \
+            "-e GIT_REVISION=#{deployed_revision} " \
+            "-v #{project_root}/db:/rails/db/#{deploy_env} " \
+            "-v #{project_root}/storage:/rails/storage " \
+            "-p 127.0.0.1:#{available_port}:3000 " \
+            "#{deployed_image}"
+      end
+
+      [available_port, running_containers]
+    end
+
+    def switch_traffic(new_container_port)
+      log "Switching traffic to new version"
+
+      log "  Waiting for new version to become ready"
+      health_checks = 1
+      loop do
+        new_container_ready = on_server { sh "curl -fs http://localhost:#{new_container_port}/healthz" }.success?
+        break if new_container_ready
+
+        abort "New container failed to start within 30 seconds, investigate!" if health_checks > 30
+
+        health_checks += 1
+        sleep 1
+      end
+
+      log "  Redirecting nginx to new version"
+      on_server do
+        sh! "ACTIVE_RAILS_PORT=#{new_container_port} envsubst < /etc/nginx/#{app_name}.conf.template > /etc/nginx/#{app_name}.conf"
+        sh! "nginx -s reload"
+      end
+    end
+
+    def stop_old_container(old_containers)
+      log "Stopping old container"
+
+      if old_containers.empty?
+        log "  (none found)"
+        return
+      end
+
+      on_server do
+        sh! "docker kill -s SIGTERM #{old_containers.join ' '}"
+      end
+    end
+
+    def clean_up
+      log "Cleaning up"
+
+      log "  Removing unused docker objects"
+      on_server do
+        sh! 'docker system prune --all --force --filter "until=24h"'
+      end
+    end
+  end
+
+  module Commands
+    extend self
+
+    include Stages
+
+    def execute
+      abort "Configure server in deploy config file" unless server
+
+      case ARGV.shift
+      when "deploy"
+        deploy_command
+      when "console"
+        console_command
+      when "logs"
+        logs_command
+      when "sudo"
+        sudo_command
+      else
+        help_command
+      end
+    end
+
+    private
+
+    def deploy_command
+      build_new_image
+      run_deploy_tasks
+      new_container_port, old_containers = start_new_container
+      switch_traffic new_container_port
+      stop_old_container old_containers
+      clean_up
+    end
+
+    def console_command
+      image_exists = on_server { sh "docker image inspect #{deployed_image}" }.success?
+      unless image_exists
+        log "Cannot find #{deployed_image} for inspecting"
+        return
+      end
+
+      log "Running Rails console"
+
+      on_server do
+        sh! "docker run --rm -it " \
+            "--label app=#{app_name} " \
+            "--env-file #{project_root}/env_file " \
+            "-e GIT_REVISION=#{deployed_revision} " \
+            "-v #{project_root}/db:/rails/db/#{deploy_env} " \
+            "-v #{project_root}/storage:/rails/storage " \
+            "--entrypoint '/rails/bin/rails' " \
+            "#{deployed_image} " \
+            "console", interactive: true
+      end
+    end
+
+    def logs_command
+      # Determine which ports are currently bound and which are free for the new container
+      running_container, *other_containers = on_server { sh! "docker ps -q --filter label=app=#{app_name}" }.output.split
+      abort "Multiple containers found, cannot follow logs: #{other_containers.inspect}" unless other_containers.empty?
+
+      log "Following container #{running_container} logs"
+
+      on_server do
+        sh "docker logs -f #{running_container}", interactive: true
+      end
+    end
+
+    def sudo_command
+      system "ssh root@#{server}", exception: true
+    end
+
+    def help_command
+      puts <<~HELP
+        Usage: bin/hamal [command]
+
+        Commands:
+          deploy   - Deploy the app to the server
+          console  - Run Rails console in the deployed container
+          logs     - Follow logs of the deployed container
+          sudo     - SSH into the server as administrator
+      HELP
+    end
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: hamal
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Genadi Samokovarov
+bindir: exe
+cert_chain: []
+date: 2025-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- gsamokovarov@gmail.com
+executables:
+- hamal
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- README.md
+- Rakefile
+- exe/hamal
+- lib/hamal.rb
+homepage: https://github.com/gsamokovarov/hamal
+licenses: []
+metadata:
+  homepage_uri: https://github.com/gsamokovarov/hamal
+  source_code_uri: https://github.com/gsamokovarov/hamal
+  changelog_uri: https://github.com/gsamokovarov/hamal/releases
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Hamal is a simple deploy tool for self-hosted Rails application
+test_files: []