Repository Modernizer repo-modernizer
Repository Modernizer is a utility developed to restructure existing project packages by separating content and code into discrete packages to be compatible with the project structure defined for ÃÛ¶¹ÊÓƵ Experience Manager as a Cloud Service.
Introduction introduction
ÃÛ¶¹ÊÓƵ Experience Manager as a Cloud Service brings many new features and possibilities into your AEM Projects. However, there are some changes required to ÃÛ¶¹ÊÓƵ Experience Manager Maven projects to be compatible with AEM Cloud Service. At a high-level, AEM requires a separation of content and code into discrete subpackages to respect the split between mutable and immutable content. See AEM Project Structure for more details about the new AEM project structure for Cloud Service.
The Repository Modernizer creates a compatible AEM Cloud Service project structure by creating the following deployment structure:
-
ui.appspackage deploys to/appsand contains all the code -
ui.contentpackage deploys to runtime-writable areas (for example,/content,/conf,/home, or anything not/apps) and contains all the content and configuration. -
allpackage is a container package that contains the subpackagesui.appsandui.content.
pom.xml/filter.xml files. See for more details.Using the Repository Modernizer using-repo-modernizer
-
By way of ÃÛ¶¹ÊÓƵ I/O CLI : ÃÛ¶¹ÊÓƵ recommends using the Repository Modernizer via
aio-cli-plugin-aem-cloud-service-migration(AEM as a Cloud Service code refactoring plugin for the ÃÛ¶¹ÊÓƵ I/O CLI).See so you can learn how to install and use the plugin.
-
As a standalone utility : The Repository Modernizer can also be executed as a standalone utility.
See so you can learn how to use this tool.
note note NOTE The Repository Modernizer is developed using NodeJS. It is recommended to have NodeJS 10.0+ installed.