Skip to main content

Deployments Overview

Urumi uses a three-environment deployment model to ensure your changes are tested before going live. This guide explains how deployments work and best practices for managing your store environments.

Environment Model​

Every Urumi store has three environments:

EnvironmentPurposeURL Pattern
DevelopmentActive development and codingyourstore-staging.myscalablesite.com
QAQuality assurance and testingyourstore-preview.myscalablesite.com
ProductionLive customer-facing siteyourstore-production.myscalablesite.com or your custom domain

Deployment Flow​

Changes flow through your environments in this order:

Production → Development → QA → Production
↑ │
└──────────────────────────────┘

Typical Workflow​

  1. Pull from Production - Start by copying production content to Development
  2. Make Changes - Edit files, add products, configure settings in Development
  3. Push to QA - Merge your changes to QA for testing
  4. Test in QA - Verify everything works as expected
  5. Push to Production - Deploy tested changes to your live site

Key Concepts​

Immutable Production Deployments​

Production deployments are immutable, meaning once deployed, the code cannot be changed directly. This ensures:

  • Consistent, reproducible deployments
  • Easy rollback if issues occur
  • Audit trail of all changes

Horizontal Scaling​

Production environments automatically scale horizontally with traffic. This means your store can:

  • Handle traffic spikes during sales and promotions
  • Scale to support millions of orders
  • Maintain fast response times under high load

You don't need to configure or manage scaling - it happens automatically based on demand.

Environment Isolation​

Each environment is completely isolated:

  • Separate databases
  • Independent file systems
  • Different URLs and configurations
Development Best Practice

Always make and test changes in Development before deploying. Never edit production directly.

Accessing the Deploy Tab​

  1. Navigate to your store from the dashboard
  2. Click the Deploy tab in the sidebar
  3. You'll see three environment cards showing current status

What Happens During Deployment​

When you trigger a deployment:

  1. Preparation - Files and database are prepared for transfer
  2. Synchronization - Changes are copied to the target environment
  3. Verification - Deployment is verified for completeness
  4. Completion - AI generates a summary of changes (for certain deployments)

Deployment times vary based on the amount of content being transferred, but typically complete within 1-5 minutes.