Environments
Welcome to the Environments documentation for our Odoo PaaS platform. This page provides a comprehensive guide on managing your deployments, whether you are using Odoo Community or Enterprise editions.
Understanding Environments
Before diving into configurations, it is crucial to understand how PaaS.sh structures your workflow. At its core, an Environment is simply an isolated phase of your project's lifecycle. Think of it as a dedicated, containerized workspace where a specific version of your codebase and database lives independently from the rest of your system.
Typically, a standard, robust project workflow is divided into three main environments:
- Production (
prod): The live, stable version of your application. This is your critical business environment where your actual users and real-world data reside. - Staging (
staging): A pre-production replica used for final QA testing, client approvals, and verifying that new features or migrations will not break the live system upon release. - Development (
dev): Your active sandbox for building, testing, and experimenting. This is where your developers write and deploy new code safely.
Infinite Branching
The true power of this structure lies in its flexibility. While you have these three distinct phases, each environment can contain as many branches as you need.
For instance, your dev environment might simultaneously host a feature-new-payment-gateway branch, a bugfix-tax-calculation branch, and an experimental-ui branch. Each branch operates in complete isolation, allowing your team to work concurrently without stepping on each other's toes.
Overview
By leveraging our robust infrastructure, you can easily deploy, monitor, and scale these isolated environments to match your team's velocity.
Key Capabilities
- Seamless Integration: Native support for GitHub, GitLab, and Bitbucket to automatically pull your branches.
- Automated Processes: Zero-downtime deployments and automated daily backups (for Prod and Staging).
- Scalability: Scale your workers and memory resources instantly per environment.
Configuration Steps
Follow these instructions to properly set up and manage your Environments:
- Navigate to Dashboard: Log in to PaaS.sh and select your target project.
- Access Environments: Click on the Environments tab from your project sidebar to view your active phases and branches.
- Apply Changes: Select the specific branch environment you wish to modify, adjust the required variables (like Odoo configuration parameters), and click Deploy to trigger a rebuild.
Advanced Options
For advanced users, you can utilize the Web IDE, the built-in browser Shell, or database SQL Insights to fine-tune your instance performance directly from the dashboard without needing external SSH tools.
Troubleshooting
If you encounter issues while configuring or deploying an Environment, check the following:
- Build History: Review the deployment history and click on a failed build to see exactly which step caused the error.
- Live Logs: Check the live deployment and Odoo logs within the environment's advanced dashboard to catch syntax errors or missing dependencies.
- DNS & Routing: Verify your DNS and routing rules if an environment is running but unreachable.
- Support: If you are still stuck, contact our support team and provide your unique Project ID and the specific branch name.