deploio-cli 0.1.1 → 0.3.0

data/lib/deploio/output.rb

@@ -42,6 +42,15 @@ module Deploio
         puts pastel.magenta.bold(text)
       end
 
+      # Create a clickable hyperlink using OSC 8 escape sequences
+      # Supported by most modern terminal emulators (iTerm2, GNOME Terminal, Windows Terminal, etc.)
+      def link(text, url = nil)
+        return text unless color_enabled
+
+        url ||= text.start_with?("http") ? text : "https://#{text}"
+        "\e]8;;#{url}\e\\#{text}\e]8;;\e\\"
+      end
+
       def table(rows, headers: nil)
         return if rows.empty?
 
@@ -49,6 +58,37 @@ module Deploio
         puts tty_table.render(:unicode, padding: [0, 2, 0, 1], width: 10_000)
       end
 
+      def list(items)
+        items.each { |item| puts "  • #{item}" }
+      end
+
+      def grouped_table(groups, headers: nil)
+        return if groups.empty?
+
+        all_rows = groups.values.flatten(1)
+        return if all_rows.empty?
+
+        # Track which row indices should have separators after them (0-indexed)
+        # The separator lambda receives the row index (0 = first data row)
+        separator_after = []
+        current_idx = 0
+        groups.each_with_index do |(_, group_rows), group_idx|
+          current_idx += group_rows.size
+          # Add separator after last row of each group (except the last group)
+          separator_after << (current_idx - 1) if group_idx < groups.size - 1
+        end
+
+        rows = groups.values.flatten(1)
+        tty_table = headers ? TTY::Table.new(header: headers, rows: rows) : TTY::Table.new(rows: rows)
+
+        output = tty_table.render(:unicode, padding: [0, 2, 0, 1], width: 10_000) do |renderer|
+          # row_idx 0 = separator after header, then data row indices
+          renderer.border.separator = ->(row_idx) { row_idx == 0 || separator_after.include?(row_idx - 1) }
+        end
+
+        puts output
+      end
+
       private
 
       def pastel

data/lib/deploio/pg_database_ref.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "did_you_mean"
+
+module Deploio
+  class PgDatabaseRef
+    attr_reader :project_name, :database_name
+
+    # The input is given in the format "<project>-<database>"
+    def initialize(input, available_databases: {})
+      @input = input.to_s
+      parse_from_available_databases(available_databases)
+    end
+
+    def full_name
+      "#{project_name}-#{database_name}"
+    end
+
+    def to_s
+      full_name
+    end
+
+    def ==(other)
+      return false unless other.is_a?(PgDatabaseRef)
+
+      project_name == other.project_name && database_name == other.database_name
+    end
+
+    private
+
+    def parse_from_available_databases(available_databases)
+      if available_databases.key?(@input)
+        match = available_databases[@input]
+        @project_name = match[:project_name]
+        @database_name = match[:database_name]
+        return
+      end
+
+      # If available_databases provided but no match, raise error with suggestions
+      raise_not_found_error(@input, available_databases.keys) unless available_databases.empty?
+
+      raise_not_found_error(@input, [])
+    end
+
+    def raise_not_found_error(input, available_database_names)
+      message = "Database not found: '#{input}'"
+
+      suggestions = suggest_similar(input, available_database_names)
+      unless suggestions.empty?
+        message += "\n\nDid you mean?"
+        suggestions.each { |s| message += "\n  #{s}" }
+      end
+
+      message += "\n\nRun 'deploio pg' to see available Postgres databases."
+
+      raise Deploio::PgDatabaseNotFoundError, message
+    end
+
+    def suggest_similar(input, dictionary)
+      return [] if dictionary.empty?
+
+      spell_checker = DidYouMean::SpellChecker.new(dictionary: dictionary)
+      spell_checker.correct(input)
+    end
+  end
+end

