kitsune-kit 0.1.0

data/lib/kitsune/kit/commands/init.rb

@@ -0,0 +1,148 @@
+require "thor"
+require "fileutils"
+
+module Kitsune
+  module Kit
+    module Commands
+      class Init < Thor
+        namespace "init"
+
+        default_task :init
+
+        desc "init", "Initialize Kitsune Kit project structure"
+        def init
+          say "✨ Initializing Kitsune project...", :green
+          create_base_structure
+          selected_envs = select_environments
+          copy_env_templates(selected_envs)
+          selected_default_env = select_default_environment(selected_envs)
+          create_kit_env(selected_default_env)
+          copy_docker_templates
+          say "🎉 Done! '.kitsune/' structure is ready.", :green
+        end
+
+        no_commands do
+          def blueprint_path(relative_path)
+            File.expand_path("../../blueprints/#{relative_path}", __dir__)
+          end
+
+          def create_base_structure
+            dirs = [
+              ".kitsune",
+              ".kitsune/docker"
+            ]
+            dirs.each do |dir|
+              unless Dir.exist?(dir)
+                FileUtils.mkdir_p(dir)
+                say "📂 Created directory: #{dir}", :cyan
+              else
+                say "📂 Directory already exists: #{dir}", :yellow
+              end
+            end
+          end
+
+          def environments_options
+            {
+              "1" => "development",
+              "2" => "production",
+              "3" => "staging",
+              "4" => "test"
+            }
+          end
+
+          def select_environments
+            say "🌎 Which environments do you want to create?", :cyan
+            environments_options.each do |number, env|
+              say "  #{number}) #{env}"
+            end
+            input = ask("➡️  Enter numbers separated by commas (or type 'all') [default: all]:", :yellow)
+            input = input.strip.downcase
+
+            if input.empty? || input == "all"
+              environments_options.values
+            else
+              selected = input.split(",").map(&:strip)
+              environments = selected.map { |num| environments_options[num] }.compact
+              if environments.empty?
+                say "⚠️ Invalid selection. Creating all environments.", :yellow
+                environments_options.values
+              else
+                environments
+              end
+            end
+          end
+
+          def select_default_environment(selected_envs)
+            say "🎯 Which environment should be set as default in '.kitsune/kit.env'?", :cyan
+            selected_envs.each_with_index do |env, index|
+              say "  #{index + 1}) #{env}"
+            end
+            input = ask("➡️  Enter number [default: 1]:", :yellow)
+            input = input.strip
+
+            if input.empty?
+              selected_envs[0] # default to first selected
+            else
+              index = input.to_i - 1
+              if index >= 0 && index < selected_envs.size
+                selected_envs[index]
+              else
+                say "⚠️ Invalid selection. Defaulting to '#{selected_envs[0]}'", :yellow
+                selected_envs[0]
+              end
+            end
+          end
+
+          def create_kit_env(default_env)
+            path = ".kitsune/kit.env"
+            template = File.read(blueprint_path("kit.env.template"))
+            content = template.gsub("KIT_ENV=development", "KIT_ENV=#{default_env}")
+          
+            if File.exist?(path)
+              if yes?("⚠️  File #{path} already exists. Overwrite? [y/N]", :yellow)
+                File.write(path, content)
+                say "✅ Overwritten: #{path}", :cyan
+              else
+                say "⏩ Skipped: #{path}", :yellow
+              end
+            else
+              File.write(path, content)
+              say "📝 Created: #{path}", :cyan
+            end
+
+            say ""
+            say "🎯 Kitsune Kit environment set to: #{default_env}", :green
+            say "📄 Environment file used: .kitsune/infra.#{default_env}.env", :green
+            say ""
+          end
+
+          def copy_env_templates(selected_envs)
+            selected_envs.each do |env|
+              dest_path = ".kitsune/infra.#{env}.env"
+              copy_with_prompt(blueprint_path(".env.template"), dest_path)
+            end
+          end
+
+          def copy_docker_templates
+            dest_path = ".kitsune/docker/postgres.yml"
+            copy_with_prompt(blueprint_path("docker/postgres.yml"), dest_path)
+          end
+
+          def copy_with_prompt(source, destination)
+            if File.exist?(destination)
+              if yes?("⚠️  File #{destination} already exists. Overwrite? [y/N]", :yellow)
+                FileUtils.cp(source, destination)
+                say "✅ Overwritten: #{destination}", :cyan
+              else
+                say "⏩ Skipped: #{destination}", :yellow
+              end
+            else
+              FileUtils.cp(source, destination)
+              say "📝 Created: #{destination}", :cyan
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kitsune/kit/commands/install_docker_engine.rb

