aayi 0.1.1__tar.gz

aayi-0.1.1/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.3
+Name: aayi
+Version: 0.1.1
+Summary: Deploy Docker apps to any server with zero downtime and automatic HTTPS
+Author: Ahmed
+Author-email: Ahmed <thlurte@gmail.com>
+Requires-Dist: asyncssh>=2.14.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/banner.jpeg" alt="Aayi - Modern Cloud Deployment Dev Tool" width="100%">
+</p>
+
+# Aayi
+
+Deploy Docker apps to any server with zero downtime and automatic HTTPS.
+
+Built with uv, AsyncSSH, Typer, Pydantic, and Caddy.
+
+---
+
+## Features
+
+- **Zero-Downtime Container Swaps**: Routes traffic between container revisions via Caddy's dynamic in-memory Admin API (`:2019`).
+- **Automatic HTTPS**: Full TLS certificate lifecycle via Let's Encrypt / ZeroSSL powered by Caddy.
+- **Docker Compose & Multi-Container**: Deploy multi-service applications directly from `docker-compose.yml` or multi-service `deploy.yml`.
+- **Public vs. Private Containers**:
+  - **Public**: Dedicated domain per container (e.g. `app.example.com` and `api.example.com`) with automatic Caddy TLS.
+  - **Private**: Background workers, databases, and microservices connected to internal `aayi-net` with no host port exposure.
+- **Concurrent SSH Execution**: Asynchronous, parallel multi-server operations powered by AsyncSSH.
+- **Type-Safe Declarative Config**: Strict validation of `config/deploy.yml` with friendly Pydantic v2 error messages.
+- **GitHub Actions Ready**: Out-of-the-box CI/CD generator (`aayi ci init`).
+- **No Ruby Required**: Built for developers who want Kamal's simplicity without installing Ruby or gem bundlers.
+- **Stateful Accessories**: Spin up and manage PostgreSQL, Redis, or MySQL containers with persistent Docker volumes.
+- **Instant Rollback**: Revert Caddy upstreams back to the prior container in milliseconds with `aayi rollback`.
+
+---
+
+## Architecture
+
+```
+                                 [ CLI: aayi ]
+                               (Typer + Rich UI)
+                                       │
+                              [ Config: deploy.yml ]
+                               (Pydantic v2 Models)
+                                       │
+                      ┌────────────────┴────────────────┐
+                      ▼                                 ▼
+             [ Local Builder ]                 [ AsyncSSH Fleet ]
+           (docker buildx push)             (Parallel Multi-Server Pool)
+                                                        │
+                              ┌─────────────────────────┴─────────────────────────┐
+                              ▼                                                   ▼
+                       [ Web Server(s) ]                                   [ Worker Server(s) ]
+                     ┌───────────────────┐                               ┌────────────────────┐
+                     │ Caddy (Port 80/443│                               │ Worker Container   │
+                     │  Admin API :2019) │                               └────────────────────┘
+                     └─────────┬─────────┘
+                               │ (Dynamic Route)
+                     ┌─────────┴─────────┐
+                     │ App Container     │
+                     │ (Port: 8000/8001) │
+                     └───────────────────┘
+```
+
+---
+
+## Quickstart
+
+### 1. Installation
+
+**One-line standalone installer (Zero dependencies, no Python or pip needed):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/thlurte/aayi/main/install.sh | bash
+```
+
+**Or run instantly with uvx (no installation required):**
+```bash
+uvx aayi --help
+```
+
+**Or install via uv tool or pip:**
+```bash
+uv tool install aayi
+# or
+pip install aayi
+```
+
+### 2. Initialize Your Project
+
+Generate starter `config/deploy.yml` and an optimized multi-stage `Dockerfile`:
+```bash
+aayi init
+```
+
+### 3. Configure `config/deploy.yml`
+
+```yaml
+service: myapp
+image: your-docker-user/myapp
+
+servers:
+  web:
+    - 192.168.1.10
+  workers:
+    - 192.168.1.11
+  user: root
+
+registry:
+  server: docker.io
+  username: your-docker-user
+  password: ${DOCKER_REGISTRY_PASSWORD}
+
+proxy:
+  domain: app.example.com
+  app_port: 8000
+  healthcheck_path: /healthz
+  drain_timeout: 10
+  tls: true
+  email: admin@example.com
+
+env:
+  clear:
+    PORT: "8000"
+    ENVIRONMENT: production
+  secret:
+    - SECRET_KEY
+    - DATABASE_URL
+```
+
+### 4. Setup Target Servers
+
+Ensures official Docker CE and Caddy are running on all target hosts:
+```bash
+aayi setup
+```
+
+### 5. Deploy with Zero Downtime
+
+Builds the image with `docker buildx`, pushes to your registry, boots a new container, runs health checks, and smoothly switches Caddy upstream traffic:
+```bash
+aayi deploy
+```
+
+---
+
+## Command Reference
+
+| Command | Description |
+| :--- | :--- |
+| `aayi init` | Scaffolds `config/deploy.yml`, `Dockerfile`, and `.dockerignore`. |
+| `aayi ci init` | Generates `.github/workflows/deploy.yml` for automated GitHub Actions CI/CD. |
+| `aayi setup` | Installs Docker CE (if missing) and boots Caddy reverse proxy on all hosts. |
+| `aayi deploy` | Full zero-downtime deployment (build, push, boot, healthcheck, swap Caddy traffic). |
+| `aayi redeploy` | Redeploy an existing image tag on remote servers without rebuilding locally. |
+| `aayi rollback` | Atomically revert Caddy upstream to the previous healthy container. |
+| `aayi logs` | Real-time multi-host unified log streaming with colored host labels. |
+| `aayi exec <cmd>` | Execute an ad-hoc command or interactive shell inside running container. |
+| `aayi proxy status` | Inspect current live Caddy routing state and upstreams. |
+| `aayi proxy reload` | Force Caddy to route traffic to a specific container port. |
+| `aayi accessory boot <name>` | Start an accessory (e.g. Postgres, Redis) with persistent volumes. |
+| `aayi accessory stop <name>` | Stop an accessory container. |
+| `aayi accessory logs <name>` | View or follow logs for an accessory container. |
+
+---
+
+## Running Tests
+
+```bash
+uv run pytest -v
+```
+
+---
+
+## License
+
+MIT

aayi-0.1.1/README.md

@@ -0,0 +1,169 @@
+<p align="center">
+  <img src="assets/banner.jpeg" alt="Aayi - Modern Cloud Deployment Dev Tool" width="100%">
+</p>
+
+# Aayi
+
+Deploy Docker apps to any server with zero downtime and automatic HTTPS.
+
+Built with uv, AsyncSSH, Typer, Pydantic, and Caddy.
+
+---
+
+## Features
+
+- **Zero-Downtime Container Swaps**: Routes traffic between container revisions via Caddy's dynamic in-memory Admin API (`:2019`).
+- **Automatic HTTPS**: Full TLS certificate lifecycle via Let's Encrypt / ZeroSSL powered by Caddy.
+- **Docker Compose & Multi-Container**: Deploy multi-service applications directly from `docker-compose.yml` or multi-service `deploy.yml`.
+- **Public vs. Private Containers**:
+  - **Public**: Dedicated domain per container (e.g. `app.example.com` and `api.example.com`) with automatic Caddy TLS.
+  - **Private**: Background workers, databases, and microservices connected to internal `aayi-net` with no host port exposure.
+- **Concurrent SSH Execution**: Asynchronous, parallel multi-server operations powered by AsyncSSH.
+- **Type-Safe Declarative Config**: Strict validation of `config/deploy.yml` with friendly Pydantic v2 error messages.
+- **GitHub Actions Ready**: Out-of-the-box CI/CD generator (`aayi ci init`).
+- **No Ruby Required**: Built for developers who want Kamal's simplicity without installing Ruby or gem bundlers.
+- **Stateful Accessories**: Spin up and manage PostgreSQL, Redis, or MySQL containers with persistent Docker volumes.
+- **Instant Rollback**: Revert Caddy upstreams back to the prior container in milliseconds with `aayi rollback`.
+
+---
+
+## Architecture
+
+```
+                                 [ CLI: aayi ]
+                               (Typer + Rich UI)
+                                       │
+                              [ Config: deploy.yml ]
+                               (Pydantic v2 Models)
+                                       │
+                      ┌────────────────┴────────────────┐
+                      ▼                                 ▼
+             [ Local Builder ]                 [ AsyncSSH Fleet ]
+           (docker buildx push)             (Parallel Multi-Server Pool)
+                                                        │
+                              ┌─────────────────────────┴─────────────────────────┐
+                              ▼                                                   ▼
+                       [ Web Server(s) ]                                   [ Worker Server(s) ]
+                     ┌───────────────────┐                               ┌────────────────────┐
+                     │ Caddy (Port 80/443│                               │ Worker Container   │
+                     │  Admin API :2019) │                               └────────────────────┘
+                     └─────────┬─────────┘
+                               │ (Dynamic Route)
+                     ┌─────────┴─────────┐
+                     │ App Container     │
+                     │ (Port: 8000/8001) │
+                     └───────────────────┘
+```
+
+---
+
+## Quickstart
+
+### 1. Installation
+
+**One-line standalone installer (Zero dependencies, no Python or pip needed):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/thlurte/aayi/main/install.sh | bash
+```
+
+**Or run instantly with uvx (no installation required):**
+```bash
+uvx aayi --help
+```
+
+**Or install via uv tool or pip:**
+```bash
+uv tool install aayi
+# or
+pip install aayi
+```
+
+### 2. Initialize Your Project
+
+Generate starter `config/deploy.yml` and an optimized multi-stage `Dockerfile`:
+```bash
+aayi init
+```
+
+### 3. Configure `config/deploy.yml`
+
+```yaml
+service: myapp
+image: your-docker-user/myapp
+
+servers:
+  web:
+    - 192.168.1.10
+  workers:
+    - 192.168.1.11
+  user: root
+
+registry:
+  server: docker.io
+  username: your-docker-user
+  password: ${DOCKER_REGISTRY_PASSWORD}
+
+proxy:
+  domain: app.example.com
+  app_port: 8000
+  healthcheck_path: /healthz
+  drain_timeout: 10
+  tls: true
+  email: admin@example.com
+
+env:
+  clear:
+    PORT: "8000"
+    ENVIRONMENT: production
+  secret:
+    - SECRET_KEY
+    - DATABASE_URL
+```
+
+### 4. Setup Target Servers
+
+Ensures official Docker CE and Caddy are running on all target hosts:
+```bash
+aayi setup
+```
+
+### 5. Deploy with Zero Downtime
+
+Builds the image with `docker buildx`, pushes to your registry, boots a new container, runs health checks, and smoothly switches Caddy upstream traffic:
+```bash
+aayi deploy
+```
+
+---
+
+## Command Reference
+
+| Command | Description |
+| :--- | :--- |
+| `aayi init` | Scaffolds `config/deploy.yml`, `Dockerfile`, and `.dockerignore`. |
+| `aayi ci init` | Generates `.github/workflows/deploy.yml` for automated GitHub Actions CI/CD. |
+| `aayi setup` | Installs Docker CE (if missing) and boots Caddy reverse proxy on all hosts. |
+| `aayi deploy` | Full zero-downtime deployment (build, push, boot, healthcheck, swap Caddy traffic). |
+| `aayi redeploy` | Redeploy an existing image tag on remote servers without rebuilding locally. |
+| `aayi rollback` | Atomically revert Caddy upstream to the previous healthy container. |
+| `aayi logs` | Real-time multi-host unified log streaming with colored host labels. |
+| `aayi exec <cmd>` | Execute an ad-hoc command or interactive shell inside running container. |
+| `aayi proxy status` | Inspect current live Caddy routing state and upstreams. |
+| `aayi proxy reload` | Force Caddy to route traffic to a specific container port. |
+| `aayi accessory boot <name>` | Start an accessory (e.g. Postgres, Redis) with persistent volumes. |
+| `aayi accessory stop <name>` | Stop an accessory container. |
+| `aayi accessory logs <name>` | View or follow logs for an accessory container. |
+
+---
+
+## Running Tests
+
+```bash
+uv run pytest -v
+```
+
+---
+
+## License
+
+MIT

