gjallarhorn 0.1.0.alpha → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1803a8eea18b207eaee8efb506435449e7bc44e7b7d42f5641c937600f232f1
-  data.tar.gz: e34842e3170ebdc2ea1b51ec9fc66526985fc9c4a2c159bfcedc60bbaf980bd4
+  metadata.gz: 30d18c641ccd046fc6231c52f2b28e9f4dbc80c0b27c73720d9edeea2e30790d
+  data.tar.gz: 77e143189ef34521f543777f698e081b18229f1cf6dd84e7a0297a200dec6a30
 SHA512:
-  metadata.gz: 247368e61b771afc91243fade7d0cededffeac32be6252692a43d75abc35ca9445ccbfaad79a1ec0df6da68a3f5eed34f4ca7dbb6ee39350ab64cf8a0ed953ed
-  data.tar.gz: 7b1d4a4f148def633aa427874f5079ae38404099bea1ed858bb16f21e286b4433f31a9aca1f87c3cc1716c76150238c8bb9b22e194f2aad4847e87fc914dd0a7
+  metadata.gz: 84bbcfa4911590da498b8c786d81c52df80b9ac1d15e1d9030641126a4b9e747c90a681f728f559a2d1e62b83c13ae1b93162e64a9fe014950319cde691b4608
+  data.tar.gz: 9c5b625499b0e907348909f23ecbf945ef13cd97cbab9743a62df545498fa0f81e3ecd2fc13d1e4d508ba7bd44790270ff3bb5e7569370b66ed84e8ce0c6394e

data/.yardopts

@@ -0,0 +1,12 @@
+--markup markdown
+--markup-provider kramdown
+--readme README.md
+--output-dir doc
+--exclude test/
+--exclude examples/
+--exclude docs/
+--private
+lib/**/*.rb
+-
+CHANGELOG.md
+LICENSE.txt

data/README.md

@@ -2,12 +2,18 @@
 
 Multi-cloud deployment guardian as legendary as Heimdall's horn.
 
-> **⚠️ ALPHA RELEASE NOTICE**  
-> This gem is currently in alpha development and **NOT RECOMMENDED FOR PRODUCTION USE**. We are publishing this early version to RubyGems.org primarily to secure the `gjallarhorn` gem name. The API and functionality are subject to significant changes. Use at your own risk.
+A Ruby gem that sounds across all cloud realms with secure, API-first deployments beyond SSH. Currently supporting AWS with additional providers planned for future releases.
 
-A Ruby gem that sounds across all cloud realms with secure, API-first deployments beyond SSH:
+## Features
 
-- AWS (SSM)
+**Phase 1 (0.1.0) - AWS Foundation:**
+- ✅ AWS SSM-based deployments (no SSH required)
+- ✅ Thor-based CLI with comprehensive commands
+- ✅ YAML configuration system
+- ✅ Comprehensive test coverage
+- ✅ Complete YARD documentation
+
+**Future Phases:**
 - Google Cloud Platform (Compute Engine API)
 - Microsoft Azure (Run Command API)
 - Self-hosted Docker (Docker API)