@@ -0,0 +1,146 @@
+require "thor"
+require "net/ssh"
+require_relative "../defaults"
+require_relative "../options_builder"
+
+module Kitsune
+  module Kit
+    module Commands
+      class InstallDockerEngine < Thor
+        namespace "install_docker_engine"
+
+        class_option :server_ip,    aliases: "-s", required: true, desc: "Server IP address or hostname"
+        class_option :ssh_port,     aliases: "-p", desc: "SSH port"
+        class_option :ssh_key_path, aliases: "-k", desc: "Path to your private SSH key"
+
+        desc "create", "Install Docker Engine on the remote server"
+        def create
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_setup(ssh)
+          end
+        end
+
+        desc "rollback", "Uninstall Docker Engine from the remote server"
+        def rollback
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_rollback(ssh)
+          end
+        end
+
+        no_commands do
+          def with_ssh_connection(filled_options)
+            server = filled_options[:server_ip]
+            port   = filled_options[:ssh_port]
+            key    = File.expand_path(filled_options[:ssh_key_path])
+
+            say "🔑 Connecting as deploy@#{server}:#{port}", :green
+            Net::SSH.start(server, "deploy", port: port, keys: [key], non_interactive: true, timeout: 5) do |ssh|
+              yield ssh
+            end
+          end
+
+          def perform_setup(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="install_docker_engine"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              TARGET_PKGS=(docker-ce docker-ce-cli containerd.io)
+
+              echo "✍🏻 TARGET_PKGS=(\${TARGET_PKGS[*]})"
+
+              if [ ! -f "$AFTER_FILE" ]; then
+                for pkg in "\${TARGET_PKGS[@]}"; do
+                  if dpkg -l "\$pkg" &>/dev/null; then
+                    echo "\$pkg" >> "$BEFORE_FILE"
+                  fi
+                done
+
+                if [ ! -f /usr/share/keyrings/docker-archive-keyring.gpg ]; then
+                  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
+                fi
+
+                if [ ! -f /etc/apt/sources.list.d/docker.list ]; then
+                  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+                fi
+
+                echo "✍🏻 Installing Docker Engine..."
+                sudo apt-get update -y
+                sudo apt-get install -y "\${TARGET_PKGS[@]}"
+                sudo touch "$AFTER_FILE" && echo "   - marker at $AFTER_FILE"
+                echo "✅ Docker installed"
+              else
+                echo "🔄 Docker already set up, ensuring latest..."
+                sudo apt-get update -y
+                sudo apt-get install -y "\${TARGET_PKGS[@]}"
+                echo "✅ Docker packages are current"
+              fi
+            EOH
+            say output
+            say "✅ Docker Engine setup completed", :green
+          end
+
+          def perform_rollback(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="install_docker_engine"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              TARGET_PKGS=(docker-ce docker-ce-cli containerd.io)
+
+              echo "✍🏻 TARGET_PKGS=(\${TARGET_PKGS[*]})"
+
+              if [ -f "$AFTER_FILE" ]; then
+                to_remove=()
+                for pkg in "\${TARGET_PKGS[@]}"; do
+                  if dpkg -l "\$pkg" &>/dev/null && ! grep -Fxq "\$pkg" "$BEFORE_FILE"; then
+                    to_remove+=("\$pkg")
+                  fi
+                done
+
+                if [ \${#to_remove[@]} -gt 0 ]; then
+                  echo "🔁 Removing Docker packages..."
+                  sudo apt-get remove -y "\${to_remove[@]}" && echo "   - removed: \${to_remove[*]}"
+                else
+                  echo "   - no Docker packages to remove"
+                fi
+
+                sudo rm -f "$BEFORE_FILE" "$AFTER_FILE" && echo "   - cleanup markers"
+              else
+                echo "   - no marker for $SCRIPT_ID, skipping"
+              fi
+
+              echo "✅ Rollback done"
+            EOH
+            say output
+            say "✅ Docker Engine rollback completed", :green
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kitsune/kit/commands/postinstall_docker.rb

@@ -0,0 +1,142 @@
+require "thor"
+require "net/ssh"
+require_relative "../defaults"
+require_relative "../options_builder"
+
+module Kitsune
+  module Kit
+    module Commands
+      class PostinstallDocker < Thor
+        namespace "postinstall_docker"
+
+        class_option :server_ip,    aliases: "-s", required: true, desc: "Server IP address or hostname"
+        class_option :ssh_port,     aliases: "-p", desc: "SSH port"
+        class_option :ssh_key_path, aliases: "-k", desc: "Path to your private SSH key"
+
+        desc "create", "Apply Docker post-install configuration (start service, add groups, create network)"
+        def create
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_setup(ssh)
+          end
+        end
+
+        desc "rollback", "Undo Docker post-install configuration"
+        def rollback
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_rollback(ssh)
+          end
+        end
+
+        no_commands do
+          def with_ssh_connection(filled_options)
+            server = filled_options[:server_ip]
+            port   = filled_options[:ssh_port]
+            key    = File.expand_path(filled_options[:ssh_key_path])
+
+            say "🔑 Connecting as deploy@#{server}:#{port}", :green
+            Net::SSH.start(server, "deploy", port: port, keys: [key], non_interactive: true, timeout: 5) do |ssh|
+              yield ssh
+            end
+          end
+
+          def perform_setup(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="postinstall_docker"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              echo "✍🏻 Performing post-install Docker tasks"
+
+              if [ ! -f "$AFTER_FILE" ]; then
+                # Record state
+                systemctl is-enabled docker &>/dev/null && echo "docker.service enabled" >> "$BEFORE_FILE" || echo "docker.service disabled" >> "$BEFORE_FILE"
+                groups deploy | grep -q docker && echo "deploy in docker group" >> "$BEFORE_FILE" || echo "deploy not in docker group" >> "$BEFORE_FILE"
+                sudo docker network inspect private &>/dev/null && echo "network private exists" >> "$BEFORE_FILE" || echo "network private absent" >> "$BEFORE_FILE"
+
+                # Start and enable Docker
+                sudo systemctl start docker
+                sudo systemctl enable docker
+                echo "🚀 Docker service started and enabled"
+                echo "docker.service enabled" >> "$AFTER_FILE"
+
+                # Add deploy to docker group
+                sudo usermod -aG docker deploy
+                echo "👥 Added 'deploy' to docker group"
+                echo "added docker group" >> "$AFTER_FILE"
+
+                # Create private network if missing
+                if ! sudo docker network inspect private &>/dev/null; then
+                  sudo docker network create -d bridge private
+                  echo "🌐 Created Docker network 'private'"
+                  echo "created network private" >> "$AFTER_FILE"
+                fi
+
+                echo "✅ Post-install Docker tasks complete"
+              else
+                echo "🔄 Post-install tasks already applied, skipping setup"
+              fi
+            EOH
+            say output
+            say "✅ Post-install Docker setup completed", :green
+          end
+
+          def perform_rollback(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="postinstall_docker"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              echo "🔄 Rolling back post-install Docker tasks..."
+
+              if [ -f "$AFTER_FILE" ]; then
+                if grep -Fxq "docker.service enabled" "$AFTER_FILE"; then
+                  sudo systemctl disable docker
+                  echo "   - Docker service disabled"
+                fi
+                if grep -Fxq "added docker group" "$AFTER_FILE"; then
+                  sudo gpasswd -d deploy docker || true
+                  echo "   - Removed 'deploy' from docker group"
+                fi
+                if grep -Fxq "created network private" "$AFTER_FILE"; then
+                  sudo docker network rm private || true
+                  echo "   - Removed Docker network 'private'"
+                fi
+                sudo rm -f "$BEFORE_FILE" "$AFTER_FILE"
+              else
+                echo "   - no marker for $SCRIPT_ID, skipping rollback"
+              fi
+
+              echo "✅ Rollback complete"
+            EOH
+            say output
+            say "✅ Post-install Docker rollback completed", :green
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kitsune/kit/commands/provision.rb

@@ -0,0 +1,43 @@
+require "thor"
+require_relative "../defaults"
+require_relative "../provisioner"
+require_relative "../options_builder"
+
+module Kitsune
+  module Kit
+    module Commands
+      class Provision < Thor
+        namespace "provision"
+
+        class_option :droplet_name, type: :string, aliases: "-n", desc: "Droplet name"
+        class_option :region, type: :string, aliases: "-r", desc: "Region"
+        class_option :size, type: :string, aliases: "-s", desc: "Size"
+        class_option :image, type: :string, aliases: "-i", desc: "Image"
+        class_option :tag, type: :string, aliases: "-t", desc: "Tag to filter/create"
+        class_option :ssh_key_id, type: :string, aliases: "-k", desc: "SSH key ID"
+
+        desc "create", "Create the Droplet if it doesn't exist"
+        def create
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:ssh_key_id],
+            defaults: Kitsune::Kit::Defaults.infra
+          )
+
+          Provisioner.new(filled_options).create_or_show
+        end
+
+        desc "rollback", "Remove the Droplet if it exists"
+        def rollback
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:ssh_key_id],
+            defaults: Kitsune::Kit::Defaults.infra
+          )
+
+          Provisioner.new(filled_options).rollback
+        end
+      end
+    end
+  end
+end

data/lib/kitsune/kit/commands/setup_docker_prereqs.rb

@@ -0,0 +1,150 @@
+require "thor"
+require "net/ssh"
+require_relative "../options_builder"
+require_relative "../defaults"
+
+module Kitsune
+  module Kit
+    module Commands
+      class SetupDockerPrereqs < Thor
+        namespace "setup_docker_prereqs"
+
+        class_option :server_ip,    aliases: "-s", required: true, desc: "Server IP address or hostname"
+        class_option :ssh_port,     aliases: "-p", desc: "SSH port"
+        class_option :ssh_key_path, aliases: "-k", desc: "Path to your private SSH key"
+
+        desc "create", "Install Docker prerequisites on the remote server"
+        def create
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_setup(ssh)
+          end
+        end
+
+        desc "rollback", "Remove installed Docker prerequisites from the remote server"
+        def rollback
+          filled_options = Kitsune::Kit::OptionsBuilder.build(
+            options,
+            required: [:server_ip],
+            defaults: Kitsune::Kit::Defaults.ssh
+          )
+
+          with_ssh_connection(filled_options) do |ssh|
+            perform_rollback(ssh)
+          end
+        end
+
+        no_commands do
+          def with_ssh_connection(filled_options)
+            server = filled_options[:server_ip]
+            port   = filled_options[:ssh_port]
+            key    = File.expand_path(filled_options[:ssh_key_path])
+
+            say "🔑 Connecting as deploy@#{server}:#{port}", :green
+            Net::SSH.start(server, "deploy", port: port, keys: [key], non_interactive: true, timeout: 5) do |ssh|
+              yield ssh
+            end
+          end
+
+          def perform_setup(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="setup_docker_prereqs"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              TARGET_PKGS=(
+                apt-transport-https
+                ca-certificates
+                curl
+                gnupg
+                lsb-release
+                software-properties-common
+              )
+
+              echo "✍🏻 TARGET_PKGS=(\${TARGET_PKGS[*]})"
+
+              if [ ! -f "$AFTER_FILE" ]; then
+                for pkg in "\${TARGET_PKGS[@]}"; do
+                  if dpkg -l "\$pkg" &>/dev/null; then
+                    echo "\$pkg" >> "$BEFORE_FILE"
+                  fi
+                done
+
+                echo "✍🏻 Installing prerequisites..."
+                sudo apt-get update -y
+                sudo apt-get install -y "\${TARGET_PKGS[@]}"
+                sudo touch "$AFTER_FILE" && echo "   - marker created at $AFTER_FILE"
+              else
+                sudo apt-get update -y
+                sudo apt-get install -y "\${TARGET_PKGS[@]}"
+                echo "✅ Prerequisites are current"
+              fi
+            EOH
+            say output
+            say "✅ Docker prerequisites setup completed", :green
+          end
+
+          def perform_rollback(ssh)
+            output = ssh.exec! <<~EOH
+              set -e
+
+              sudo mkdir -p /usr/local/backups
+              sudo chown deploy:deploy /usr/local/backups
+
+              BACKUP_DIR="/usr/local/backups"
+              SCRIPT_ID="setup_docker_prereqs"
+              BEFORE_FILE="${BACKUP_DIR}/${SCRIPT_ID}.before"
+              AFTER_FILE="${BACKUP_DIR}/${SCRIPT_ID}.after"
+
+              TARGET_PKGS=(
+                apt-transport-https
+                ca-certificates
+                curl
+                gnupg
+                lsb-release
+                software-properties-common
+              )
+
+              echo "✍🏻 TARGET_PKGS=(\${TARGET_PKGS[*]})"
+
+              if [ -f "$AFTER_FILE" ]; then
+                to_remove=()
+                for pkg in "\${TARGET_PKGS[@]}"; do
+                  if dpkg -l "\$pkg" &>/dev/null; then
+                    if ! grep -Fxq "\$pkg" "$BEFORE_FILE"; then
+                      to_remove+=("\$pkg")
+                    fi
+                  fi
+                done
+
+                if [ \${#to_remove[@]} -gt 0 ]; then
+                  echo "🔁 Removing packages..."
+                  sudo apt-get remove -y "\${to_remove[@]}" && echo "   - removed: \${to_remove[*]}"
+                else
+                  echo "   - no new packages to remove"
+                fi
+
+                sudo rm -f "$BEFORE_FILE" "$AFTER_FILE" && echo "   - backups removed"
+              else
+                echo "   - no marker for $SCRIPT_ID, skipping removal"
+              fi
+            EOH
+            say output
+            say "✅ Docker prerequisites rollback completed", :green
+          end
+        end
+      end
+    end
+  end
+end