aayi-0.1.1/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "aayi"
+version = "0.1.1"
+description = "Deploy Docker apps to any server with zero downtime and automatic HTTPS"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "asyncssh>=2.14.0",
+    "httpx>=0.27.0",
+    "jinja2>=3.1.0",
+    "pydantic>=2.7.0",
+    "pyyaml>=6.0.1",
+    "rich>=13.7.0",
+    "typer>=0.12.0",
+]
+
+[[project.authors]]
+name = "Ahmed"
+email = "thlurte@gmail.com"
+
+[project.scripts]
+aayi = "aayi.cli.main:app"
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-asyncio>=1.4.1",
+]

aayi-0.1.1/pyproject.toml.orig

@@ -0,0 +1,31 @@
+[project]
+name = "aayi"
+version = "0.1.1"
+description = "Deploy Docker apps to any server with zero downtime and automatic HTTPS"
+readme = "README.md"
+authors = [
+    { name = "Ahmed", email = "thlurte@gmail.com" }
+]
+requires-python = ">=3.13"
+dependencies = [
+    "asyncssh>=2.14.0",
+    "httpx>=0.27.0",
+    "jinja2>=3.1.0",
+    "pydantic>=2.7.0",
+    "pyyaml>=6.0.1",
+    "rich>=13.7.0",
+    "typer>=0.12.0",
+]
+
+[project.scripts]
+aayi = "aayi.cli.main:app"
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-asyncio>=1.4.1",
+]

