ZenDeploy (ZD)

A Terminal User Interface (TUI) application for managing and executing AWS deployments through YAML configurations. ZenDeploy provides a streamlined way to manage deployment scripts, configure AWS environments, and execute deployments with real-time monitoring and comprehensive audit logging.

Screenshots

ZenDeploy Welcome Screen	Main interface for deployment file selection
Deployment review and configuration screen	Deployment execution and progress monitoring

Quick Start

1. Install dependencies:

git clone repo

2. Create a virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate  # On Linux/macOS
   .venv\Scripts\activate     # On Windows

3. Install dependencies:

   pip install -r requirements.txy

4. Run App:

   python src/main.py

Required Dependencies

• textual: Modern TUI framework for Python
• PyYAML: YAML file parsing and manipulation
• GitPython: Git repository operations
• pyfiglet: ASCII art generation
• rich: Rich text formatting
• typing: Type hints support

Project Structure:

zendeploy/ ├── src/ │ ├── init.py │ ├── main.py # Application entry point and TUI initialization │ ├── deployment_manager.py # Handles deployment step management │ ├── deployment_executor.py# Executes deployment steps │ ├── review_screen.py # Review and execution screen │ └── audit_logger.py # Audit logging functionality ├── logs/ # Directory for audit and deployment logs ├── requirements.txt # Project dependencies ├── theme.yml # Application theming configuration └── README.md # This file

For detailed setup instructions, see the Installation Guide.

Documentation

• Installation Guide - Setup and requirements
• Configuration Guide - YAML configuration and theming
• Testing Guide - Testing and development