kdeploy 0.1.0

data/lib/kdeploy/template.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+module Kdeploy
+  # ERB template management class
+  class Template
+    attr_reader :path, :content, :variables
+
+    def initialize(template_path, variables = {})
+      @path = template_path
+      @variables = variables
+      @content = load_template
+    end
+
+    # Render template with variables
+    # @param additional_vars [Hash] Additional variables to merge
+    # @return [String] Rendered content
+    def render(additional_vars = {})
+      all_vars = @variables.merge(additional_vars)
+
+      # Create binding with variables
+      template_binding = create_binding(all_vars)
+
+      # Render ERB template
+      erb = ERB.new(@content, trim_mode: '-')
+      erb.result(template_binding)
+    rescue StandardError => e
+      raise TemplateError, "Failed to render template #{@path}: #{e.message}"
+    end
+
+    # Render and save to file
+    # @param output_path [String] Output file path
+    # @param additional_vars [Hash] Additional variables
+    def render_to_file(output_path, additional_vars = {})
+      rendered_content = render(additional_vars)
+
+      # Ensure output directory exists
+      FileUtils.mkdir_p(File.dirname(output_path))
+
+      # Write rendered content
+      File.write(output_path, rendered_content)
+
+      KdeployLogger.info("Template rendered to: #{output_path}")
+      output_path
+    end
+
+    # Check if template file exists
+    # @return [Boolean] True if template exists
+    def exist?
+      File.exist?(@path)
+    end
+
+    # Get template modification time
+    # @return [Time] Template file mtime
+    def mtime
+      File.mtime(@path) if exist?
+    end
+
+    private
+
+    # Load template content from file
+    # @return [String] Template content
+    def load_template
+      raise TemplateError, "Template file not found: #{@path}" unless File.exist?(@path)
+
+      File.read(@path)
+    rescue StandardError => e
+      raise TemplateError, "Failed to load template #{@path}: #{e.message}"
+    end
+
+    # Create binding with variables
+    # @param vars [Hash] Variables hash
+    # @return [Binding] Binding object with variables
+    def create_binding(vars)
+      # Create a clean binding
+      template_binding = binding
+
+      # Define variables in the binding
+      vars.each do |key, value|
+        template_binding.local_variable_set(key.to_sym, value)
+      end
+
+      # Define helper methods
+      template_binding.local_variable_set(:hostname, vars[:hostname] || vars['hostname'])
+      template_binding.local_variable_set(:user, vars[:user] || vars['user'])
+      template_binding.local_variable_set(:port, vars[:port] || vars['port'])
+
+      template_binding
+    end
+  end
+
+  # Template manager for handling multiple templates
+  class TemplateManager
+    attr_reader :template_dir, :global_variables
+
+    def initialize(template_dir = 'templates', global_variables = {})
+      @template_dir = template_dir
+      @global_variables = global_variables
+      @templates = {}
+    end
+
+    # Load template by name
+    # @param template_name [String] Template name (without .erb extension)
+    # @param variables [Hash] Template variables
+    # @return [Template] Template object
+    def load_template(template_name, variables = {})
+      template_path = resolve_template_path(template_name)
+      all_variables = @global_variables.merge(variables)
+
+      @templates[template_name] = Template.new(template_path, all_variables)
+    end
+
+    # Render template by name
+    # @param template_name [String] Template name
+    # @param variables [Hash] Additional variables
+    # @return [String] Rendered content
+    def render(template_name, variables = {})
+      template = @templates[template_name] || load_template(template_name, variables)
+      template.render(variables)
+    end
+
+    # Render template to file
+    # @param template_name [String] Template name
+    # @param output_path [String] Output file path
+    # @param variables [Hash] Additional variables
+    # @return [String] Output file path
+    def render_to_file(template_name, output_path, variables = {})
+      template = @templates[template_name] || load_template(template_name, variables)
+      template.render_to_file(output_path, variables)
+    end
+
+    # List available templates
+    # @return [Array<String>] Template names
+    def list_templates
+      return [] unless Dir.exist?(@template_dir)
+
+      Dir.glob("#{@template_dir}/**/*.erb").map do |path|
+        File.basename(path, '.erb')
+      end
+    end
+
+    # Set global variables
+    # @param variables [Hash] Global variables
+    def global_variables=(variables)
+      @global_variables.merge!(variables)
+    end
+
+    private
+
+    # Resolve template file path
+    # @param template_name [String] Template name
+    # @return [String] Full template path
+    def resolve_template_path(template_name)
+      # Add .erb extension if not present
+      template_name += '.erb' unless template_name.end_with?('.erb')
+
+      # Try template directory first
+      template_path = File.join(@template_dir, template_name)
+      return template_path if File.exist?(template_path)
+
+      # Try relative to current directory
+      return template_name if File.exist?(template_name)
+
+      # Try absolute path
+      return template_name if File.absolute_path?(template_name) && File.exist?(template_name)
+
+      # Default to template directory path (will be checked by Template class)
+      template_path
+    end
+  end
+
+  # Template-related errors
+  class TemplateError < StandardError; end
+end

