All of your code is contained in the Magento Commerce (Cloud) Starter project. The project is your Magento store code, extensions, and integrations in a Master Git branch. Each project supports up to 4 total environments including three active Integration environments and a Production environment using the
master Git branch.
All environments are in PaaS (Platform-as-a-Service) containers. These containers are deployed inside highly restricted containers on a grid of servers. 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. We strongly recommend creating a Staging environment and branch as one of the Integration environments.
The following architecture information uses an architecture including Production, Staging, and Integration environments.
Production with a master branch
The Production environment is your live store(s) and site(s). The environment includes your
master Git branch, a web server, database, and configured services to fully test your site.
The Production environment runs your public-facing Magento single and multisite storefronts. This system is read-only, requiring deployment across the architecture from Integration to Staging and finally Production.
We highly recommend fully testing in your Staging environment and branch prior to pushing to Production.
Staging branch and environment
We recommend creating a branch called
master. Use this Staging environment and Git branch as your pre-production environment to test code, modules and extensions, payment gateways, shipping, product data, and much more. This environment will receive all services to match Production including Fastly, New Relic, Blackfire, and search.
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.
Developers use the Integration environment to develop, deploy, and test:
- Magento application code
- Custom code
You have up to two active environments on a grid for two 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.
You can have an unlimited number of inactive Git branches to store code. To access, view, and test inactive branches, you must activate them.
The Integration environment does not support all services. For example, the Fastly CDN and New Relic is not accessible in an Integration environment.
The process for developing in Integration requires the following process:
- Branch and develop off of
- Develop all work on your local workspace in these branches
- Push code to Git to build and deploy on an Integration environment for testing
- As work is completed, merge to
Production and Staging technology stack
The Production and Staging environments include the following technologies. You can modify and configure these technologies through the .magento.app.yaml file.
- Fastly for http caching and CDN
- Nginx web server speaking to PHP-FPM, one instance with multiple workers
- Redis server
- Elasticsearch for searching for Magento Commerce (Cloud) 2.1 and later
- Solr search is supported for Magento Commerce (Cloud) 2.0
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
- 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.
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.33 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.
Backup and disaster recovery
You can create a snapshot of your database and file system using the Project Web Interface or the CLI. The snapshot includes your deployed code, installed software and services, and data. See Snapshots and backup management.
Prepare for development
To branch and develop your Magento store:
- Set up your local environment
- Clone the
masterbranch from the Project to your local
- Create a
- Create branches for development from
- Push code to Git that builds and deploys to an environment for testing