mina-infinum 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7515a358a97fb531c9234b5af9f66d38b21ca179baa2630a6c0cdab7594bc81d
-  data.tar.gz: 0d1c15c942585a620cae300808ae5c509dbc8329fd68a17a67913e27203e3ab0
+  metadata.gz: d0ba2dc913ff35e4416588b4f58baab6070960c1d33dc619acbda331ed46da48
+  data.tar.gz: fc982c1d6374965b0c347fccd3f11983dcf8ccd5c94cdc48b65737fe57ce1437
 SHA512:
-  metadata.gz: d636c8821a835dc329c263ebe7da0cafc1689aa4b4c41829988e243979c76f1867fedea43b1d2fdad509e11ff2bd96ed0e60a27645b217b47591056c29c386b0
-  data.tar.gz: 28ce51888667a163a17dd3274643f9071d1cc88fa2981f593454cb92a2940996665deb17d9512e6cdcfa0c3f319af8003e778e2632faae3306927bd89ab4c725
+  metadata.gz: 83dc2eba39533955f29e8cec5ba626626b0b52d6c3f7cc1f6df2e77891217d615f304f989f46a58ff55532cb68bd41b8ef89fca08f2148a96cd17d755079e19e
+  data.tar.gz: a0d9cb6a87a5db0a41dbeb77fefcbbcf04d726807a986151e7eb931204fb4b55a4dc1d45a54e2a1ebd4154bbdb58c6e60b41945c72e332acc45d29c31e034b44

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [v2.3.0](https://github.com/infinum/mina-infinum/tree/v-2.3.0) (2025-10-02)
+[Full Changelog](https://github.com/infinum/mina-infinum/compare/v2.2.0...v2.3.0)
+
+### Enhancements
+
+- Add logs and logs:tail AWS tasks [\#8](https://github.com/infinum/mina-infinum/pull/8)
+
+## [v2.2.0](https://github.com/infinum/mina-infinum/tree/v-2.2.0) (2025-07-25)
+[Full Changelog](https://github.com/infinum/mina-infinum/compare/v2.1.0...v2.2.0)
+
+### Enhancements
+
+- Add aliases for aws:login and rails:console tasks [\#6](https://github.com/infinum/mina-infinum/pull/6)
+- Add params:pull and params:read tasks to AWS tasks [\#7](https://github.com/infinum/mina-infinum/pull/7)
+
 ## [v2.1.0](https://github.com/infinum/mina-infinum/tree/v-2.1.0) (2025-05-29)
 [Full Changelog](https://github.com/infinum/mina-infinum/compare/v2.0.0...v2.1.0)
 

data/lib/mina/infinum/ecs/aws.rb

@@ -91,3 +91,6 @@ def profile_exists?(profile)
 
   profiles.split("\n").include?(profile)
 end
+
+desc 'Alias for aws:login'
+task :login => 'aws:login'

data/lib/mina/infinum/ecs/logs.rb

@@ -0,0 +1,112 @@
+require 'time'
+require 'mina/infinum/ecs/aws'
+
+desc <<~TXT
+  Print logs from CloudWatch
+
+  Logs are printed from :log_group, which is a CloudWatch log group name.
+
+  Logs are fetched in range :since to :until (both inclusive). Both values must be
+  parseable by `Time.parse` (e.g. ISO8601 timestamps). :since is required,
+  :until is optional (if omitted, value will be current time).
+
+  If date is ommitted in either value, the current date is assumed.
+
+  Examples:
+  # logs since 26.9.2025. 14:00 in local time zone
+  $ mina logs since="2025-09-26 14:00"
+
+  # logs on 26.9.2025. between 14:00 and 15:00 in local time zone
+  $ mina logs since="2025-09-26 14:00" until="2025-09-26 15:00"
+
+  # logs between 14:00 and 15:00 today in local time zone
+  $ mina logs since="14:00" until="15:00"
+
+  # logs between 14:00 and 15:00 today in UTC
+  $ mina logs since="14:00Z" until="15:00Z"
+
+  # logs since 26.9.2025. 14:00 in UTC (ISO 8601 format)
+  $ mina logs since="2025-09-26T14:00Z"
+TXT
+task logs: ['aws:profile:check'] do
+  ensure!(:log_group)
+  ensure!(:since)
+
+  since_time = Time.parse(fetch(:since))
+  until_time = fetch(:until) ? Time.parse(fetch(:until)) : Time.now
+
+  puts "Printing logs from #{fetch(:log_group)} in range [#{since_time.iso8601},#{until_time.iso8601}]"
+  raw_logs = run_cmd squish(<<~CMD)
+    aws logs filter-log-events
+      --log-group-name #{fetch(:log_group)}
+      --profile #{fetch(:aws_profile)}
+      --start-time #{since_time.strftime('%s%L')}
+      --end-time #{until_time.strftime('%s%L')}
+      --output json
+      --query "events[].{timestamp: timestamp, message: message}"
+  CMD
+
+  next if raw_logs.empty? # response can be empty due to auth issues, user will see error in terminal
+
+  logs = JSON.parse(raw_logs)
+  if logs.any?
+    logs.each do |log|
+      time = Time.at(0, log.fetch('timestamp'), :millisecond)
+      puts "#{green_text(time.utc.iso8601)} #{log.fetch('message')}"
+    end
+  else
+    puts 'There are no logs'
+  end
+end
+
+namespace :logs do
+  desc <<~TXT
+    Tail logs from CloudWatch
+
+    Logs are tailed from :log_group, which is a CloudWatch log group name.
+
+    Before new logs are tailed, recent logs are first printed. You can control
+    from what time recent logs are printed with :since. The value can be absolute
+    time parseable by `Time.parse`, or relative time.
+
+    If date is ommitted in absolute time, the current date is assumed.
+
+    Examples:
+    # tail logs since 26.9.2025. 14:00 in local time zone
+    $ mina logs:tail since="2025-09-26 14:00"
+
+    # tail logs since 14:00 today in local time zone
+    $ mina logs:tail since="14:00"
+
+    # tail logs since 26.9.2025. 14:00 in UTC (ISO 8601 format)
+    $ mina logs:tail since="2025-09-26T14:00Z"
+
+    # tail logs since 5 minutes ago
+    $ mina logs:tail since="5m"
+
+    For more info on accepted :since values, see --since options
+    https://docs.aws.amazon.com/cli/latest/reference/logs/tail.html#options
+  TXT
+  task tail: ['aws:profile:check'] do
+    ensure!(:log_group)
+
+    since_time = fetch(:since)&.strip
+
+    if since_time && !since_time.empty? && !since_time.match?(/\A\d+\w\z/)
+      since_time = Time.parse(since_time).iso8601
+    end
+
+    puts "Tailing logs from #{fetch(:log_group)}"
+    run_cmd squish(<<~CMD), exec: true
+      aws logs tail #{fetch(:log_group)}
+        --profile #{fetch(:aws_profile)}
+        --follow
+        --format short
+        #{"--since #{since_time}" if since_time}
+    CMD
+  end
+end
+
+def green_text(text)
+  "\e[32m#{text}\e[0m"
+end

data/lib/mina/infinum/ecs/params.rb

@@ -0,0 +1,73 @@
+require 'mina/infinum/ecs/aws'
+
+namespace :params do
+  desc <<~TXT
+    Print AWS Param Store params to stdout
+
+    By default, params are fetched from path "/:cluster/".
+    All levels of params are fetched under this path, e.g.
+    both "/:cluster/A" and "/:cluster/A/B/C" will be fetched.
+
+    You can override the path by setting :params_path.
+  TXT
+  task read: ['aws:profile:check'] do
+    puts get_params.map(&:as_env)
+  end
+
+  desc <<~TXT
+    Save AWS Param Store params to .env file
+
+    See params:read documentation for details on how params
+    are fetched.
+  TXT
+  task pull: ['aws:profile:check'] do
+    env_file_path = File.join(Dir.pwd, '.env')
+
+    File.write(env_file_path, get_params.map(&:as_env).join("\n"))
+  end
+end
+
+Param = Data.define(:name, :value) do
+  # /staging-acme/acme/staging/BUGSNAG_API_KEY -> BUGSNAG_API_KEY
+  def variable_name
+    name.split('/').last
+  end
+
+  def as_env
+    "#{variable_name}=#{value}"
+  end
+end
+
+def get_params
+  normalize_params(get_params_from_aws)
+end
+
+def normalize_params(raw_params)
+  raw_params.map do |param|
+    Param.new(name: param.fetch('Name'), value: param.fetch('Value'))
+  end
+end
+
+def get_params_from_aws
+  params_path = fetch(:params_path) || default_params_path
+  output = run_cmd squish(<<~CMD)
+    aws ssm get-parameters-by-path
+      --path #{params_path}
+      --with-decryption
+      --recursive
+      --profile #{fetch(:aws_profile)}
+      #{'--debug' if debug?}
+  CMD
+
+  unless $CHILD_STATUS.success?
+    error! "Cannot fetch params from AWS... do you need to log in (use task aws:login)? For more info, add debug=true to command"
+  end
+
+  JSON.parse(output).dig('Parameters') || error!('There are no params in the response')
+end
+
+def default_params_path
+  ensure!(:cluster)
+
+  "/#{fetch(:cluster)}/"
+end

data/lib/mina/infinum/ecs/rails.rb

@@ -21,7 +21,7 @@ end
 
 namespace :rails do
   desc <<~TXT
-    Open rails console
+    Open Rails console
 
     Runs "bundle exec rails console" on the ECS container.
   TXT
@@ -40,3 +40,6 @@ namespace :rails do
     invoke 'ecs:exec', "tail -f log/#{fetch(:rails_env)}.log"
   end
 end
+
+desc 'Alias for rails:console'
+task :console => 'rails:console'

data/lib/mina/infinum/ecs.rb

@@ -1,6 +1,8 @@
 require 'mina/default'
 require 'mina/infinum/ecs/rails'
+require 'mina/infinum/ecs/logs'
 require 'mina/infinum/ecs/db'
+require 'mina/infinum/ecs/params'
 
 # INFO: hides default Mina tasks when running "mina --tasks"
 Rake::Task['run'].clear_comments

data/lib/mina/infinum/version.rb

@@ -1,5 +1,5 @@
 module Mina
   module Infinum
-    VERSION = '2.1.0'.freeze
+    VERSION = '2.3.0'.freeze
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mina-infinum
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Stjepan Hadjic
 bindir: exe
 cert_chain: []
-date: 2025-05-29 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -145,6 +145,8 @@ files:
 - lib/mina/infinum/ecs/aws.rb
 - lib/mina/infinum/ecs/db.rb
 - lib/mina/infinum/ecs/ecs.rb
+- lib/mina/infinum/ecs/logs.rb
+- lib/mina/infinum/ecs/params.rb
 - lib/mina/infinum/ecs/rails.rb
 - lib/mina/infinum/helpers.rb
 - lib/mina/infinum/tasks.rb
@@ -169,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Collection of mina plugins we use in infinum
 test_files: []