data/lib/kdeploy/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Kdeploy
+  # Current version of Kdeploy
+  VERSION = '0.1.0'
+end

data/lib/kdeploy.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# External dependencies
+require 'concurrent-ruby'
+require 'net/ssh'
+require 'net/scp'
+require 'yaml'
+require 'logger'
+require 'colorize'
+require 'thor'
+require 'tty-prompt'
+require 'erb'
+require 'fileutils'
+require 'json'
+
+# Internal dependencies - ordered by dependency chain
+module Kdeploy
+  # Load all components
+  autoload :VERSION,        'kdeploy/version'
+  autoload :Configuration,  'kdeploy/configuration'
+  autoload :Logger,         'kdeploy/logger'
+  autoload :Host, 'kdeploy/host'
+  autoload :Inventory,      'kdeploy/inventory'
+  autoload :Template,       'kdeploy/template'
+  autoload :SSHConnection,  'kdeploy/ssh_connection'
+  autoload :Command,        'kdeploy/command'
+  autoload :Task, 'kdeploy/task'
+  autoload :Pipeline, 'kdeploy/pipeline'
+  autoload :DSL,           'kdeploy/dsl'
+  autoload :Runner,        'kdeploy/runner'
+  autoload :Statistics, 'kdeploy/statistics'
+  autoload :Banner,        'kdeploy/banner'
+  autoload :CLI,           'kdeploy/cli'
+
+  # Base error class for Kdeploy
+  class Error < StandardError; end
+
+  # Error raised when connection fails
+  class ConnectionError < Error; end
+
+  # Error raised when command execution fails
+  class CommandError < Error; end
+
+  # Error raised when configuration is invalid
+  class ConfigurationError < Error; end
+
+  class << self
+    attr_accessor :configuration
+    attr_reader :statistics
+
+    # Initialize statistics
+    # @return [Statistics] Statistics instance
+    def statistics
+      @statistics ||= Statistics.new
+    end
+
+    # Configure kdeploy
+    # @yield [Configuration] Configuration instance
+    # @return [Configuration] Configuration instance
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    # Load and execute deployment script
+    # @param script_file [String] Path to deployment script
+    # @return [Pipeline] Loaded pipeline
+    # @raise [ConfigurationError] If script file not found
+    def load_script(script_file)
+      validate_script_file(script_file)
+      script_dir = File.dirname(File.expand_path(script_file))
+      create_pipeline(script_file, script_dir)
+    end
+
+    # Execute deployment pipeline
+    # @param pipeline [Pipeline] Pipeline to execute
+    # @return [Hash] Execution results
+    def execute(pipeline)
+      runner = Runner.new(pipeline)
+      runner.execute
+    end
+
+    # Convenient method to load and execute script
+    # @param script_file [String] Path to deployment script
+    # @return [Hash] Execution results
+    def run(script_file)
+      pipeline = load_script(script_file)
+      execute(pipeline)
+    end
+
+    private
+
+    def validate_script_file(script_file)
+      return if File.exist?(script_file)
+
+      raise ConfigurationError, "Script file not found: #{script_file}"
+    end
+
+    def create_pipeline(script_file, script_dir)
+      dsl = DSL.new(script_dir)
+      dsl.instance_eval(File.read(script_file), script_file)
+      dsl.pipeline
+    end
+  end
+end