data/lib/deploio/pg_database_resolver.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Deploio
+  class PgDatabaseResolver
+    attr_reader :nctl, :current_org
+
+    def initialize(nctl_client:)
+      @nctl = nctl_client
+      @current_org = @nctl.current_org
+    end
+
+    def resolve(database_name: nil)
+      if database_name
+        return PgDatabaseRef.new(database_name, available_databases: available_databases_hash)
+      end
+
+      raise Deploio::Error, "No database specified"
+    end
+
+    # Returns hash mapping database names -> {project_name:, app_name:}
+    def available_databases_hash
+      @available_apps_hash ||= begin
+        hash = {}
+        current_org = @nctl.current_org
+        @nctl.get_all_pg_databases.each do |database|
+          metadata = database["metadata"] || {}
+          project_name = metadata["namespace"] || ""
+          database_name = metadata["name"]
+          full_name = "#{project_name}-#{database_name}"
+          hash[full_name] = {project_name: project_name, database_name: database_name}
+
+          # Also index by short name (without org prefix) for convenience
+          if current_org && project_name.start_with?("#{current_org}-")
+            project = project_name.delete_prefix("#{current_org}-")
+            short_name = "#{project}-#{database_name}"
+            hash[short_name] ||= {project_name: project_name, database_name: database_name}
+          end
+        end
+        hash
+      end
+    rescue
+      {}
+    end
+
+    def short_name_for(namespace, database_name)
+      org = current_org
+      if org && namespace.start_with?("#{org}-")
+        project = namespace.delete_prefix("#{org}-")
+        "#{project}-#{database_name}"
+      else
+        "#{namespace}-#{database_name}"
+      end
+    end
+  end
+end

data/lib/deploio/postgres_backup_service.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Deploio
+  # Backups for the dedicated tier (kind: Postgres), where we own the whole
+  # database server and reach it over SSH
+  # The naming is confusing, but this is how Nine names them and how the resources appear, so prefer to stay
+  # consistent with that
+  class PostgresBackupService
+    DEFAULT_EXTENSION = ".zst"
+
+    # @param name [String] the name the user typed, used for hints in messages
+    def initialize(data:, name: nil, dry_run: false)
+      @data = data || {}
+      @name = name
+      @dry_run = dry_run
+    end
+
+    def default_destination = "./#{@name}-latest-backup#{DEFAULT_EXTENSION}"
+
+    def backups
+      raise Deploio::UnsupportedBackupOperationError,
+        "Listing backups is not yet supported for dedicated PostgreSQL instances; Feel free to implement it!\n" \
+        "Use 'deploio pg backups download #{@name}' to fetch it."
+    end
+
+    def capture
+      cmd = ["ssh", "dbadmin@#{fqdn}", "sudo nine-postgresql-backup"]
+      Output.command(cmd.join(" "))
+      system(*cmd) unless @dry_run
+    end
+
+    def download(destination:, db_name: nil)
+      name = resolve_db_name(db_name)
+
+      cmd = ["rsync", "-av", "dbadmin@#{fqdn}:~/backup/postgresql/latest/customer/#{name}/#{name}.zst", destination]
+      Output.command(cmd.join(" "))
+      system(*cmd) unless @dry_run
+
+      nil
+    end
+
+    private
+
+    def resolve_db_name(db_name)
+      if databases.empty?
+        raise Deploio::Error, "No databases found in PostgreSQL instance; cannot download backup."
+      elsif databases.size > 1 && db_name.nil?
+        raise Deploio::Error,
+          "Multiple databases found in PostgreSQL instance\n" \
+          "Databases: #{databases.join(", ")}\n" \
+          "Please specify the database name using the --db_name option."
+      end
+
+      db_name || databases.first
+    end
+
+    def databases
+      @databases ||= (@data.dig("status", "atProvider", "databases")&.keys || []).reject { |db| db.strip.empty? }
+    end
+
+    def fqdn
+      value = @data.dig("status", "atProvider", "fqdn")
+      raise Deploio::Error, "Database FQDN not found; cannot reach the database server." if value.nil? || value.empty?
+
+      value
+    end
+  end
+end