@@ -16,23 +22,124 @@ A Ruby gem that sounds across all cloud realms with secure, API-first deployment
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
 Install the gem and add to the application's Gemfile by executing:
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+bundle add gjallarhorn
 ```
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+gem install gjallarhorn
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
+### Configuration
+
+Create a `deploy.yml` file in your project root:
+
+```yaml
+production:
+  provider: aws
+  region: us-west-2
+  services:
+    - name: web
+      ports: ["80:8080"]
+      env:
+        RAILS_ENV: production
+        DATABASE_URL: postgresql://user:pass@host/db
+
+staging:
+  provider: aws
+  region: us-west-2
+  services:
+    - name: web
+      ports: ["80:8080"]
+      env:
+        RAILS_ENV: staging
+```
+
+### CLI Commands
+
+Deploy to an environment:
+```bash
+gjallarhorn deploy production myapp:v1.2.3
+```
+
+Check deployment status:
+```bash
+gjallarhorn status production
+```
+
+Rollback to previous version:
+```bash
+gjallarhorn rollback production v1.2.2
+```
+
+View configuration:
+```bash
+gjallarhorn config
+```
+
+Show version:
+```bash
+gjallarhorn version
+```
+
+### AWS Prerequisites
+
+Ensure your EC2 instances have:
+- SSM Agent installed and running
+- Appropriate IAM roles for SSM access
+- Tags: `Environment` (e.g., "production") and `Role` (e.g., "web", "app")
+- Docker installed and running
+
+#### Required IAM Permissions
+
+Your EC2 instances need an IAM role with the following permissions:
+
+**For SSM access:**
+```json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ssm:UpdateInstanceInformation",
+                "ssmmessages:CreateControlChannel",
+                "ssmmessages:CreateDataChannel",
+                "ssmmessages:OpenControlChannel",
+                "ssmmessages:OpenDataChannel"
+            ],
+            "Resource": "*"
+        }
+    ]
+}
+```
+
+**For ECR access (when deploying from ECR):**
+```json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ecr:GetAuthorizationToken",
+                "ecr:BatchCheckLayerAvailability",
+                "ecr:GetDownloadUrlForLayer",
+                "ecr:BatchGetImage"
+            ],
+            "Resource": "*"
+        }
+    ]
+}
+```
+
+You can use the AWS managed policy `AmazonSSMManagedInstanceCore` for SSM access, and create a custom policy for ECR access.
 
 ## Development
 

data/examples/zero-downtime-deployment.rb

@@ -0,0 +1,104 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example of zero-downtime deployment with Gjallarhorn
+# This demonstrates the new deployment architecture with strategies and proxy management
+
+require_relative "../lib/gjallarhorn"
+
+# Example configuration for zero-downtime deployment
+config_yml = <<~YAML
+  production:
+    provider: aws
+    region: us-west-2
+  #{"  "}
+    # Proxy configuration for zero-downtime deployments
+    proxy:
+      type: nginx
+      domain: myapp.example.com
+      ssl: true
+      health_check_path: /health
+      conf_dir: /etc/nginx/conf.d
+  #{"    "}
+    services:
+      - name: web
+        ports: ["80:3000"]
+        env:
+          RAILS_ENV: production
+          DATABASE_URL: postgresql://db.example.com/myapp_production
+        healthcheck:
+          type: http
+          path: /health
+          port: 3000
+          expected_status: [200, 204]
+          max_attempts: 30
+          interval: 3
+        drain_timeout: 30
+        restart_policy: unless-stopped
+  #{"    "}
+      - name: worker
+        env:
+          RAILS_ENV: production
+          DATABASE_URL: postgresql://db.example.com/myapp_production
+        cmd: bundle exec sidekiq
+        healthcheck:
+          type: command
+          command: pgrep -f sidekiq
+        restart_policy: unless-stopped
+YAML
+
+# Write temporary config file
+require "tempfile"
+config_file = Tempfile.new(["deploy", ".yml"])
+config_file.write(config_yml)
+config_file.close
+
+begin
+  # Initialize deployer
+  Gjallarhorn::Deployer.new(config_file.path)
+
+  puts "🚀 Starting zero-downtime deployment..."
+  puts "=" * 50
+
+  # Deploy with zero-downtime strategy (default)
+  puts "\n1. Deploying with zero-downtime strategy:"
+  puts "   - Starts new containers alongside existing ones"
+  puts "   - Waits for health checks to pass"
+  puts "   - Switches nginx proxy traffic to new containers"
+  puts "   - Gracefully stops old containers"
+  puts ""
+
+  # This would perform the actual deployment:
+  # deployer.deploy('production', 'myapp:v2.1.0')
+
+  # For demo purposes, show what strategies are available
+  puts "✅ Available deployment strategies:"
+  puts "   - zero_downtime: Full zero-downtime with proxy switching (default)"
+  puts "   - basic: Stop old containers, start new ones (downtime expected)"
+  puts "   - legacy: Use original adapter interface (for compatibility)"
+
+  puts "\n📊 Zero-downtime deployment features:"
+  puts "   ✅ Container orchestration with health checks"
+  puts "   ✅ Nginx proxy management with traffic switching"
+  puts "   ✅ Graceful container shutdown with drain timeout"
+  puts "   ✅ Container versioning and cleanup"
+  puts "   ✅ Rollback support (keeps old containers for quick rollback)"
+  puts "   ✅ Multiple service support (web + worker)"
+  puts "   ✅ HTTP and command-based health checks"
+
+  puts "\n🔧 Proxy managers supported:"
+  puts "   ✅ Nginx (fully implemented)"
+  puts "   🚧 Traefik (placeholder - future release)"
+  puts "   🚧 Kamal-proxy (placeholder - future release)"
+
+  puts "\n💡 Usage examples:"
+  puts "   deployer.deploy('production', 'myapp:v2.1.0')                    # Zero-downtime (default)"
+  puts "   deployer.deploy('production', 'myapp:v2.1.0', strategy: 'basic') # Basic deployment"
+  puts "   deployer.deploy_with_strategy('production', 'myapp:v2.1.0', 'zero_downtime')"
+rescue Gjallarhorn::ConfigurationError => e
+  puts "❌ Configuration error: #{e.message}"
+rescue Gjallarhorn::DeploymentError => e
+  puts "❌ Deployment error: #{e.message}"
+ensure
+  config_file&.unlink
+end