nocoffee-kamal 2.3.0.1

data/lib/kamal/utils.rb

@@ -0,0 +1,110 @@
+require "active_support/core_ext/object/try"
+
+module Kamal::Utils
+  extend self
+
+  DOLLAR_SIGN_WITHOUT_SHELL_EXPANSION_REGEX = /\$(?!{[^\}]*\})/
+
+  # Return a list of escaped shell arguments using the same named argument against the passed attributes (hash or array).
+  def argumentize(argument, attributes, sensitive: false)
+    Array(attributes).flat_map do |key, value|
+      if value.present?
+        attr = "#{key}=#{escape_shell_value(value)}"
+        attr = self.sensitive(attr, redaction: "#{key}=[REDACTED]") if sensitive
+        [ argument, attr ]
+      elsif value == false
+        [ argument, "#{key}=false" ]
+      else
+        [ argument, key ]
+      end
+    end
+  end
+
+  # Returns a list of shell-dashed option arguments. If the value is true, it's treated like a value-less option.
+  def optionize(args, with: nil)
+    options = if with
+      flatten_args(args).collect { |(key, value)| value == true ? "--#{key}" : "--#{key}#{with}#{escape_shell_value(value)}" }
+    else
+      flatten_args(args).collect { |(key, value)| [ "--#{key}", value == true ? nil : escape_shell_value(value) ] }
+    end
+
+    options.flatten.compact
+  end
+
+  # Flattens a one-to-many structure into an array of two-element arrays each containing a key-value pair
+  def flatten_args(args)
+    args.flat_map { |key, value| value.try(:map) { |entry| [ key, entry ] } || [ [ key, value ] ] }
+  end
+
+  # Marks sensitive values for redaction in logs and human-visible output.
+  # Pass `redaction:` to change the default `"[REDACTED]"` redaction, e.g.
+  # `sensitive "#{arg}=#{secret}", redaction: "#{arg}=xxxx"
+  def sensitive(...)
+    Kamal::Utils::Sensitive.new(...)
+  end
+
+  def redacted(value)
+    case
+    when value.respond_to?(:redaction)
+      value.redaction
+    when value.respond_to?(:transform_values)
+      value.transform_values { |value| redacted value }
+    when value.respond_to?(:map)
+      value.map { |element| redacted element }
+    else
+      value
+    end
+  end
+
+  # Escape a value to make it safe for shell use.
+  def escape_shell_value(value)
+    value.to_s.scan(/[\x00-\x7F]+|[^\x00-\x7F]+/) \
+      .map { |part| part.ascii_only? ? escape_ascii_shell_value(part) : part }
+      .join
+  end
+
+  def escape_ascii_shell_value(value)
+    value.to_s.dump
+      .gsub(/`/, '\\\\`')
+      .gsub(DOLLAR_SIGN_WITHOUT_SHELL_EXPANSION_REGEX, '\$')
+  end
+
+  # Apply a list of host or role filters, including wildcard matches
+  def filter_specific_items(filters, items)
+    matches = []
+
+    Array(filters).select do |filter|
+      matches += Array(items).select do |item|
+        # Only allow * for a wildcard
+        # items are roles or hosts
+        File.fnmatch(filter, item.to_s, File::FNM_EXTGLOB)
+      end
+    end
+
+    matches.uniq
+  end
+
+  def stable_sort!(elements, &block)
+    elements.sort_by!.with_index { |element, index| [ block.call(element), index ] }
+  end
+
+  def join_commands(commands)
+    commands.map(&:strip).join(" ")
+  end
+
+  def docker_arch
+    arch = `docker info --format '{{.Architecture}}'`.strip
+    case arch
+    when /aarch64/
+      "arm64"
+    when /x86_64/
+      "amd64"
+    else
+      arch
+    end
+  end
+
+  def older_version?(version, other_version)
+    Gem::Version.new(version.delete_prefix("v")) < Gem::Version.new(other_version.delete_prefix("v"))
+  end
+end

data/lib/kamal/version.rb

@@ -0,0 +1,3 @@
+module Kamal
+  VERSION = "2.3.0.1"
+end

data/lib/kamal.rb

@@ -0,0 +1,14 @@
+module Kamal
+  class ConfigurationError < StandardError; end
+end
+
+require "active_support"
+require "zeitwerk"
+require "yaml"
+require "tmpdir"
+require "pathname"
+
+loader = Zeitwerk::Loader.for_gem
+loader.ignore(File.join(__dir__, "kamal", "sshkit_with_ext.rb"))
+loader.setup
+loader.eager_load_namespace(Kamal::Cli) # We need all commands loaded.

metadata

@@ -0,0 +1,349 @@
+--- !ruby/object:Gem::Specification
+name: nocoffee-kamal
+version: !ruby/object:Gem::Version
+  version: 2.3.0.1
+platform: ruby
+authors:
+- David Heinemeier Hansson
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-11-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: sshkit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.23.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.23.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.3'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.18
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.18
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: ed25519
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: bcrypt_pbkdf
+  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'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Kamal with the TLS on demand feature
+email: dhh@hey.com
+executables:
+- kamal
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- bin/kamal
+- lib/kamal.rb
+- lib/kamal/cli.rb
+- lib/kamal/cli/accessory.rb
+- lib/kamal/cli/alias/command.rb
+- lib/kamal/cli/app.rb
+- lib/kamal/cli/app/boot.rb
+- lib/kamal/cli/app/prepare_assets.rb
+- lib/kamal/cli/base.rb
+- lib/kamal/cli/build.rb
+- lib/kamal/cli/build/clone.rb
+- lib/kamal/cli/healthcheck/barrier.rb
+- lib/kamal/cli/healthcheck/error.rb
+- lib/kamal/cli/healthcheck/poller.rb
+- lib/kamal/cli/lock.rb
+- lib/kamal/cli/main.rb
+- lib/kamal/cli/proxy.rb
+- lib/kamal/cli/prune.rb
+- lib/kamal/cli/registry.rb
+- lib/kamal/cli/secrets.rb
+- lib/kamal/cli/server.rb
+- lib/kamal/cli/templates/deploy.yml
+- lib/kamal/cli/templates/sample_hooks/docker-setup.sample
+- lib/kamal/cli/templates/sample_hooks/post-deploy.sample
+- lib/kamal/cli/templates/sample_hooks/post-proxy-reboot.sample
+- lib/kamal/cli/templates/sample_hooks/pre-build.sample
+- lib/kamal/cli/templates/sample_hooks/pre-connect.sample
+- lib/kamal/cli/templates/sample_hooks/pre-deploy.sample
+- lib/kamal/cli/templates/sample_hooks/pre-proxy-reboot.sample
+- lib/kamal/cli/templates/secrets
+- lib/kamal/commander.rb
+- lib/kamal/commander/specifics.rb
+- lib/kamal/commands.rb
+- lib/kamal/commands/accessory.rb
+- lib/kamal/commands/app.rb
+- lib/kamal/commands/app/assets.rb
+- lib/kamal/commands/app/containers.rb
+- lib/kamal/commands/app/execution.rb
+- lib/kamal/commands/app/images.rb
+- lib/kamal/commands/app/logging.rb
+- lib/kamal/commands/app/proxy.rb
+- lib/kamal/commands/auditor.rb
+- lib/kamal/commands/base.rb
+- lib/kamal/commands/builder.rb
+- lib/kamal/commands/builder/base.rb
+- lib/kamal/commands/builder/clone.rb
+- lib/kamal/commands/builder/hybrid.rb
+- lib/kamal/commands/builder/local.rb
+- lib/kamal/commands/builder/remote.rb
+- lib/kamal/commands/docker.rb
+- lib/kamal/commands/hook.rb
+- lib/kamal/commands/lock.rb
+- lib/kamal/commands/proxy.rb
+- lib/kamal/commands/prune.rb
+- lib/kamal/commands/registry.rb
+- lib/kamal/commands/server.rb
+- lib/kamal/configuration.rb
+- lib/kamal/configuration/accessory.rb
+- lib/kamal/configuration/alias.rb
+- lib/kamal/configuration/boot.rb
+- lib/kamal/configuration/builder.rb
+- lib/kamal/configuration/docs/accessory.yml
+- lib/kamal/configuration/docs/alias.yml
+- lib/kamal/configuration/docs/boot.yml
+- lib/kamal/configuration/docs/builder.yml
+- lib/kamal/configuration/docs/configuration.yml
+- lib/kamal/configuration/docs/env.yml
+- lib/kamal/configuration/docs/logging.yml
+- lib/kamal/configuration/docs/proxy.yml
+- lib/kamal/configuration/docs/registry.yml
+- lib/kamal/configuration/docs/role.yml
+- lib/kamal/configuration/docs/servers.yml
+- lib/kamal/configuration/docs/ssh.yml
+- lib/kamal/configuration/docs/sshkit.yml
+- lib/kamal/configuration/env.rb
+- lib/kamal/configuration/env/tag.rb
+- lib/kamal/configuration/logging.rb
+- lib/kamal/configuration/proxy.rb
+- lib/kamal/configuration/registry.rb
+- lib/kamal/configuration/role.rb
+- lib/kamal/configuration/servers.rb
+- lib/kamal/configuration/ssh.rb
+- lib/kamal/configuration/sshkit.rb
+- lib/kamal/configuration/validation.rb
+- lib/kamal/configuration/validator.rb
+- lib/kamal/configuration/validator/accessory.rb
+- lib/kamal/configuration/validator/alias.rb
+- lib/kamal/configuration/validator/builder.rb
+- lib/kamal/configuration/validator/configuration.rb
+- lib/kamal/configuration/validator/env.rb
+- lib/kamal/configuration/validator/proxy.rb
+- lib/kamal/configuration/validator/registry.rb
+- lib/kamal/configuration/validator/role.rb
+- lib/kamal/configuration/validator/servers.rb
+- lib/kamal/configuration/volume.rb
+- lib/kamal/env_file.rb
+- lib/kamal/git.rb
+- lib/kamal/secrets.rb
+- lib/kamal/secrets/adapters.rb
+- lib/kamal/secrets/adapters/base.rb
+- lib/kamal/secrets/adapters/bitwarden.rb
+- lib/kamal/secrets/adapters/last_pass.rb
+- lib/kamal/secrets/adapters/one_password.rb
+- lib/kamal/secrets/adapters/test.rb
+- lib/kamal/secrets/dotenv/inline_command_substitution.rb
+- lib/kamal/sshkit_with_ext.rb
+- lib/kamal/tags.rb
+- lib/kamal/utils.rb
+- lib/kamal/utils/sensitive.rb
+- lib/kamal/version.rb
+homepage: https://github.com/basecamp/kamal
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.19
+signing_key:
+specification_version: 4
+summary: Deploy web apps in containers to servers running Docker with zero downtime
+test_files: []