Asantiya – Bringing Ease to Your Deployment Workflow
In Pashto, Asantiya (Pashto: اسانتیا) speaks of ease and purpose, the very heart of this tool.
- اسان (asan) = easy
- اسانتیا (asantiya) = ease, comfort, convenience
By naming the CLI Asantiya, we signal its purpose: to make deploying your applications as easy and convenient as possible, whether you’re targeting a local environment or a remote server.
What is Asantiya?
Asantiya is a Python-based command-line tool that simplifies application deployment through Docker containerization. It bridges the gap between development and production by providing a consistent, automated deployment experience across different environments.
Core Philosophy
Asantiya follows the principle of configuration over complexity. Instead of writing complex deployment scripts or managing intricate Docker commands, you define your deployment requirements in a simple YAML configuration file, and Asantiya handles the rest.
Key Features
🚀 Automated Deployment
- One-command deployment for both local and remote environments
- Automatic Docker image building and container orchestration
- Zero-downtime deployments with health checks
🐳 Docker-Powered
- Leverages Docker for consistent environments
- Multi-architecture support (amd64, arm64)
- Remote and local builder support
- Custom Dockerfile support
🔧 Configuration-Driven
- Simple YAML-based configuration
- Environment variable management
- Flexible port mapping and networking
- Customizable build options
📦 Accessory Management
- Easy integration of databases, caches, and other services
- Pre-configured templates for common services (MySQL, PostgreSQL, Redis)
- Automatic service discovery and networking
🌐 Multi-Environment Support
- Local development environments
- Remote production servers
- Staging and testing environments
- SSH-based remote deployment
Use Cases
Development Teams
- Local Development: Quickly spin up complete application stacks with databases and dependencies
- Testing: Deploy to staging environments for integration testing
- CI/CD Integration: Automate deployment pipelines
DevOps Engineers
- Infrastructure as Code: Version-controlled deployment configurations
- Environment Consistency: Ensure identical setups across dev, staging, and production
- Service Orchestration: Manage complex multi-service applications
Solo Developers
- Rapid Prototyping: Deploy applications without complex setup
- Portfolio Projects: Easy deployment for personal projects
- Learning: Understand deployment concepts without overwhelming complexity
How It Works
- Configure: Define your application and services in
deploy.yaml - Build: Asantiya builds Docker images based on your configuration
- Deploy: Containers are deployed to your target environment
- Manage: Use CLI commands to start, stop, and monitor your services
Why Choose Asantiya?
Simplicity
- No complex orchestration tools to learn
- Intuitive CLI commands
- Clear, readable configuration format
Flexibility
- Works with any Docker-compatible application
- Supports custom build processes
- Extensible accessory system
Reliability
- Docker-based isolation ensures consistency
- Built-in health checks and monitoring
- Rollback capabilities for failed deployments
Performance
- Optimized Docker builds
- Efficient container management
- Minimal resource overhead
Getting Started
Ready to experience the ease of Asantiya? Let’s get you started:
- Install Asantiya - Get the tool set up on your system
- Quick Start Guide - Deploy your first application
- Configuration Reference - Learn about all available options
- Examples - See real-world use cases and configurations
Community and Support
- GitHub: shahid-0/asantiya - Source code, issues, and contributions
- Documentation: This site - Comprehensive guides and references
- Community: Join discussions and get help from other users
Ready to make deployment easy? Let’s dive into installation and get Asantiya running on your system.