Pro architecture

Magento Commerce (Cloud) Pro projects provide three complete environments to develop, test, and launch your store. These environments are read-only, accepting deployed code changes from Git branches pushed from your local workspace. You can use any development and branching methodology you like.

All of your code is contained in the Magento Commerce (Cloud) project. Each project supports up to eight active Integration environments with an associated active Git branch in PAAS (Platform as a Service) containers, including master. These containers are deployed inside highly restricted containers on a grid of servers.

Pro also provides a dedicated Infrastructure-as-a-Service (IaaS) for Production and Staging. You deploy the Integration master Git branch to these dedicated environments. Production includes a three-node high availability infrastructure to ensure your site is always available. When the project is deployed into Production, monitoring and failover happen automatically behind the scenes.

For existing Pro projects, you need to have your Project Web Interface updated to manage Staging and Production through the interface. For more information adding this management to existing Pro projects, see Add Staging and Production to Pro projects UI.

If you do not request this update, you must use CLI commands or tickets to modify settings, variables, routes, and more for Pro plan Staging and Production environments.

High-level view of Pro architecture flow

Integration environment

Developers use the Integration environment to develop, deploy, and test the Magento application, custom code, extensions, and services. This environment is a Platform-as-a-Servie (PaaS) providing up to eight active environments on a grid for eight active Git branches. Each Integration environment matches the name of the branch and includes a web server, database, and configured services to fully test your site.

The Integration environments run in a Linux container (LXC) on a grid of servers as a PAAS (Platform as a Service). You can have up to eight active Git branches with an associated environments to development and test code. You can have an unlimited number of inactive Git branches to store code. To access, view, and test inactive branches, you must activate them.

This environment does not support all services. For example, Fastly is not accessible in Integration.

The process for developing in Integration requires the following process:

  • Clone the master branch from the Project to your local
  • Branch and develop in a new Git branch on your local workspace
  • Push code to Git that builds and deploys to an Integration environment for testing

Additional sections in this guide provide instructions and walk-throughs for setting up your local workspace, working with Git branches, and deploying code.

Staging environment

The Staging environment provides a near-Production environment to test your site. This environment includes all services used in Production including Fastly, New Relic, Blackfire, and search. All code in Staging is read-only, requiring deploys of Git repositories. This environment shares the same dedicated server with Production.

Additional sections in this guide provide instructions and walk-throughs for final code deployments and testing production level interactions in a safe Staging environment. For best performance and feature testing, replicate your Production database into Staging.

We walk you through deploying to Staging and testing your store(s) requirements and processes.

We highly recommend fully testing every merchant and customer interaction in Staging prior to pushing to Production.

Production environment

The Production environment runs your public-facing Magento single and multisite storefronts. This environment include triple-redundant High Availability nodes for continuous access and failover protection for your customers. This system is read-only, requiring deployment across the architecture from Integration to Staging and finally Production.

We walk you through deploying to Production and Go Live requirements and processes.

We highly recommend fully testing in Staging prior to pushing to Production.

Advantage of redundant hardware

Rather than running a traditional active-passive master or master-slave setup, Magento Commerce (Cloud) runs a triple-redundant multimaster where all three instances accept reads and writes. This architecture offers zero downtime when scaling, and also provides guaranteed transactional integrity.

Because of our unique triple-redundant hardware, we can provide you with a set of three gateway servers. Most external services enable you to whitelist multiple IPs, so having more than one fixed IP isn’t usually a problem.

These three gateways map to the three servers in your Production cluster and retain permanent addresses. It is fully redundant and highly available at every level:

  • DNS
  • Content Delivery Network (CDN)
  • Elastic load balancer (ELB)
  • Three-server cluster comprising all Magento services, including the database and web server.

Backup and disaster recovery

We automatically back up your production system every six hours. Each production system cluster is designed to withstand the loss of an entire server and all of the services running on it.

The coordinating agent that monitors your production system:

  • Detects failures at the service level (for example, MySQL)
  • Fully automaties and coordinates recovery where an automated recovery is possible

Production technology stack

The Production environment has three VMs behind an Elastic Load Balancer managed by an HAProxy per VM. Each VM includes the following technologies:

  • Fastly for http caching and CDN
  • Nginx web server speaking to PHP-FPM, one instance with multiple workers
  • GlusterFS file server for managing all static file deployments and syncs with four directories mounted: var, pub/media, pub/static, and app/etc
  • Redis server, one per VM with only one active and the other two as replicas
  • Elasticsearch for searching for Magento Commerce (Cloud) 2.1 and later
  • Solr search is supported for Magento Commerce (Cloud) 2.0
  • Galera database cluster with a MariaDB MySQL database per node with an auto-increment setting of 3 for unique IDs across every database

The following figure shows the technology used in the Production environment:

Production technology stack

Magento Commerce seamlessly scales from the smallest six CPU cluster with 11.25GB of RAM to the largest 96 CPU cluster with 180GB of RAM. Our triple-redundant architecture means that upscaling can be conducted swiftly and without downtime. When upscaling, we rotate each of the three instances to upgrade without downtime of your site.

In addition, extra web servers can be added to an existing cluster should the constriction be at the PHP level rather than the database level. This provides horizontal scaling to complement the vertical scaling provided by extra CPUs on the database level.

Differences in environments

The following table details the differences:

Integration Staging Production
Managed by a UI Yes No No
Uses .yaml files for configuration Yes Requires support ticket for deployment settings Requires support ticket for deployment settings
Multiple environments Yes No (master only) No (master only)
Runs on dedicated hardware No Yes Yes


Magento Commerce (Cloud) currently supports the following services: PHP, MySQL (MariaDB), Solr (Magento 2.0.x), Elasticsearch (Magento 2.1.x and later), Redis, and RabbitMQ.

Each service runs in its own secure container. containers are managed together in the project. Some services are built-in, such as the following:

  • HTTP router (handling incoming requests, but also caching and redirects)
  • PHP application server
  • Git
  • Secure Shell (SSH)

You can even have multiple applications running in the same project. Building a microservice oriented architecture with Magento Commerce is as easy as managing a monolithic application.

Software versions

Magento Commerce (Cloud) uses:

  • Operating system: Debian GNU/Linux 8 (jessie)
  • Web server: nginx 1.8

This software is not upgradable but versions for the following software is configurable:

For Staging and Production, you will use Fastly for CDN and caching. We recommend installing Fastly module 1.2.27 or later. For details, see Fastly in Cloud.

For detailed information on supported versions and extensions, see the following information. These files allow you to configure software versions you want to use in your implementation.

Prepare for development

To branch and develop your Magento store:

  • Set up your local environment
  • Clone the master branch from the Project to your local
  • Branch and develop in a new Git branch on your local workspace
  • Push code to Git that builds and deploys to an environment for testing

Additional sections in this guide provide instructions and walk-throughs for setting up your local workspace, working with Git branches, and deploying code.

We walk you through the entire process from deployment to going live requirements and processes.