部署到 AEM as a Cloud Service

简介

与AEM内部部署和Managed Services解决方案相比，AEM的代码开发基础与Cloud Service相似。开发人员编写代码并在本地测试它，然后将它作为Cloud Service环境推送到远程AEM。 Cloud Manager是Managed Services的可选内容投放工具，是必需的。现在，这是将代码作为Cloud Service环境部署到AEM的唯一机制。

AEM版本的更新始终是推送自定义代码的单独部署事件。换种方式来看，自定义代码版本应针对生产上的AEM版本进行测试，因为它将部署在顶部。 AEM版本更新之后发生的，它将频繁发生并自动应用。它们旨在向后兼容已部署的客户代码。

本文档的其余部分将介绍开发人员如何调整其做法，以便他们与AEM作为Cloud Service的版本更新和客户更新一起工作。

注意

建议现有代码库的客户完成AEM文档中描述的存储库重构练习。

客户版本

针对正确的AEM版本进行编码

对于以前的AEM解决方案，最新的AEM版本更改频繁（大约每年每季度提供服务包），客户将自行将生产实例更新到最新的快速启动，引用API Jar。但是，AEM作为Cloud Service应用程序会更频繁地自动更新到AEM的最新版本，因此内部发行版的自定义代码应根据最新的AEM版本构建。

与现有非云AEM版本一样，将支持基于特定快速入门的本地脱机开发，并且在大多数情况下，它将是调试的首选工具。

注意

应用程序在本地机器上的行为与Adobe云之间存在微妙的操作差异。在本地开发过程中，这些架构差异必须得到尊重，并可能导致在云基础架构上部署时出现不同的行为。由于这些差异，在生产中推出新的自定义代码之前，必须对开发和阶段环境执行详尽的测试。

为了为内部版本开发自定义代码，应下载并安装AEM作为Cloud ServiceSDK的相关版本。有关将AEM用作Cloud Service调度程序工具的其他信息，请参阅此页。

以下视频概括介绍了如何将代码部署到AEM作为Cloud Service:

注意

建议现有代码库的客户完成AEM文档中描述的存储库重构练习。

通过云管理器和包管理器部署内容包

通过云管理器进行部署