aayi-0.1.1/src/aayi/__init__.py

@@ -0,0 +1,3 @@
+"""Aayi: A Python-native container deployment tool with zero-downtime Caddy proxying."""
+
+__version__ = "0.1.1"

aayi-0.1.1/src/aayi/cli/ci.py

@@ -0,0 +1,76 @@
+"""GitHub Actions CI/CD workflow generator for Aayi."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from rich.console import Console
+
+console = Console()
+
+GITHUB_WORKFLOW_TEMPLATE = """name: Deploy Application
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy to Production
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ secrets.DOCKER_REGISTRY || 'docker.io' }}
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Set up SSH Private Key
+        uses: webfactory/ssh-agent@v0.9.0
+        with:
+          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+
+      - name: Add Known Hosts
+        run: |
+          mkdir -p ~/.ssh
+          # You can add: ssh-keyscan -H <YOUR_SERVER_IP> >> ~/.ssh/known_hosts
+
+      - name: Deploy with Aayi
+        env:
+          DOCKER_REGISTRY_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
+        run: |
+          uvx aayi deploy
+"""
+
+
+def init_github_actions(force: bool = False) -> Path:
+    """Generate .github/workflows/deploy.yml for automated deployments."""
+    workflows_dir = Path(".github") / "workflows"
+    workflows_dir.mkdir(parents=True, exist_ok=True)
+    workflow_file = workflows_dir / "deploy.yml"
+
+    if workflow_file.exists() and not force:
+        console.print(f"[yellow]Skipped {workflow_file} (already exists). Use --force to overwrite.[/yellow]")
+    else:
+        workflow_file.write_text(GITHUB_WORKFLOW_TEMPLATE, encoding="utf-8")
+        console.print(f"[green]✓ Created GitHub Actions workflow at {workflow_file}[/green]")
+
+    console.print("\n[bold cyan]GitHub Actions setup tips:[/bold cyan]")
+    console.print("  Configure these repository secrets in GitHub ([bold]Settings > Secrets and variables > Actions[/bold]):")
+    console.print("  • [yellow]SSH_PRIVATE_KEY[/yellow]: The private SSH key authorized on your target servers.")
+    console.print("  • [yellow]DOCKER_USERNAME[/yellow]: Your Docker Hub or container registry username.")
+    console.print("  • [yellow]DOCKER_PASSWORD[/yellow]: Your container registry password or access token.\n")
+    return workflow_file

aayi-0.1.1/src/aayi/cli/init.py

@@ -0,0 +1,130 @@
+"""Project initialization and scaffolding generator for Aayi."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from rich.console import Console
+
+console = Console()
+
+DEPLOY_YML_TEMPLATE = """# Aayi Deployment Configuration
+service: myapp
+image: your-docker-user/myapp
+
+# Server topology
+servers:
+  web:
+    - 192.168.1.10
+  workers:
+    - 192.168.1.11
+  user: root
+  ssh_port: 22
+
+# Docker container registry
+registry:
+  server: docker.io
+  username: your-docker-user
+  password: ${DOCKER_REGISTRY_PASSWORD}
+
+# Caddy Reverse Proxy & Zero-Downtime Traffic Routing
+proxy:
+  domain: app.example.com
+  app_port: 8000
+  healthcheck_path: /healthz
+  healthcheck_timeout: 30
+  drain_timeout: 10
+  tls: true
+  email: admin@example.com
+
+# Environment variables
+env:
+  clear:
+    PORT: "8000"
+    ENVIRONMENT: production
+  secret:
+    - SECRET_KEY_BASE
+    - DATABASE_URL
+
+# Attached stateful accessories (optional)
+accessories:
+  postgres:
+    image: postgres:16-alpine
+    host: 192.168.1.10
+    port: "5432:5432"
+    env:
+      POSTGRES_DB: myapp_production
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+  redis:
+    image: redis:7-alpine
+    host: 192.168.1.10
+    port: "6379:6379"
+    volumes:
+      - redis_data:/data
+"""
+
+DOCKERFILE_TEMPLATE = """# Multi-stage Dockerfile optimized with uv
+FROM python:3.13-slim AS builder
+
+WORKDIR /app
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
+
+COPY pyproject.toml uv.lock* ./
+RUN uv sync --frozen --no-dev --no-install-project
+
+COPY . .
+RUN uv sync --frozen --no-dev
+
+FROM python:3.13-slim
+
+WORKDIR /app
+COPY --from=builder /app/.venv /app/.venv
+COPY . .
+
+ENV PATH="/app/.venv/bin:$PATH"
+EXPOSE 8000
+
+CMD ["python", "-m", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
+"""
+
+DOCKERIGNORE_TEMPLATE = """.git
+.venv
+__pycache__
+*.pyc
+.env
+.pytest_cache
+dist
+build
+"""
+
+
+def init_project(force: bool = False) -> None:
+    """Scaffold initial deployment configuration and Dockerfile."""
+    config_dir = Path("config")
+    config_dir.mkdir(exist_ok=True)
+    deploy_yml = config_dir / "deploy.yml"
+
+    if deploy_yml.exists() and not force:
+        console.print(f"[yellow]Skipped {deploy_yml} (already exists). Use --force to overwrite.[/yellow]")
+    else:
+        deploy_yml.write_text(DEPLOY_YML_TEMPLATE, encoding="utf-8")
+        console.print(f"[green]✓ Created {deploy_yml}[/green]")
+
+    dockerfile = Path("Dockerfile")
+    if not dockerfile.exists() or force:
+        dockerfile.write_text(DOCKERFILE_TEMPLATE, encoding="utf-8")
+        console.print(f"[green]✓ Created {dockerfile}[/green]")
+
+    dockerignore = Path(".dockerignore")
+    if not dockerignore.exists() or force:
+        dockerignore.write_text(DOCKERIGNORE_TEMPLATE, encoding="utf-8")
+        console.print(f"[green]✓ Created {dockerignore}[/green]")
+
+    console.print("\n[bold green]Project initialized for Aayi![/bold green]")
+    console.print("Next steps:")
+    console.print("  1. Edit [cyan]config/deploy.yml[/cyan] with your server IP and domain.")
+    console.print("  2. Set up target servers: [bold]aayi setup[/bold]")
+    console.print("  3. Deploy your application: [bold]aayi deploy[/bold]\n")