Show Menu
主题×

AEM 项目结构

本文概述了Adobe Experience Manager马文项目为与AEMCloud Service兼容而必须做出的更改,即确保它们遵守可变内容和不可变内容的分割;建立必要的依赖关系以创建不冲突的确定性部署;它们被装在一个可展开的结构里。
AEM应用程序部署必须由单个AEM包组成。 此包应包含子包,子包包含应用程序运行所需的一切,包括代码、配置和任何支持的基线内容。
AEM 要求将​ 内容 ​和​ 代码 ​分离,这意味着单个内容包​ 不能 同时 ​部署到存储库的 /apps 和到运行时可写区域(例如, /content /conf /home /apps 以外的任何区域)。相反,应用程序必须将代码和内容分离到离散包中,以部署到 AEM 中。
本文档中概述的包结构与本地开发部署​ AEM 云服务部署兼容。
本文档中概述的配置由AEM Project Maven Archetype 21或更高版本提供

存储库的可变区与不可变区

/apps /libs 被视为 AEM 中的不可变区域,因为 AEM 启动后(例如,运行时),无法对其进行更改(创建、更新、删除)。 ​运行时对不可改变区域所做的任何更改尝试都将失败。
Everything else in the repository, /content , /conf , /var , /etc , /oak:index , /system , /tmp , etc. are all mutable areas, meaning they can be changed at runtime.
与先前版本的AEM一样, /libs 不应修改。 只有AEM产品代码可部署到 /libs

Oak索引

Oak索引( /oak:index )由AEM Cloud服务部署流程专门管理。 这是因为Cloud Manager必须等到部署任何新索引并完全重新插入后才能切换到新代码映像。
因此,尽管Oak索引在运行时是可变的,但必须将其部署为代码,以便在安装任何可变包之前安装它们。 因 /oak:index 此,配置是代码包的一部分,而不是下面所述的内 容包的一部分。
有关在AEM中作为Cloud Service建立索引的更多详细信息,请参 阅文档内容搜索和索引。

包类型

将用声明的包类型标记包。
  • 容器包不得具有 packageType 集。
  • 代码(不可变)包必须将其 packageType 设置为 application
  • 内容(可变)包必须将其 packageType 设置为 content
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

通过Adobe云管理器标记要部署的包

默认情况下,Adobe Cloud Manager 会收集由 Maven 内部版本生成的所有包,但是,由于容器 ( all ) 包是包含所有代码和内容包的单个部署对象,因此我们必须确保​ ​部署容器 ( all ) 包。要确保这一点,Maven 内部版本生成的其他包必须使用 <properties><cloudManagerTarget>none</cloudManageTarget></properties> 的 FileVault Content Package Maven Plug-In 配置进行标记。
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

回购初始化

回购初始化提供定义JCR结构的指令或脚本,这些结构从文件夹树等常见节点结构到用户、服务用户、组和ACL定义。
回购初始化的主要好处是它们具有执行其脚本定义的所有操作的隐式权限,并且在部署生命周期的早期被调用,确保执行时间代码时存在所有必需的JCR结构。
虽然回购初始化脚本本身作为 ui.apps 脚本存放在项目中,但它们可以而且应该用于定义以下可变结构:
  • 基线内容结构
    • Examples: /content/my-app , /content/dam/my-app , /conf/my-app/settings
  • 服务用户
  • 用户
  • ACL
回购初始化脚本存储 scripts 为OSGi工厂 RepositoryInitializer 配置的条目,因此,可以通过运行模式隐式定位,从而允许AEM作者和AEM发布服务的回购初始化脚本之间,甚至Env(开发、舞台和产品)之间的差异。
请注意,在定义“用户”和“组”时,只有组被视为应用程序的一部分,并且应在此处定义其功能的组成部分。 组织用户和组在运行时仍应在AEM中进行定义;例如,如果自定义工作流将工作分配给指定的组,则应在AEM应用程序中通过回购初始化定义该组,但是,如果该组只是组织,如“Wendy's Team”和“Sean's Team”,则这些工作流是在运行时在AEM中最佳定义和管理的。
回购初始 化脚本 必须在内联字 scripts 段中定义,且 references 配置将无法工作。
Apache Sling Repo Init文档提供回购初始化脚本 的完整词汇
有关完整 的代码片断 ,请参见下面的“回购初始化代码片断”部分。

存储库结构包

代码包需要配置FileVault Maven插件的配置,以引 <repositoryStructurePackage> 用强制结构依赖关系正确性的配置(以确保一个代码包不安装在另一个代码包上)。 您可以 为项目创建自己的存储库结构包
此操作​ 仅适用于 ​代码包,即任何标有 <packageType>application</packageType> 的包。
要了解如何为应用程序创建存储库结构包,请参 阅开发存储库结构包
请注意,内容包( <packageType>content</packageType> ) 不需要 此存储库结构包。
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

