Documentation

Platform Overview

CloudWady is an Odoo-based application deployment and management system that provides:

• Multi-tenant Architecture: Separate namespaces for different organizations
• Role-based Access Control: Platform and project-level user management
• Automated Deployments: Ansible-powered deployment automation
• Project Management: Organize applications into projects with team collaboration
• Queue Job Management: Background task processing and monitoring

User Management

CloudWady supports two types of users:

Platform Users

• Platform Administrator: Full system access and user management
• Platform Maintainer: Can manage projects and deployments
• Platform Developer: Can deploy applications and manage configurations
• Platform Viewer: Read-only access to the dashboard

Project Users

• Project Administrator: Full project access and team management
• Project Maintainer: Can deploy and manage project applications
• Project Developer: Can deploy applications within the project
• Project Viewer: Dashboard-only access to project information

Project Setup

Projects are the main organizational unit for applications. Each project can contain multiple applications and has its own team.

Project Types

• Odoo Projects: For deploying Odoo applications
• Generic Projects: For other application types

Creating Projects

To create a new project:

1. Navigate to the Projects menu
2. Click "Create Project"
3. Fill in project details (name, type, description)
4. Configure initial settings and team members
5. Save and start adding applications

Adding Applications

Applications are the deployable units within projects. Each application represents a service or component:

• Configure Git repository connections
• Set deployment parameters and environment variables
• Define build and deployment scripts
• Configure domains and SSL certificates

Team Management

Project administrators can manage team access:

• Add existing platform users to projects
• Create new project-specific users
• Assign appropriate access levels
• Configure dashboard-only restrictions
• Send password reset emails

Deployment Workflow

CloudWady's deployment process is automated using Ansible:

1. Trigger deployment from the dashboard
2. System generates Ansible playbooks automatically
3. Deployment jobs are queued and processed
4. Real-time status updates in the interface
5. Logs and results are captured for review

Ansible Automation

All CloudWady deployments are powered by Ansible automation:

• Dynamic playbook generation based on application configuration
• Docker container deployment and management
• Service discovery and load balancing
• Health checks and rollback capabilities

Monitoring Jobs

CloudWady's queue job management provides visibility into background tasks:

• View running, pending, and completed jobs
• Monitor deployment progress in real-time
• Access detailed logs and error information
• Retry failed jobs when necessary

Platform Administration

Platform administrators have access to:

• Global user management across all projects
• System configuration and settings
• Resource monitoring and optimization
• Security and compliance management

Access Levels

Understanding the permission hierarchy:

Troubleshooting

Common Issues

• Permission Denied: Check user access level and project assignments
• Deployment Failures: Review Ansible logs in the job queue
• User Creation Issues: Ensure proper project_id formatting and validation
• Login Problems: Verify user is active and has appropriate group memberships