Slides for presentation "Ece-tools release 2002.1.0"

1. © 2020 Magento, Inc.
Ece-tools release 2002.1.0

2. © 2020 Magento, Inc.
Content
• Supported Versions
• Decomposition
• Magento Cloud Patches
• Magento Cloud Docker
• Scenario-based deployment
• Increase ability of cache warmup
• New variable in .magento.env.yaml
• Removed deprecated variables and configuration file
• CLI commands updates

3. © 2020 Magento, Inc.
Supported Versions

4. © 2020 Magento, Inc.
Version Limitations
• >= PHP 7.1
• >= Magento 2.1.16

5. © 2020 Magento, Inc.
Increased Versions Validation
• PHP 7.3
• RabbitMQ 3.8
• Validation EOL for services
https://devdocs.magento.com/cloud/project/project-conf-files_services.html#service-versions

6. © 2020 Magento, Inc.
Decomposition

7. © 2020 Magento, Inc.
Cloud Template Structure

8. © 2020 Magento, Inc.
Cloud Template Structure
2002.0.22

9. © 2020 Magento, Inc.
Cloud Template Structure
2002.1.0

10. © 2020 Magento, Inc.
Magento Cloud Patches
Releases 1.0.1 and 1.0.2

11. © 2020 Magento, Inc.
Magento Cloud Patches v1.0.1
- all open source hotfixes are bundled
- fixed cron deadlocks and improved cron locking
- updated patch for ES catalog pagination fix
- updated patches for Magento Page Builder

12. © 2020 Magento, Inc.
Magento Cloud Patches v1.0.1
- all open source hotfixes are bundled
- fixed cron deadlocks and improved cron locking
- updated patch for ES catalog pagination fix
- updated patches for Magento Page Builder
https://www.youtube.com/watch?v=5eQbCNUBuIk

13. © 2020 Magento, Inc.
Magento Cloud Patches v1.0.2
- fix PayPal Express Checkout issue with region
- fix disabling FPC during the deployment
- fixed issue with Async and Bulk APIs

14. © 2020 Magento, Inc.
Magento Cloud Docker
Release 1.0.0

15. © 2020 Magento, Inc.
Magento Cloud Docker
19 Mar 2020 - Release demo: Cloud Docker
https://spark.adobe.com/page/PbxJoujH7oRTc/

16. © 2020 Magento, Inc.
Scenario-based Deployment

17. © 2020 Magento, Inc.
Deployment scripts
Build
Deploy
Post-
Deploy
Deployment
vendor/bin/ece-tools build:generate
vendor/bin/ece-tools build:transfer
vendor/bin/ece-tools deploy
vendor/bin/ece-tools post-deploy

18. © 2020 Magento, Inc.
hooks:
build: |
php ./vendor/bin/ece-tools build:generate
php ./vendor/bin/ece-tools build:transfer
deploy: |
php ./vendor/bin/ece-tools deploy
post-deploy: |
php ./vendor/bin/ece-tools post-deploy
.magento.app.yaml
Deployment scripts

19. © 2020 Magento, Inc.
hooks:
build: |
php ./vendor/bin/ece-tools run scenario/build/generate.xml
php ./vendor/bin/ece-tools run scenario/build/transfer.xml
deploy: |
php ./vendor/bin/ece-tools run scenario/deploy.xml
post-deploy: |
php ./vendor/bin/ece-tools run scenario/post-deploy.xml
.magento.app.yaml
Deployment scripts

20. © 2020 Magento, Inc.
Structure

21. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

22. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

23. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

24. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

25. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

26. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

27. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

28. © 2020 Magento, Inc.
Scenario XML structure
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd" >
<step name="pre-build" type="MagentoCloudStepBuildPreBuild" priority="100"/>
<step name="set-production-mode" type="MagentoCloudStepSetProductionMode" priority="200"/>
<step name="validate-config" type="MagentoCloudStepValidateConfiguration" priority="300">
<arguments>
<argument name="logger" xsi:type="object">PsrLogLoggerInterface</argument>
<argument name="validators" xsi:type="array">
<item name="critical" xsi:type="array">
<item name="composer" xsi:type="object" priority="100">MagentoCloudConfigValidatorComposerFile</item>
<item name="stage-config" xsi:type="object" priority="200">MagentoCloudConfigValidatorStageConfig</item>
</item>
</argument>
</arguments>
</step>
</scenario>