data/lib/deploio/postgres_database_backup_service.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Deploio
+  # Backups for the economy tier (kind: PostgresDatabase), where the database
+  # lives on a shared server we have no access to.
+  # The naming is confusing, but this is how Nine names them and how the resources appear, so prefer to stay
+  # consistent with that
+  class PostgresDatabaseBackupService
+    DEFAULT_EXTENSION = ".sql.zst"
+
+    BACKUP_SCHEDULE_LABEL = "DatabaseBackupSchedule"
+
+    def initialize(db_ref:, data:, nctl_client:, name: nil, rclone_client_factory: nil)
+      @db_ref = db_ref
+      @data = data || {}
+      @nctl = nctl_client
+      @name = name || db_ref.full_name
+      @rclone_client_factory = rclone_client_factory || method(:build_rclone_client)
+    end
+
+    def default_destination
+      "./#{@name}-latest-backup#{DEFAULT_EXTENSION}"
+    end
+
+    # Nine takes these backups on a schedule
+    # (you can even see them using `kubectl get databasebackupschedules.storage.nine.ch -n renuo-chess-tracker -o json`)
+    # => there is no way to trigger one.
+    def capture
+      raise Deploio::UnsupportedBackupOperationError,
+        "'#{@db_ref.full_name}' is an economy-tier database. Those are backed up automatically " \
+        "on their configured schedule and cannot be captured manually.\n" \
+        "Use 'deploio pg backups list #{@name}' to see the available backups."
+    end
+
+    def backups
+      @backups ||= begin
+        entries = rclone.list(bucket_name)
+        entries = entries.select { |e| own_backup?(e["Name"].to_s) }
+        entries.sort_by { |e| e["ModTime"].to_s }.reverse
+      end
+    end
+
+    def download(destination:, db_name: nil)
+      backup = backups.first
+      unless backup
+        raise Deploio::Error, "No backups found for '#{@db_ref.full_name}' in bucket '#{bucket_name}'."
+      end
+
+      rclone.download(bucket_name, backup["Name"], destination)
+      backup
+    end
+
+    private
+
+    def own_backup?(object_name)
+      return true if instance_name.empty?
+
+      object_name.start_with?("PostgresDatabase-#{instance_name}-")
+    end
+
+    def instance_name
+      @instance_name ||= @data.dig("status", "atProvider", "name").to_s
+    end
+
+    def bucket_name
+      bucket.dig("metadata", "name")
+    end
+
+    # The PostgresDatabase resource holds no reference to its backup bucket
+    # Changes with service connections (I assume), but we're not there yet as we still have projects with the old setup.
+    # Therefore, we match by name
+    def bucket
+      @bucket ||= begin
+        candidates = @nctl.get_services_by_type("bucket", project: @db_ref.project_name).select do |bucket|
+          backup_bucket_for_database?(bucket)
+        end
+
+        if candidates.empty?
+          raise Deploio::Error,
+            "No backup bucket found for '#{@db_ref.full_name}'. " \
+            "Check that backups are enabled for this database (spec.forProvider.backupSchedule)."
+        end
+
+        candidates.first
+      end
+    end
+
+    def backup_bucket_for_database?(bucket)
+      metadata = bucket["metadata"] || {}
+      labels = metadata["labels"] || {}
+      return false unless labels["nine.ch/controllerKind"] == BACKUP_SCHEDULE_LABEL
+
+      metadata["name"].to_s.match?(/\Apostgresdatabase-#{Regexp.escape(@db_ref.database_name)}-[0-9a-f]{7}\z/)
+    end
+
+    def rclone
+      @rclone ||= @rclone_client_factory.call
+    end
+
+    def build_rclone_client
+      endpoint = bucket.dig("status", "atProvider", "endpoint")
+      if endpoint.nil? || endpoint.to_s.empty?
+        raise Deploio::Error, "Backup bucket '#{bucket_name}' has no endpoint; cannot access backups."
+      end
+
+      client = RcloneClient.new(
+        endpoint: "https://#{endpoint}",
+        access_key: @nctl.get_bucket_user_access_key(bucket_name, project: @db_ref.project_name),
+        secret_key: @nctl.get_bucket_user_secret_key(bucket_name, project: @db_ref.project_name),
+        dry_run: @nctl.dry_run
+      )
+      client.check_requirements unless @nctl.dry_run
+      client
+    end
+  end
+end

data/lib/deploio/price_fetcher.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+require "fileutils"
+
+module Deploio
+  class PriceFetcher
+    CACHE_DIR = File.expand_path("~/.deploio")
+    CACHE_FILE = File.join(CACHE_DIR, "prices.json")
+    CACHE_TTL = 24 * 60 * 60 # 24 hours in seconds
+    API_URL = "https://calculator-api-production.2deb129.deploio.app/product"
+
+    def initialize
+      @prices = nil
+    end
+
+    def fetch
+      @prices ||= load_cached_prices || fetch_and_cache_prices
+    end
+
+    def price_for_service(type, spec)
+      fetch
+      return nil unless @prices
+
+      case type
+      when "postgres", "mysql"
+        price_for_database(type, spec)
+      when "postgresdatabases", "mysqldatabases"
+        price_for_single_database
+      when "keyvaluestore"
+        price_for_keyvaluestore(spec)
+      when "opensearch"
+        price_for_opensearch
+      when "bucket"
+        price_for_bucket
+      end
+    end
+
+    def price_for_app(app_data)
+      fetch
+      return nil unless @prices
+
+      spec = app_data["spec"] || app_data
+      status = app_data["status"] || {}
+      for_provider = spec["forProvider"] || {}
+      at_provider = status["atProvider"] || {}
+      config = for_provider["config"] || {}
+
+      size = (config["size"] || "micro").downcase
+      # Use status replicas (actual running) if available, otherwise spec replicas, default to 1
+      replicas = at_provider["replicas"] || for_provider["replicas"] || 1
+      replicas = replicas.to_i
+
+      size_price = @prices.dig("app", size)
+      return nil if size_price.nil?
+
+      size_price * replicas
+    end
+
+    def format_price(price)
+      return "-" if price.nil?
+
+      "CHF #{price}/mo"
+    end
+
+    private
+
+    def load_cached_prices
+      return nil unless File.exist?(CACHE_FILE)
+
+      cache_data = JSON.parse(File.read(CACHE_FILE))
+      cached_at = cache_data["cached_at"]
+      return nil if cached_at.nil? || Time.now.to_i - cached_at > CACHE_TTL
+
+      cache_data["prices"]
+    rescue JSON::ParserError, Errno::ENOENT
+      nil
+    end
+
+    def fetch_and_cache_prices
+      prices = fetch_prices_from_api
+      return nil if prices.nil?
+
+      cache_prices(prices)
+      prices
+    rescue
+      nil
+    end
+
+    def fetch_prices_from_api
+      uri = URI.parse(API_URL)
+      response = Net::HTTP.get_response(uri)
+      return nil unless response.is_a?(Net::HTTPSuccess)
+
+      products = JSON.parse(response.body)
+      build_price_map(products)
+    rescue JSON::ParserError, Net::OpenTimeout, Net::ReadTimeout, SocketError
+      nil
+    end
+
+    def build_price_map(products)
+      prices = {
+        "postgres" => {},
+        "mysql" => {},
+        "keyvaluestore" => {"base" => 15},
+        "opensearch" => {"base" => 60},
+        "single_database" => {"base" => 5},
+        "bucket" => {"base" => 0},
+        "app" => {"micro" => 8, "mini" => 16, "standard-1" => 32, "standard-2" => 58},
+        "ram_per_gib" => 5
+      }
+
+      products.each do |product|
+        name = product["name"]
+        list_price = product["list_price"]
+        categ_path = (product["categ_path"] || []).join("/")
+
+        case name
+        when /^PostgreSQL - (nine-(?:db|single-db)-\S+)/
+          machine_type = normalize_machine_type($1)
+          prices["postgres"][machine_type] = list_price
+        when /^MySQL - (nine-(?:db|single-db)-\S+)/
+          machine_type = normalize_machine_type($1)
+          prices["mysql"][machine_type] = list_price
+        when "Managed Service: Key-Value Store (Redis compatible)"
+          prices["keyvaluestore"]["base"] = list_price
+        when "Managed Service: OpenSearch (Elasticsearch compatible)"
+          prices["opensearch"]["base"] = list_price
+        when "Micro", "Mini", "Standard-1", "Standard-2"
+          # Only use deplo.io app sizes
+          prices["app"][name.downcase] = list_price if categ_path.include?("deplo")
+        end
+      end
+
+      prices
+    end
+
+    def normalize_machine_type(raw)
+      # "nine-single-db-l - 10GB" -> "nine-single-db-l"
+      raw.split(" ").first
+    end
+
+    def cache_prices(prices)
+      FileUtils.mkdir_p(CACHE_DIR)
+      cache_data = {
+        "cached_at" => Time.now.to_i,
+        "prices" => prices
+      }
+      File.write(CACHE_FILE, JSON.pretty_generate(cache_data))
+    end
+
+    def price_for_database(type, spec)
+      for_provider = spec.dig("forProvider") || {}
+      machine_type = for_provider["machineType"] || for_provider["singleDBMachineType"]
+      return nil if machine_type.nil?
+
+      @prices.dig(type, machine_type)
+    end
+
+    def price_for_keyvaluestore(spec)
+      base_price = @prices.dig("keyvaluestore", "base") || 15
+      ram_price = @prices["ram_per_gib"] || 5
+
+      memory_size = spec.dig("forProvider", "memorySize")
+      return base_price if memory_size.nil?
+
+      # Parse memory size (e.g., "256Mi", "1Gi", "512Mi")
+      gib = parse_memory_to_gib(memory_size)
+      (base_price + (gib * ram_price)).round
+    end
+
+    def price_for_opensearch
+      @prices.dig("opensearch", "base") || 60
+    end
+
+    def price_for_single_database
+      # Single databases on shared instances - base price for smallest tier
+      @prices.dig("single_database", "base") || 5
+    end
+
+    def price_for_bucket
+      # Buckets are usage-based, show base/minimum price
+      @prices.dig("bucket", "base") || 0
+    end
+
+    def parse_memory_to_gib(memory_str)
+      case memory_str
+      when /^(\d+(?:\.\d+)?)Gi$/
+        $1.to_f
+      when /^(\d+(?:\.\d+)?)Mi$/
+        $1.to_f / 1024
+      when /^(\d+(?:\.\d+)?)Ki$/
+        $1.to_f / (1024 * 1024)
+      else
+        0
+      end
+    end
+  end
+end

data/lib/deploio/rclone_client.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require "json"
+require "open3"
+
+module Deploio
+  class RcloneClient
+    REMOTE = "DEPLOIO"
+
+    attr_reader :dry_run
+
+    def initialize(endpoint:, access_key:, secret_key:, dry_run: false)
+      @endpoint = endpoint
+      @access_key = access_key
+      @secret_key = secret_key
+      @dry_run = dry_run
+    end
+
+    def check_requirements
+      check_rclone_installed
+    end
+
+    def list(bucket)
+      output = capture("lsjson", remote_path(bucket))
+      return [] if output.nil? || output.empty?
+
+      data = JSON.parse(output)
+      data.is_a?(Array) ? data : []
+    rescue JSON::ParserError
+      []
+    end
+
+    def download(bucket, object, destination)
+      run("copyto", remote_path(bucket, object), destination, "--progress", "--stats-one-line")
+    end
+
+    private
+
+    # --s3-no-check-bucket skips the HeadBucket call, which the read-only bucket
+    # user is not permitted to make.
+    # See also https://docs.nine.ch/docs/object-storage/object-storage-client-tools#rclone
+    def build_command(args)
+      ["rclone", *args.map(&:to_s), "--s3-no-check-bucket"]
+    end
+
+    def remote_path(bucket, object = nil)
+      object ? "#{REMOTE}:#{bucket}/#{object}" : "#{REMOTE}:#{bucket}"
+    end
+
+    def env
+      {
+        "RCLONE_CONFIG_#{REMOTE}_TYPE" => "s3",
+        "RCLONE_CONFIG_#{REMOTE}_PROVIDER" => "Other",
+        "RCLONE_CONFIG_#{REMOTE}_ENDPOINT" => @endpoint,
+        "RCLONE_CONFIG_#{REMOTE}_ACCESS_KEY_ID" => @access_key,
+        "RCLONE_CONFIG_#{REMOTE}_SECRET_ACCESS_KEY" => @secret_key
+      }
+    end
+
+    def capture(*args)
+      cmd = build_command(args)
+      if dry_run
+        Output.command(cmd.join(" "))
+        return ""
+      end
+
+      puts "> #{cmd.join(" ")}" if ENV["DEPLOIO_DEBUG"]
+      stdout, stderr, status = Open3.capture3(env, *cmd)
+      unless status.success?
+        raise Deploio::RcloneError, "rclone command failed: #{stderr}"
+      end
+
+      stdout
+    end
+
+    def run(*args)
+      cmd = build_command(args)
+      Output.command(cmd.join(" "))
+      return true if dry_run
+
+      unless system(env, *cmd)
+        raise Deploio::RcloneError, "rclone command failed: #{cmd.join(" ")}"
+      end
+
+      true
+    end
+
+    def check_rclone_installed
+      _stdout, _stderr, status = Open3.capture3("rclone", "version")
+      return if status.success?
+
+      raise Deploio::RcloneError,
+        "rclone not found. Please install it: brew install rclone"
+    rescue Errno::ENOENT
+      raise Deploio::RcloneError,
+        "rclone not found. Please install it: brew install rclone"
+    end
+  end
+end

data/lib/deploio/shared_options.rb

@@ -7,8 +7,8 @@ module Deploio
     def self.included(base)
       base.class_option :app, aliases: "-a", type: :string, desc: "App in <project>-<app> format"
       base.class_option :org, aliases: "-o", type: :string, desc: "Organization"
-      base.class_option :dry_run, type: :boolean, default: false, desc: "Print commands without executing"
-      base.class_option :no_color, type: :boolean, default: false, desc: "Disable colored output"
+      base.class_option :dry_run, type: :boolean, desc: "Print commands without executing"
+      base.class_option :no_color, type: :boolean, desc: "Disable colored output"
 
       base.define_singleton_method(:exit_on_failure?) { true }
     end
@@ -30,6 +30,7 @@ module Deploio
       @nctl.check_requirements unless merged_options[:dry_run]
     end
 
+    # @return [Deploio::AppRef]
     def resolve_app
       resolver = AppResolver.new(nctl_client: @nctl)
       resolver.resolve(app_name: merged_options[:app])
@@ -37,5 +38,20 @@ module Deploio
       Output.error(e.message)
       exit 1
     end
+
+    # Resolves a project name to its fully qualified form (org-project).
+    # Users can type short names like "myproject" and this will prepend the org.
+    # @param project [String] Project name (short or fully qualified)
+    # @return [String] Fully qualified project name
+    def resolve_project(project)
+      current_org = @nctl.current_org
+      return project unless current_org
+
+      # Special case: project equals org name (default project)
+      return project if project == current_org
+
+      # Always prepend org to get fully qualified name
+      "#{current_org}-#{project}"
+    end
   end
 end