在容器包中嵌入子包

内容或代码包放在特殊的“侧车”文件夹中,可以定位在AEM author、AEM publish上,或同时安装在二者上(使用FileVault Maven插件的配 <embeddeds> 置)。 请注意, <subPackages> 不应使用该配置。
常见用例包括:
  • AEM作者用户和AEM发布用户之间的ACL/权限不同
  • 仅用于支持AEM作者活动的配置
  • 代码(如与后台系统集成),只需在AEM author上运行
要目标AEM作者、AEM发布,或者同时发布,该包将以下格式嵌入到 all 容器包中的一个特殊文件夹位置:
/apps/<app-name>-packages/(content|application)/install(.author|.publish)?
将此文件夹结构细分:
  • 第1级文件夹必 须为 /apps
  • 第2级文件夹表示文件夹名称 -packages 后缀为“后缀”的应用程序。 通常,只有一个2级文件夹所有子包都嵌入其中,但可以创建任意数量的2级文件夹以最好地表示应用程序的逻辑结构:
    • /apps/my-app-packages
    • /apps/my-other-app-packages
    • /apps/vendor-packages
    按照惯例,子包嵌入式文件夹的名称带有后缀 -packages 。这样可确保部署代码和内容包​ 不会 ​部署到任何子包 /apps/<app-name>/... 的目标文件夹,否则将会导致破坏性的循环安装行为。
  • 3级文件夹必须是 application content
    • 文件 application 夹包含代码包
    • 文件 content 夹包含内容包此文件夹名称必须与 其包含 的包的包类型相对应。
  • 第 4 级文件夹包含子包,且必须是以下包之一:
    • install ,以在 AEM 作者​ AEM 发布上安装
    • install.author ,以​ ​在 AEM 作者上安装
    • install.publish to only install on AEM publish注意 install.author , only install.publish and are supported目标. 不支持其 他运行模式
例如,包含AEM作者和发布特定包的部署可能如下所示:
  • all 容器包嵌入以下包,以创建单个部署伪像
    • ui.apps 嵌入到部 /apps/my-app-packages/application/install 署代码中,AEM author和AEM publish都可以
    • ui.apps.author 嵌入到部 /apps/my-app-packages/application/install.author 署代码中,仅允许AEM作者
    • ui.content 嵌入到 /apps/my-app-packages/content/install 部署内容和配置中,AEM author和AEM publish
    • ui.content.publish 嵌入到部 /apps/my-app-packages/content/install.publish 署内容和配置中,仅发布到AEM
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

容器包的过滤器定义

由于容器包中嵌入了代码和内容子包,嵌入的目标路径必须添加到容器项目的包中,以 filter.xml 确保在构建时将嵌入的包包含在容器包中。
只需为包 <filter root="/apps/<my-app>-packages"/> 含要部署的子包的任何2级文件夹添加条目。
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

嵌入第三方包

所有包必须通过Adobe的公 共Maven对象存储库或可访问的 、可引用的第三方Maven对象存储库可用。
如果第三方包位于 Adobe 的公共 Maven 对象存储库 ,则 Adobe Cloud Manager 无需进一步配置即可解析对象。
如果第三方包位于​ 公共的第三方 Maven 对象存储库 ,则必须在项目的 pom.xml 中注册此存储库,并将其嵌入到 以上所述 的以下方法中。如果第三方应用程序/连接器同时需要代码和内容包,则必须将每个第三方应用程序/连接器嵌入到容器 ( all ) 包中的正确位置。
添加Maven依赖项遵循标准Maven惯例,并嵌入第三方对象(代码和内容包) 如上所述
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。

来自包之间的 ui.apps 包依赖 ui.content 关系

为了确保正确安装软件包,建议建立软件包间依赖关系。
一般规则是包含可变内容( ui.content )的包,该可变内容()应取决于 ui.apps 支持可变内容的呈现和使用的不可变代码()。
此一般规则的一个显着例外是不可变的代码包(或 ui.apps 任何其他代码包)仅 包含 OSGi包。 如果是,则AEM包不应声明对它的依赖关系。 这是因为仅包含OSGi 包的不可 变代码包未在AEM Package Manager中注册,因此,任何依赖于它的AEM包都将具有不满足的依赖关系并且无法安装。
有关完整 的代码片断 ,请参见下面的POM XML代码片断部分。
内容包依赖关系的常见模式有:

简单部署包依赖关系