data/scripts/common_tasks.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+# Common tasks for kdeploy projects
+# This file demonstrates modular script organization
+#
+# To use this file, include it in your main deployment script:
+# include 'scripts/common_tasks.rb' if File.exist?('scripts/common_tasks.rb')
+
+# ===================================================================
+# HOST DEFINITIONS (Required for remote tasks)
+# ===================================================================
+
+# Define default hosts - update these with your actual hosts
+host 'localhost', user: ENV.fetch('USER', 'deploy'), port: 22, roles: %i[web app db all]
+
+# Uncomment and update these for real deployments:
+# host 'web1.example.com', user: 'deploy', port: 22, roles: [:web, :app]
+# host 'web2.example.com', user: 'deploy', port: 22, roles: [:web, :app]
+# host 'db1.example.com', user: 'deploy', port: 22, roles: [:db]
+
+# ===================================================================
+# COMMON UTILITY TASKS
+# ===================================================================
+
+# Shared pre-deployment checks (LOCAL + REMOTE)
+task 'pre_deploy_checks', on: :all do
+  local 'echo "🔍 Running pre-deployment checks..."'
+  local 'echo "Current user: $(whoami)"'
+  local 'echo "Current directory: $(pwd)"'
+  local 'echo "Git status:" && git status --porcelain || echo "Not a git repository"'
+  local 'echo "✅ Pre-deployment checks completed"'
+
+  # Add a dummy remote command to satisfy validation
+  run 'echo "Pre-deployment check completed on {{hostname}}"'
+end
+
+# Common environment setup
+task 'setup_environment', on: :all do
+  run 'echo "Setting up environment on {{hostname}}..."'
+
+  # Set timezone
+  run 'sudo timedatectl set-timezone UTC', ignore_errors: true
+
+  # Update system packages
+  run 'sudo apt-get update -qq', ignore_errors: true
+
+  # Install common utilities
+  run 'sudo apt-get install -y -qq htop curl wget vim git unzip', ignore_errors: true
+
+  run 'echo "✅ Environment setup completed on {{hostname}}"'
+end
+
+# Common log rotation setup
+task 'setup_log_rotation', on: :all do
+  run 'echo "Setting up log rotation on {{hostname}}..."'
+
+  # Application log rotation
+  run <<~LOGROTATE
+    sudo tee /etc/logrotate.d/{{application}} > /dev/null << 'EOF'
+    {{deploy_to}}/shared/logs/*.log {
+        daily
+        missingok
+        rotate 52
+        compress
+        delaycompress
+        notifempty
+        create 644 {{user}} {{user}}
+        postrotate
+            sudo systemctl reload {{application}} || true
+        endscript
+    }
+    EOF
+  LOGROTATE
+
+  run 'echo "✅ Log rotation setup completed on {{hostname}}"'
+end
+
+# Common system monitoring setup
+task 'setup_monitoring', on: :all do
+  run 'echo "Setting up basic monitoring on {{hostname}}..."'
+
+  # Install system monitoring tools
+  run 'sudo apt-get install -y htop iotop iftop nethogs', ignore_errors: true
+
+  # Setup basic disk space monitoring
+  run <<~MONITORING
+    sudo tee /usr/local/bin/disk-alert.sh > /dev/null << 'EOF'
+    #!/bin/bash
+    THRESHOLD=90
+    USAGE=$(df / | awk 'NR==2 {print $5}' | sed 's/%//')
+    if [ $USAGE -gt $THRESHOLD ]; then
+        echo "Warning: Disk usage is $USAGE% on $(hostname)"
+        logger "Disk usage alert: $USAGE% on $(hostname)"
+    fi
+    EOF
+  MONITORING
+
+  run 'sudo chmod +x /usr/local/bin/disk-alert.sh'
+
+  # Add to crontab
+  run 'echo "0 */6 * * * /usr/local/bin/disk-alert.sh" | sudo crontab -', ignore_errors: true
+
+  run 'echo "✅ Monitoring setup completed on {{hostname}}"'
+end
+
+# Common security hardening
+task 'security_hardening', on: :all do
+  run 'echo "Applying security hardening on {{hostname}}..."'
+
+  # Disable root login
+  run 'sudo sed -i "s/PermitRootLogin yes/PermitRootLogin no/" /etc/ssh/sshd_config', ignore_errors: true
+
+  # Configure firewall basics
+  run 'sudo ufw --force reset', ignore_errors: true
+  run 'sudo ufw default deny incoming', ignore_errors: true
+  run 'sudo ufw default allow outgoing', ignore_errors: true
+  run 'sudo ufw allow ssh', ignore_errors: true
+  run 'sudo ufw allow 80', ignore_errors: true
+  run 'sudo ufw allow 443', ignore_errors: true
+  run 'sudo ufw --force enable', ignore_errors: true
+
+  # Install fail2ban
+  run 'sudo apt-get install -y fail2ban', ignore_errors: true
+  run 'sudo systemctl enable fail2ban', ignore_errors: true
+  run 'sudo systemctl start fail2ban', ignore_errors: true
+
+  run 'echo "✅ Security hardening completed on {{hostname}}"'
+end
+
+# Common performance tuning
+task 'performance_tuning', on: :all do
+  run 'echo "Applying performance tuning on {{hostname}}..."'
+
+  # System limits
+  run <<~LIMITS
+    sudo tee -a /etc/security/limits.conf > /dev/null << 'EOF'
+    * soft nofile 65536
+    * hard nofile 65536
+    * soft nproc 32768
+    * hard nproc 32768
+    EOF
+  LIMITS
+
+  # Kernel parameters
+  run <<~SYSCTL
+    sudo tee -a /etc/sysctl.conf > /dev/null << 'EOF'
+    # Network performance
+    net.core.rmem_max = 16777216
+    net.core.wmem_max = 16777216
+    net.ipv4.tcp_rmem = 4096 65536 16777216
+    net.ipv4.tcp_wmem = 4096 65536 16777216
+    EOF
+  SYSCTL
+
+  run 'sudo sysctl -p', ignore_errors: true
+
+  run 'echo "✅ Performance tuning completed on {{hostname}}"'
+end
+
+# ===================================================================
+# COMMON UTILITY FUNCTIONS
+# ===================================================================
+
+# Health check wrapper (LOCAL + REMOTE)
+task 'health_check_all', on: :all do
+  local 'echo "🏥 Running comprehensive health checks..."'
+
+  # You can call other scripts from here
+  local 'echo "1. System health check"'
+  local 'echo "2. Application health check"'
+  local 'echo "3. Service status check"'
+  local 'echo "✅ Health checks completed"'
+
+  # Add a dummy remote command to satisfy validation
+  run 'echo "Health check completed on {{hostname}}"'
+end
+
+# ===================================================================
+# EMERGENCY PROCEDURES
+# ===================================================================
+
+# Emergency stop all services
+task 'emergency_stop', on: :all do
+  run 'echo "🚨 Emergency stop initiated on {{hostname}}"'
+  run 'sudo systemctl stop nginx || echo "nginx not found"', ignore_errors: true
+  run 'sudo systemctl stop apache2 || echo "apache2 not found"', ignore_errors: true
+  run 'echo "🛑 Services stopped on {{hostname}}"'
+end
+
+# Emergency start all services
+task 'emergency_start', on: :all do
+  run 'echo "🚨 Emergency start initiated on {{hostname}}"'
+  run 'sudo systemctl start nginx || echo "nginx not found"', ignore_errors: true
+  run 'sudo systemctl start apache2 || echo "apache2 not found"', ignore_errors: true
+  run 'echo "🚀 Services started on {{hostname}}"'
+end
+
+# ===================================================================
+# USAGE EXAMPLES
+# ===================================================================
+#
+# This file can be included in your main deploy.rb script:
+#
+# include 'scripts/common_tasks.rb' if File.exist?('scripts/common_tasks.rb')
+#
+# Then you can call these tasks from your deployment workflow:
+#
+# task 'full_setup' do
+#   run_task 'pre_deploy_checks'
+#   run_task 'setup_environment'
+#   run_task 'security_hardening'
+#   run_task 'performance_tuning'
+# end
+#
+# Or run individual tasks:
+# kdeploy deploy scripts/common_tasks.rb --task setup_environment
+# kdeploy deploy scripts/common_tasks.rb --task security_hardening
+# kdeploy deploy scripts/common_tasks.rb --task emergency_stop

