Magento Commerce (Cloud) 2.2.1 Release Notes

We are pleased to present Magento Commerce Cloud 2.2.1. This release includes numerous functional fixes and enhancements.

We strongly recommend upgrading to Fastly v1.2.33 module for all Magento Commerce (Cloud) implementations that run on 2.0.x, 2.1.x, and 2.2.x. This version includes updates and additions to increase stability, performance, and resolve issues with caching shopping carts. This version of Fastly has specific updates for Magento.


Magento Commerce Cloud 2.2.1 includes multiple new features, enhancements and fixes. For full Magento Commerce Cloud highlights and updates, see the Magento Commerce 2.2.1 Release Notes.

Look for the following Magento Commerce Cloud highlights in this release:

  • 30-day free trials available for Starter and Pro projects. Starting October 23, 2017, we provide trials for Start and Pro projects. We auto provision your project and configure basic settings to get you started. You can access a new Onboarding Portal to get started with your project. For more information, see Subscriptions and plans.

  • Staging and Production environments in the UI for Pro projects. Starting October 23, 2017, all projects created using the free 30-day trial or provisioned for new accounts includes Staging and Production environments in the Project Web Interface.

  • Onboarding Portal for new accounts helps merchants new to Magento Commerce (Cloud) get started with their project. Quickly ramp up and get started with your project with our Onboarding Portal: assign a Technical Admin, preview your store, plan your local development environment, walk-through UAT tests, and prep for launching.

Looking for more information on these new features as well as many others? Check out Magento 2.2 Developer Documentation.

Security enhancements

Magento 2.2.1 includes multiple security enhancements. Although this release includes these enhancements, no confirmed attacks related to these issues have occurred to date. However, certain vulnerabilities can potentially be exploited to access customer information or take over administrator sessions, so we recommend that you upgrade your Magento software to the latest version as soon as possible.

In general, we’ve removed serialize/unserialize from most the code to improve protection against remote code execution attacks. We’ve enhanced protection of code where use of object serialization or unserialization was unavoidable. Additionally, we’ve increased our use of output escaping to protect against cross-site scripting (XSS) attacks.

Contact us for more information.

New Updates

  • Magento Commerce (Cloud) supports scopes and static content deployment strategies. We have added the –s parameter with a default setting of quick for the static content deployment strategy. You can use the environment variable SCD_STRATEGY to customize and use these strategies with your build and deploy actions. This variable supports the options standard quick, or compact. If you select compact, we override the STATIC_CONTENT_THREADS value with 1, which can slow deployment, especially in production environments.

  • When you create a new project, we automatically provision the project with the latest Magento Commerce (Cloud) code. The steps include cloning the latest code repository, adding an environment variable for ADMIN_EMAIL using the License Owner’s email, setting a default randomized Magento Admin password, and sending emails to the License Owner to access the project and reset the default Magento Admin password. For details, see Onboarding tasks.

  • We have created a new log file on environments to capture and compile build and deploy actions. The file is located in the app/var/log/cloud.log file inside the Magento root application directory.

Known issues

For all known Magento Commerce 2.2.1 issues, see Magento Commerce 2.2.1 Release Notes.

Fixed issues

  • We resolved an issue with the ElasticSearch option being added and saved to app/etc/env.php. When ElasticSearch is configured and activated in your environment, the setting properly saves in the env.php file. For example:

<?php //........ 'system' => array ( 'default' => array ( 'catalog' => array ( 'search' => array ( 'engine' => 'elasticsearch', 'elasticsearch_server_hostname' => 'elasticsearch.internal', 'elasticsearch_server_port' => '9200', ), ), ), ), //...

  • The ADMIN_EMAIL variable must be set for new and existing projects. We require that you configure the ADMIN_EMAIL environment variable for deployments, including new installations and upgrades. You can set this variable through the Project Web Interface. For instructions, see Change the Magento Admin URL, username, and password on master.

Community contributions

We are grateful to the wider Magento community and would like to acknowledge their contributions to this release. Check out the Magento Commerce 2.2.1 Release Notes for more information.

System requirements

For Magento Commerce Cloud requirements, see Technologies and Requirements.

The Magento Commerce technology stack is built on PHP and MySQL. For details, see Technology stack requirements and System Requirements.

Installation and upgrade instructions

If installing and working with Magento Commerce Cloud for the first time, we recommend First-time local environment setup.

To test and implement your Magento Commerce Cloud upgrade, see Upgrade Magento Commerce (Cloud). We include upgrade paths and additional instructions for upgrading from 2.0.x and 2.1.x.

You can directly upgrade to Magento Commerce Cloud 2.2 from the following versions:

  • 2.0.x versions: 2.0.14, 2.0.15, 2.0.16
  • 2.1.x versions: 2.1.7, 2.1.8, 2.1.9

We have heavily tested and verified upgrades to 2.2 from the latest three versions of 2.0.x and 2.1.x.

You can attempt to upgrade from any version directly to Magento Commerce Cloud 2.2. We cannot guarantee the results. For example, you should be able to upgrade from 2.0.10 or 2.1.4 directly to 2.2.

If you prefer a secured and verified upgrade path, you can upgrade to one of the verified and tested versions, then directly upgrade to 2.2. For example, you could upgrade from 2.0.10 to 2.0.14, then upgrade to 2.2.