简单的案例将可变 ui.content 内容包设置为取决于不可变 ui.apps 的代码包。
  • all 没有依赖关系
    • ui.apps 没有依赖关系
    • ui.content 取决于 ui.apps

复杂部署包依赖关系

复杂的部署会根据简单情况进行扩展,并设置相应可变内容和不可变代码包之间的相关性。 根据需要,还可以在不可变的代码包之间建立依赖关系。
  • all 没有依赖关系
    • ui.apps.common 没有依赖关系
    • ui.apps.site-a 取决于 ui.apps.common
    • ui.content.site-a 取决于 ui.apps.site-a
    • ui.apps.site-b 取决于 ui.apps.common
    • ui.content.site-b 取决于 ui.apps.site-b

本地开发和部署

本文概述的项目结构和组织完全兼 容本地 开发AEM实例。

POM XML片段

以下是Maven配 pom.xml 置片段,可添加到Maven项目以符合上述建议。

包类型

作为子包部署的代码和内容包必须声明​ 应用程序 ​或​ 内容 ​包类型,具体取决于它们包含的内容。

容器包类型

容器 all/pom.xml 目不声明 a <packageType>

代码(不可变)包类型

代码包必须将其 packageType 设置为 application
在中, ui.apps/pom.xml 插件 <packageType>application</packageType> 声明的构建配置 filevault-package-maven-plugin 指令声明其包类型。
...
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      <configuration>
        <group>${project.groupId}</group>
        <name>${my-app.ui.apps}</name>
        <packageType>application</packageType>
        <accessControlHandling>merge</accessControlHandling>
        <properties>
          <cloudManagerTarget>none</cloudManagerTarget>
        </properties>
      </configuration>
    </plugin>
    ...

内容(可变)包类型

内容包必须将其 packageType 设置为 content
在中, ui.content/pom.xml 插件声 <packageType>content</packageType> 明的构建配置指 filevault-package-maven-plugin 令声明其包类型。
...
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      <configuration>
        <group>${project.groupId}</group>
        <name>${my-app.ui.content}</name>
        <packageType>content</packageType>
        <accessControlHandling>merge</accessControlHandling>
        <properties>
          <cloudManagerTarget>none</cloudManagerTarget>
        </properties>
      </configuration>
    </plugin>
    ...

标记Adobe云管理器部署的包

在生成包的每个项目中, ​容器 ( all ) 项目外,将 <cloudManagerTarget>none</cloudManagerTarget> 添加到 filevault-package-maven-plugin 插件声明的 <properties> 配置中,以确保 Adobe Cloud Manager ​部署这些它们。The container ( all ) package should be the singular package deployed via Cloud Manager, which in turn embeds all required code and content packages.
...
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      <configuration>
        ...
        <properties>
          <cloudManagerTarget>none</cloudManagerTarget>
        </properties>
      </configuration>
    </plugin>
    ...

回购初始化

