hasna/skills/skill-deploy

skill-deploy

Description

Deployment automation skill for EC2 instances. Automates git pull, service restart, and health checks for configured hosts.

Category

DevOps / Deployment / Automation

Commands

deploy

Deploy to one or more hosts with git pull, service restart, and health check.

bun run src/index.ts deploy <host...> [options]

Options:

• --all - Deploy to all configured hosts
• --parallel, -p - Deploy to multiple hosts in parallel
• --skip-health - Skip health check after deployment
• --skip-restart - Skip service restart (only pull code)
• --verbose, -v - Show detailed output
• --dry-run - Preview deployment without making changes
• --force, -f - Force deployment even if already up-to-date

list / hosts

List all configured deployment hosts.

bun run src/index.ts list

health

Run health check on a deployed service.

bun run src/index.ts health <host>

status

Check systemd service status on a host.

bun run src/index.ts status <host>

Dependencies

• Bun: Runtime environment
• SSH: Configured SSH access to target hosts
• Git: Git repositories on target hosts
• systemd: For service management (optional)

Integration

Use Cases

1. Manual Deployments: Deploy latest code to any environment on demand
2. CI/CD Pipeline: Automate deployments from GitHub Actions
3. Health Monitoring: Check service status and health endpoints
4. Multi-Environment: Support for lab, staging, and production environments

Example: Deploy from Local

# Deploy single host
bun run src/index.ts deploy lab-mcp

# Deploy multiple hosts sequentially
bun run src/index.ts deploy lab-mcp prod-skill

# Deploy all hosts in parallel
bun run src/index.ts deploy --all --parallel

# Deploy with verbose logging
bun run src/index.ts deploy lab-mcp --verbose

Example: CI/CD Integration

# .github/workflows/deploy.yml
name: Deploy
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Deploy
        run: |
          cd skill-deploy
          bun install
          bun run src/index.ts deploy lab-mcp

Configuration

Hosts are configured in src/hosts.ts:

{
  name: 'Display Name',
  sshHost: 'ssh-config-hostname',
  deployPath: '/opt/myapp',
  service: 'myapp.service',
  healthUrl: 'http://localhost:PORT/health',
  gitRepo: '[email protected]:org/repo.git',
  gitBranch: 'main',
  user: 'ec2-user'
}

Supported Hosts

• lab-mcp: Lab environment for MCP services
• prod-skill: Production skill server

Deployment Process

1. SSH to target host
2. Pull latest code from configured branch
3. Restart systemd service (if configured)
4. Run health check (if configured)
5. Report results with detailed status

Requirements

• SSH keys configured in ~/.ssh/config
• Git SSH access to repositories
• Sudo permissions for service management
• Health endpoints (optional)