data/scripts/deploy.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Simple kdeploy test deployment script - only using local commands
+
+# Set global variables
+set 'application', 'myapp'
+set 'hostname', 'localhost'
+set 'version', '1.0.0'
+
+# All commands are executed locally, no SSH required
+local 'echo "=== Starting kdeploy deployment process ==="'
+local 'echo "Application: {{application}}"'
+local 'echo "Version: {{version}}"'
+local 'echo "Target: {{hostname}}"'
+local 'echo "Current user: $(whoami)"'
+local 'echo "Current date: $(date)"'
+
+local 'echo "=== Preparation Phase ==="'
+local 'echo "Preparing deployment environment..."'
+local 'mkdir -p /tmp/kdeploy-test'
+local 'echo "Environment prepared!"'
+
+local 'echo "=== Build Phase ==="'
+local 'echo "Building application..."'
+local 'sleep 1'
+local 'echo "Build completed successfully!"'
+
+local 'echo "=== Testing Phase ==="'
+local 'echo "Running tests..."'
+local 'echo "Test 1: Basic functionality... PASSED"'
+local 'echo "Test 2: Integration tests... PASSED"'
+local 'echo "All tests passed!"'
+
+local 'echo "=== Deployment Phase ==="'
+local 'echo "Deploying to {{hostname}}..."'
+local 'echo "{{application}} {{version}}" > /tmp/kdeploy-test/version.txt'
+local 'echo "Application deployed to /tmp/kdeploy-test/"'
+
+local 'echo "=== Verification Phase ==="'
+local 'echo "Verifying deployment..."'
+local 'cat /tmp/kdeploy-test/version.txt'
+local 'echo "Deployment verification completed!"'
+
+local 'echo "=== Cleanup Phase ==="'
+local 'echo "Cleaning up temporary files..."'
+local 'rm -rf /tmp/kdeploy-test'
+local 'echo "Cleanup completed!"'
+
+local 'echo "=== Deployment Complete ==="'
+local 'echo "{{application}} {{version}} successfully deployed!"'