包含回购初始化脚本的回购初始化脚本在OSGi工厂配 RepositoryInitializer 置中通过属性进行 scripts 定义。 请注意,由于这些脚本是在OSGi配置中定义的,因此运行模式可以使用通常的文件夹语义轻松 ../config.<runmode> 地确定其范围。
请注意,由于脚本通常是多行声明,因此在文件中定义脚本比 .config 基于XML的格式更容 sling:OsgiConfig 易。
/apps/my-app/config.author/org.apache.sling.jcr.repoinit.RepositoryInitializer-author.config
scripts=["
    create service user my-data-reader-service

    set ACL on /var/my-data
        allow jcr:read for my-data-reader-service
    end

    create path (sling:Folder) /conf/my-app/settings
"]

OSGi scripts 属性包含由Apache Sling的Repo Init语言定义的指令

存储库结构包

在声明 ui.apps/pom.xml 代码包( pom.xml )的任何其他代码包中,将 <packageType>application</packageType> 以下存储库结构包配置添加到FileVault Maven插件。 您可以 为项目创建自己的存储库结构包
...
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.jackrabbit</groupId>
      <artifactId>filevault-package-maven-plugin</artifactId>
      <extensions>true</extensions>
      <configuration>
        ...
        <repositoryStructurePackages>
          <repositoryStructurePackage>
              <groupId>${project.groupId}</groupId>
              <artifactId>ui.apps.structure</artifactId>
              <version>${project.version}</version>
          </repositoryStructurePackage>
        </repositoryStructurePackages>
      </configuration>
    </plugin>
    ...

在容器包中嵌入子包

在中, all/pom.xml 将以下指令 <embeddeds> 添加到插件 filevault-package-maven-plugin 声明中。 请记 ,不 <subPackages> 要使用配置,因为这将包括子包 /etc/packages 而不是 /apps/my-app-packages/<application|content>/install(.author|.publish)?
...
<plugin>
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
      ...
      <embeddeds>

          <!-- Include the application's ui.apps and ui.content packages -->
          <!-- Ensure the artifactIds are correct -->

          <!-- Code package that deploys to BOTH AEM Author and AEM Publish -->
          <embedded>
              <groupId>${project.groupId}</groupId>
              <artifactId>my-app.ui.apps</artifactId>
              <type>zip</type>
              <target>/apps/my-app-packages/application/install</target>
          </embedded>

          <!-- Code package that deploys ONLY to AEM Author -->
          <embedded>
              <groupId>${project.groupId}</groupId>
              <artifactId>my-app.ui.apps.author</artifactId>
              <type>zip</type>
              <target>/apps/my-app-packages/application/install.author</target>
          </embedded>

          <!-- Content package that deploys to BOTH AEM Author and AEM Publish -->
          <embedded>
              <groupId>${project.groupId}</groupId>
              <artifactId>my-app.ui.content</artifactId>
              <type>zip</type>
              <target>/apps/my-app-packages/content/install</target>
          </embedded>

          <!-- Content package that deploys ONLY to AEM Publish -->
          <embedded>
              <groupId>${project.groupId}</groupId>
              <artifactId>my-app.ui.content.publish-only</artifactId>
              <type>zip</type>
              <target>/apps/my-app-packages/content/install.publish</target>
          </embedded>

          <!-- Include any other extra packages such as AEM WCM Core Components -->
          <embedded>
              <groupId>com.adobe.cq</groupId>
              <!-- Not to be confused; WCM Core Components' Code package's artifact is named `.content` -->
              <artifactId>core.wcm.components.content</artifactId>
              <type>zip</type>
              <target>/apps/vendor-packages/application/install</target>
          </embedded>

          <embedded>
              <groupId>com.adobe.cq</groupId>
              <!-- Not to be confused; WCM Core Components' Content package's artifact is named `.conf` -->
              <artifactId>core.wcm.components.conf</artifactId>
              <type>zip</type>
              <target>/apps/vendor-packages/content/install</target>
          </embedded>
      <embeddeds>
  </configuration>
</plugin>
...

容器包的过滤器定义

all 项目的 filter.xml ( all/src/main/content/jcr_root/META-INF/vault/definition/filter.xml ) 中, 包括 ​要部署的任何包含子包的 -packages 文件夹:
<filter root="/apps/my-app-packages"/>

如果在嵌 /apps/*-packages 入目标中使用多个,则必须在此处枚举所有这些数据。

第三方Maven存储库

添加更多Maven存储库可能会延长大量构建时间,因为将检查其他Maven存储库是否具有相关性。
在反应堆项目中,添 pom.xml 加任何必要的第三方公共Maven存储库指令。 完整配 <repository> 置应可从第三方存储库提供程序中使用。
<repositories>
  ...
  <repository>
      <id>3rd-party-repository</id>
      <name>Public 3rd Party Repository</name>
      <url>https://repo.3rdparty.example.com/...</url>
      <releases>
          <enabled>true</enabled>
          <updatePolicy>never</updatePolicy>
      </releases>
      <snapshots>
          <enabled>false</enabled>
      </snapshots>
  </repository>
  ...
</repositories>

来自包之间的 ui.apps 包依赖 ui.content 关系

在中, ui.content/pom.xml 将以下指令 <dependencies> 添加到插件 filevault-package-maven-plugin 声明中。
...
<plugin>
  <groupId>org.apache.jackrabbit</groupId>
  <artifactId>filevault-package-maven-plugin</artifactId>
  <extensions>true</extensions>
  <configuration>
      ...
      <dependencies>
        <!-- Declare the content package dependency in the ui.content/pom.xml on the ui.apps project -->
        <dependency>
            <groupId${project.groupId}</groupId>
            <artifactId>my-app.ui.apps</artifactId>
            <version>${project.version}</version>
        </dependency>
      </dependencies>
    ...
  </configuration>
</plugin>
...

清除容器项目的目标文件夹

在中 all/pom.xml 添加 maven-clean-plugin 将在Maven构建之前清除目标目录的插件。
<plugins>
  ...
  <plugin>
    <artifactId>maven-clean-plugin</artifactId>
    <executions>
      <execution>
        <id>auto-clean</id>
        <!-- Run at the beginning of the build rather than the default, which is after the build is done -->
        <phase>initialize</phase>
        <goals>
          <goal>clean</goal>
        </goals>
      </execution>
    </executions>
  </plugin>
  ...
</plugins>