Introducing CQ Deploy: A Maven Plugin for Deploying CQ Projects

Introducing CQ Deploy: A Maven Plugin for Deploying CQ Projects


The Six Dimensions Labs team is proud to introduce CQ Deploy, an Apache Maven plugin for deploying Maven projects into Adobe CQ repositories.

The CQ Deploy plugin provides two goals, to help developers deploy Maven projects:

  • install-package
    This goal is used to install CQ Packages into CQ Repositories.
  • install-bundle
    This gloal is used to install bundles into CQ Repositories. This goal is different from the Maven Sling Plugin’s deploy method. Whereas the Maven Sling Plugin installs the bundle directly into the Felix application, the CQ Deploy plugin is used to upload the JAR into the CQ Application install folder and the path thereof can be configured.

As the plugin deploys both Packages and Bundles in a consistant method, developers can use the CQ Deploy plugin to create a single, unified package for deploying a CQ Application, including JSP and Bundle code.

As the CQ Deploy plugin has been deployed into the Maven Central Repository, it can be used on projects, by simply invoking the plugin in your POM. To use the CQ Deploy Plugin in a bundle project add the following into your POM file. This will install the primary JAR file generated in the build process into a CQ Server running on http://localhost:4502, using the username/password combination admin/admin under the path: /apps/bundles/install.

 <build>
    <plugins>
        <plugin>
            <groupId>com.sixdimensions.wcm.cq</groupId>
            <artifactId>cq-deploy-plugin</artifactId>
            <version>0.0.4</version>
            <executions>
                <execution>
                    <id>install-bundle</id>
                    <goals>
                        <goal>install-bundle</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                [...]
            </configuration>
        </plugin> 

To use the CQ Deploy Plugin in a package project add the following into your POM file. This will install the primary JAR file generated in the build process into the CQ Package Manager of a CQ Server running on http://localhost:4502, using the username/password combination admin/admin.

 <build>
    <plugins>
        <plugin>
            <groupId>com.sixdimensions.wcm.cq</groupId>
            <artifactId>cq-deploy-plugin</artifactId>
            <version>0.0.4</version>
            <executions>
                <execution>
                    <id>install-package</id>
                    <goals>
                        <goal>install-package</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                [...]
            </configuration>
        </plugin>

The CQ Deploy plugin offers a number of configuration values to change where the files are deployed and by what user. To read more about the CQ Deploy plugin, consult the CQ Deploy Plugin Documentation Site.

To report any issues, or ask any questions, please create an issue.


← CQ5 Upgrade Gotcha: Tag Localization SCR JavaDoc Tags Deprecated in CQ 5.5 →