29. © 2020 Magento, Inc.
Extend Scenario

30. © 2020 Magento, Inc.
hooks:
build: |
php ./vendor/bin/ece-tools run scenario/build/generate.xml
php ./vendor/bin/ece-tools run scenario/build/transfer.xml
deploy: |
php ./vendor/bin/ece-tools run scenario/deploy.xml ./vendor/MyCmp/MyModule/deploy.xml
post-deploy: |
php ./vendor/bin/ece-tools run scenario/post-deploy.xml
.magento.app.yaml
Extend Scenario

31. © 2020 Magento, Inc.
Remove Steps
<?xml version="1.0"?>
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd">
<step name="clean-cache" skip="true" />
<step name="warm-up" skip="true" />
</scenario>
vendor/MyCmp/MyModule/deploy.xml

32. © 2020 Magento, Inc.
Replace Steps
<?xml version="1.0"?>
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd">
<step name="clean-cache" type="VendorNameVendorModuleStepCleanCache" priority=”500" />
<step name="warm-up" skip="true" />
</scenario>
vendor/MyCmp/MyModule/deploy.xml

33. © 2020 Magento, Inc.
Change Step Priority
<?xml version="1.0"?>
<scenario xmlns:xsi=”…" xsi:noNamespaceSchemaLocation="urn:magento:ece-tools:config/scenario.xsd">
<step name="clean-cache" type="MagentoMagentoCloudStepPostDeployCleanCache" priority=”100" />
<step name="warm-up" skip="true" />
</scenario>
vendor/MyCmp/MyModule/deploy.xml

34. © 2020 Magento, Inc.
Example
https://devdocs.magento.com/cloud/deploy/scenario-based-deployment.html

35. © 2020 Magento, Inc.
Cache Warm Up

36. © 2020 Magento, Inc.
Cache Warm-up Improvements
https://www.youtube.com/watch?v=5eQbCNUBuIk

37. © 2020 Magento, Inc.
Directory Nesting Level
For Error Reports

38. © 2020 Magento, Inc.
New Variable In .magento.env.yaml
stage:
build:
ERROR_REPORT_DIR_NESTING_LEVEL: 5
.magento.env.yaml
MAGE_REPORT_DIR_NESTING_LEVEL=1 -> ./var/report/44/44ffb1087a44e61b018b3cdee72284d017f22e52755c24e5c85cbac1647ae7a7
MAGE_REPORT_DIR_NESTING_LEVEL=2 -> ./var/report/44/ff/44ffb1087a44e61b018b3cdee72284d017f22e52755c24e5c85cbac1647ae7a7
..
MAGE_REPORT_DIR_NESTING_LEVEL=32 -> ./var/report/44/ff/b1/08/7a/44/e6/1b/01/8b/3c/de/e7/22/84/d0/17/f2/2e/…
<?xml version="1.0"?>
<config>
<report>
<dir_nesting_level>5</dir_nesting_level>
</report>
</config>
.pub/errors/local.xml

39. © 2020 Magento, Inc.
Removed deprecated code

40. © 2020 Magento, Inc.
Removed Variables And File
SCD_EXCLUDE_THEMES
STATIC_CONTENT_THREADS
DO_DEPLOY_STATIC_CONTENT
STATIC_CONTENT_SYMLINK
build_options.ini
SCD_MATRIX
SCD_THREADS
SKIP_SCD
.magento.env.yaml

41. © 2020 Magento, Inc.
Changes In CLI Commands

42. © 2020 Magento, Inc.
CLI commands update
m2-ece-build
m2-ece-deploy
m2-ece-scd-dump
vendor/bin/ece-tools patch
vendor/bin/ece-tools docker:build
vendor/bin/ece-tools docker:config:convert
vendor/bin/ece-tools build
vendor/bin/ece-tools deploy
vendor/bin/ece-tools config:dump
vendor/bin/ece-patches apply
vendor/bin/ece-docker build:compose
vendor/bin/ece-docker imamge:generate:php

43. © 2020 Magento, Inc.
Cloud Tools Release Notes
https://devdocs.magento.com/cloud/release-notes/cloud-tools.html

44. © 2020 Magento, Inc.
Questions