客户通过Cloud Manager将自定义代码部署到云环境。应当注意的是，云管理器将本地装配的内容包转换为符合Sling特征模型的伪像，即在云环境中运行AEM时，如何将描述为Cloud Service应用程序。因此，在查看云环境上的包管理器中的包时，名称将包括“cp2fm”，转换的包将删除所有元数据。它们不能与之交互，这意味着它们不能下载、复制或打开。有关转换器的详细文档可在此](https://github.com/apache/sling-org-apache-sling-feature-cpconverter)找到。[

作为Cloud Service应用程序为AEM编写的内容包必须在不可变内容和可变内容之间有清晰的分隔，云管理器将通过失败生成来强制执行该内容，并输出如下消息：

Generated content-package <PACKAGE_ID> located in file <PATH> is of MIXED type

本节的其余部分将描述不可改变和可变包的组成和含义。

不可变的内容包

必须在不可变存储库中保留的所有内容和代码都必须签入git并通过云管理器进行部署。换言之，与当前AEM解决方案不同，代码从不直接部署到正在运行的AEM实例。这可确保在任何云环境中为某个给定版本运行的代码是相同的，从而消除在生产过程中无意发生代码变化的风险。例如，OSGI配置应提交到源代码控制，而不是在运行时通过AEM Web控制台的配置管理器进行管理。

由于交换机启用了蓝绿部署模式导致的应用程序更改，因此它们不能依赖于可变存储库中的更改，服务用户、其ACL、节点类型和索引定义更改除外。

对于具有现有代码库的客户，必须完成AEM文档中所述的存储库重组练习，以确保将以前位于/etc下的内容移动到正确的位置。

OSGI配置

如上所述，OSGI配置应提交到源代码控制，而不是通过Web控制台。这样做的技术包括：

使用AEM web控制台的配置管理器对开发人员的本地AEM环境进行必要的更改，然后将结果导出到本地文件系统上的AEM项目
在本地文件系统的AEM项目中手动创建OSGI配置，属性名称引用AEM控制台的配置管理器。

有关OSGi配置的更多信息，请参阅将AEM的OSGi配置为Cloud Service。

可变内容

在某些情况下，在源代码控件中准备内容更改可能很有用，这样，只要更新环境,Cloud Manager就可以部署它。例如，为某些根文件夹结构植入种子或在可编辑模板中排列更改，以在那些由应用程序部署更新的组件中启用策略，这可能是合理的。

有两种策略可描述Cloud Manager将部署到可变存储库、可变内容包和重新指向语句的内容。

可变内容包

诸如文件夹路径层次结构、服务用户和访问控制(ACL)等内容通常会提交到基于主原型的AEM项目中。技术包括从AEM导出或直接编写为XML。在构建和部署过程中，Cloud Manager会将生成的可变内容包打包。可变内容在管道的部署阶段以3个不同的时间安装：

在新版应用程序启动之前：

索引定义（添加、修改、删除）

在新版本的应用程序启动过程中但切换之前：

服务用户（添加）
服务用户ACL（添加）
节点类型（添加）

切换到新版应用程序后：

可通过jackrabbitvault定义的所有其他内容。例如：
- 文件夹（添加、修改、删除）
- 可编辑的模板（添加、修改、删除）
- 上下文感知配置（/conf下的任何内容）（添加、修改、删除）
- 脚本(软件包可以在软件包安装过程的各个阶段触发安装挂钩

通过将包嵌入install.author或install.publish文件夹（位于/apps下），可以将可变内容安装限制为创作或发布。有关建议的项目重组的详细信息，请参阅AEM documentation。

注意

内容包将部署到所有环境类型(dev、stage、prod)。无法将部署限制到特定环境。此限制旨在确保自动执行的测试运行选项。特定于环境的内容需要通过包管理器手动安装。

此外，在应用可变内容包更改后，没有回滚这些更改的机制。如果客户检测到问题，他们可以选择在下一个代码版本中修复它，或者作为最后手段，将整个系统恢复到部署前的某个时间点。

必须验证包含的任何第三方包是否与AEM兼容，否则，其包含将导致部署失败。

如上所述，现有代码库的客户应符合AEM文档中所述的存储库重组操作。

重新指向

对于以下情况，最好在OSGI工厂配置中采用手工编码显式内容创建repoinit语句的方法：

创建／删除／禁用服务用户
创建／删除用户组
创建／删除用户
添加ACL

注意

定义ACL要求节点结构已存在。因此，可能需要在创建路径语句之前执行。
添加路径（例如根文件夹结构）
添加CND（nodetype定义）

由于以下优点，对于这些支持的内容修改用例，重点说明更可取：

重新指向在启动时创建资源，这样逻辑就可以认为这些资源的存在是理所当然的。在可变内容包方法中，资源在启动后创建，因此依赖它们的应用程序代码可能会失败。
重新指示是相对安全的指令集，因为您显式控制要执行的操作。此外，除了允许删除用户、服务用户和组的一些与安全相关的情况外，唯一支持的操作是附加的。相反，删除可变内容包方法中的某些内容是明确的；在您定义过滤器时，过滤器所涵盖的任何内容都将被删除。但是，应当小心，因为对于任何内容，新内容的出现都可能会改变应用程序的行为。
重新定点可执行快速和原子操作。相比之下，可变内容包可以高度依赖于过滤器所覆盖的结构的性能。即使更新单个节点，也可能会创建大树的快照。
可以在运行时验证本地开发环境上的重新指向语句，因为注册OSGi配置时将执行它们。
重新指向语句是原子的且是显式的，如果状态已匹配，则将跳过。

当Cloud Manager部署应用程序时，它将执行这些语句，而与安装任何内容包无关。

要创建重新指向语句，请按照以下过程操作：

在项目的配置文件夹中添加工厂PID org.apache.sling.jcr.repoinit.RepositoryInitializer的OSGi配置。为配置使用描述性名称，如org.apache.sling.jcr.repoinit.RepositoryInitializer~initstructure。
将重新指向语句添加到配置的脚本属性。 Sling文档中介绍了语法和选项。请注意，应在父级文件夹的子文件夹之前显式创建父级文件夹。例如，在/content/myfolder之前、在/content/myfolder/mysubfolder之前显式创建/content。对于在低级结构上设置的ACL，建议将其设置在更高级别上，并使用rep:glob限制。例如(allow jcr:read on /apps restriction(rep:glob,/msm/wcm/rolloutconfigs))。
在运行时在本地开发环境上验证。

警告

对于为/apps或/libs下的节点定义的ACL，重新指向执行将开始到空的存储库。软件包在重新指向后安装，因此语句不能依赖包中定义的任何内容，但必须定义先决条件，如下面的父结构。

小贴士

对于ACL，创建深层结构可能比较繁琐，因此更合理地在更高的级别定义ACL并通过rep:glob限制来限制它应该在何处操作。

有关重新指向的详细信息，请参阅Sling文档

可变内容包的包管理器“一次性”

在某些情况下，内容包应作为“一次性”安装。例如，将特定内容从生产导入到暂存，以调试生产问题。对于这些情形，包管理器可以在AEM中用作Cloud Service环境。

由于包管理器是运行时的概念，因此无法将内容或代码安装到不可变的存储库中，因此这些内容包只能由可变内容（主要是/content或/conf）组成。如果内容包包含混合的内容（可变内容和不可变内容），则只会安装可变内容。

通过云管理器安装的任何内容包（可变和不可变）都将在AEM包管理器的用户界面中以冻结状态显示。无法重新安装、重新构建或甚至下载这些包，并将以"cp2fm"后缀列出，表明其安装由Cloud Manager管理。

包括第三方包

客户通常会包含来自第三方来源(如Adobe的翻译合作伙伴)的预建包。建议将这些包托管在远程存储库中，并在pom.xml中引用它们。这适用于公用资料库，也适用于具有密码保护的专用资料库，如受密码保护的主资料库中所述。

如果无法将包存储在远程存储库中，客户可以将包放置在基于Maven的本地文件系统存储库中，该存储库作为项目的一部分提交到SCM，并由依赖它的任何对象引用。存储库将在以下项目提示中声明：

<repository>
    <id>project.local</id>
    <name>project</name>
    <url>file:${maven.multiModuleProjectDirectory}/repository</url>
</repository>

任何包含的第三方包都必须作为本文所述的Cloud Service服务编码和打包指南遵守AEM，否则，其包含将导致部署失败。

以下Maven POM XML代码片断展示了如何通过 filevault-package-maven-plugin Maven插件配置将第三方包嵌入项目的“容器”包中(通常名为 'all')。

...
<plugin>
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
      ...
      <subPackages>
           
          <!-- Include the application's ui.apps and ui.content packages -->
          ...
 
          <!-- Include any other extra packages such as AEM WCM Core Components -->
          <!-- Set the version for all dependencies, including 3rd party packages, in the project's Reactor POM -->
          <subPackage>
              <groupId>com.adobe.cq</groupId>
              <artifactId>core.wcm.components.all</artifactId>
              <filter>true</filter>
          </subPackage>
 
 
          <subPackage>
              <groupId>com.3rdparty.groupId</groupId>
              <artifactId>core.3rdparty.artifactId</artifactId>
              <filter>true</filter>
          </subPackage>
      <subPackages>
  </configuration>
</plugin>
...

滚动部署的工作方式

与AEM更新一样，客户版本使用滚动部署策略进行部署，以在适当的情况下消除创作群集停机时间。事件的一般顺序如下所述，其中Blue是客户代码的旧版本，Green是新版本。蓝色和绿色运行的AEM代码版本相同。

蓝色版本处于活动状态，并且已构建并提供绿色版本候选
如果存在任何新的或更新的索引定义，则处理相应的索引。请注意，蓝色部署将始终使用旧索引，而绿色部署将始终使用新索引。
Blue仍在服务时，Green开始工作
蓝色正在运行，并且正在通过运行状况检查检查检查绿色是否准备就绪
已准备就绪的绿色节点接受通信并替换已关闭的蓝色节点
随着时间的推移，蓝色节点被绿色节点替换，直到仅绿色节点保留，从而完成部署
已部署任何新的或修改的可变内容

索引

新的或修改的索引将导致在新的（绿色）版本开始通信之前执行额外的索引或重新索引步骤。有关AEM中作为Cloud Service的索引管理的详细信息，请参阅本文](/docs/experience-manager-cloud-service/operations/indexing.html?lang=zh-Hans)。 [您可以在Cloud Manager构建页面上检查索引编制作业的状态，并在新版本可以接收流量时收到通知。

注意

滚动部署所需的时间会因索引的大小而异，因为生成新索引之前，绿色版本无法接受通信。

目前，AEM作为Cloud Service无法使用索引管理工具，如ACS Commons Ensure Oak Index工具。

复制

发布机制与AEM复制Java API向后兼容。

要使用云就绪的AEM快速启动开发和测试复制，需要将经典复制功能与作者／发布设置结合使用。如果已为云删除AEM作者上的UI入口点，则用户将转至http://localhost:4502/etc/replication进行配置。

滚动部署的向后兼容代码

如上所述，AEM作为Cloud Service的滚动部署战略意味着旧版本和新版本可能同时运行。因此，请谨慎处理代码更改，这些更改与仍在运行的旧AEM版本不向后兼容。

此外，应测试旧版本与回滚事件中新版本应用的任何新的可变内容结构的兼容性，因为不会删除可变内容。

服务用户和ACL更改

更改访问内容或代码所需的服务用户或ACL可能会导致AEM旧版本中出现错误，从而导致使用过时的服务用户访问该内容或代码。要解决此行为，建议在至少2个版本之间进行更改，第一个版本在后续版本中清除之前充当桥梁。

索引更改

如果对索引进行了更改，则Blue版本应继续使用其索引，直到其终止，而Green版本应使用其自己修改过的索引集。开发人员应遵循本文](/docs/experience-manager-cloud-service/operations/indexing.html?lang=zh-Hans)中描述的索引管理技术。[

回滚的保守编码

如果在部署后报告或检测到故障，则可能需要回滚到蓝色版本。最好确保蓝色代码与由绿色版本创建的任何新结构兼容，因为新结构（任何可变内容内容）不会回滚。如果旧代码不兼容，则需要在后续客户版本中应用修复。

运行模式

在现有的AEM解决方案中，客户可以选择以任意运行模式运行实例，并将OSGI配置或将OSGI捆绑包安装到这些特定实例。通常定义的运行模式包括service（作者和发布）和环境(dev、stage、prod)。

而AEM作为Cloud Service，则对于哪些运行模式可用以及如何将OSGI捆绑包和OSGI配置映射到这些模式更加自信：

OSGI配置运行模式必须引用dev、stage、prod for the环境或author, publish for the service。支持<service>.<environment_type>的组合，但必须按此特定顺序使用它们（例如author.dev或publish.prod）。 OSGI令牌应直接从代码引用，而不是使用getRunModes方法，该方法在运行时将不再包括environment_type。有关详细信息，请参阅将AEM的OSGi配置为Cloud Service。
OSGI捆绑包运行模式仅限于服务（作者、发布）。每运行模式OSGI包应安装在install/author或install/publish下的内容包中。

与现有的AEM解决方案一样，无法使用运行模式仅为特定环境或服务安装内容。如果希望为未在舞台或生产上的数据或HTML植入开发环境，可使用包管理器。

支持的运行模式配置有：