Generate DAR

DAR - Deployit Archive - is a new Maven packaging type. It allows to generate a Deployit deployment package with all the necessary deployables (artifacts and middleware resources) that compose the application and to gather all into an archive (.dar) that could be installed in a Maven repository and later imported into Deployit. The following example describes a package that contains:

  • a war file - petclinic - defined as a maven dependency (groupId and artifactId, the version is defined in the dependency node)
  • a war file - petclinic-backend - defined as a maven dependency
  • an archive file - the driver jdbc mysql - defined as a maven dependency
  • a configuration folder - configuration - defined using a location, the location/ is relative to the dar project.
  • a package using a classifier
  • a weblogic datasource - petclinicDS - with common static properties (jndiNames, driverName ...) and environment based properties (username, password}
  • a sample type that has all possible property kinds.
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    
        <modelVersion>4.0.0</modelVersion>
        <groupId>com.xebialabs.deployit</groupId>
        <artifactId>maven-deployit-plugin-dar-format</artifactId>
    
        <packaging>dar</packaging> <!-- DAR packaging -->
    
        <version>1.0</version>
        <name>Dar Format</name>
        <url>http://www.xebialabs.com</url>
        <build>
            <plugins>
                <plugin>
                    <groupId>com.xebialabs.deployit</groupId>
                    <artifactId>maven-deployit-plugin</artifactId>
                    <version>3.9.3</version>
    
                    <extensions>true</extensions> <!-- tells maven the plugin contains extensions -->
    
                    <configuration>
                        <deploymentPackageProperties>
                            <!-- Enter any deployment package level properties as <property>value</property> -->
                            <orchestrator>default</orchestrator>
                            <satisfiesReleaseNotes>true</satisfiesReleaseNotes>
                        </deploymentPackageProperties>
                        <deployables>
    
                            <jee.War name="petclinic" groupId="com.xebialabs.deployit.demo.petclinic-war" artifactId="PetClinic"/>
    
                            <jee.War name="petclinic-backend" groupId="com.xebialabs.deployit.demo.petclinic-war" artifactId="PetClinic-Backend"/>
    
                            <file.Archive name="mysql-backend" groupId="mysql" artifactId="mysql-connector-java"/>
    
                            <file.Folder name="configurationFolder" location="config"/>
    
                            <file.Archive name="configuration" groupId="org.some.group" artifactId="your-artifact" classifier="txt"/>
    
                            <wls.DataSourceSpec name="petclinicDS">
                                <jndiNames>jndi/toto</jndiNames>
                                <driverName>com.mysql.jdbc.Driver</driverName>
                                <url>jdbc:mysql://localhost/petclinic</url>
                                <username>{{DB_USERNAME}}</username>
                                <password>{{DB_PASSWORD}}</password>
                            </wls.DataSourceSpec>
    
                            <sample.AllPossibleKindsSpec name="sampleWithAllPossibleKinds">
                                <someProp>propValue</someProp>
                                <someBoolean>true</someBoolean>
                                <myList>
                                    <value>val1</value>
                                    <value>val2</value>
                                </myList>
                                <myMap>
                                    <entry key="key">value</entry>
                                    <entry key="foo">bar</entry>
                                </myMap>
                                <myEmbedded>
                                    <sample.EmbeddedCi name="MyEmbeddedCi">
                                        <someProp>propValue</someProp>
                                    </sample.EmbeddedCi>
                                </myEmbedded>
                                <myCiRef ref="petClinicDs"/>
                                <myCiRefs>
                                    <ci ref="petclinic-backend"/>
                                    <ci ref="mysql-backend"/>
                                </myCiRefs>
                            </sample.AllPossibleKindsSpec>
    
                       </deployables>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    
        <dependencies>
            <dependency>
                <groupId>com.xebialabs.deployit.demo.petclinic-war</groupId>
                <artifactId>PetClinic</artifactId>
                <version>1.0</version>
                <type>war</type>
                <scope>provided</scope>
            </dependency>
            <dependency>
                <groupId>com.xebialabs.deployit.demo.petclinic-war</groupId>
                <artifactId>PetClinic-Backend</artifactId>
                <version>1.0-SNAPSHOT</version>
                <type>war</type>
                <scope>provided</scope>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>5.1.13</version>
                <scope>provided</scope>
            </dependency>
            <dependency>
                <groupId>org.some.group</groupId>
                <artifactId>your-artifact</artifactId>
                <version>1.0</version>
                <classifier>txt</classifier>      <!-- you can use a classifier here -->
                <scope>provided</scope>
            </dependency>
        </dependencies>
    
    
    </project>

Example using legacy format of deployables.

This format is still supported by the plugin.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    ...
    <build>
        <plugins>
            <plugin>
                <groupId>com.xebialabs.deployit</groupId>
                <artifactId>maven-deployit-plugin</artifactId>
                <version>3.9.3</version>

                <extensions>true</extensions> <!-- tells maven the plugin contains extensions -->

                <configuration>
                    <deployables>

                        <deployable>
                            <name>petclinic</name>
                            <type>jee.War</type>
                            <groupId>com.xebialabs.deployit.demo.petclinic-war</groupId>
                            <artifactId>PetClinic</artifactId>
                        </deployable>

                        <deployable>
                            <name>configuration</name>
                            <type>file.Folder</type>
                            <location>config</location>
                        </deployable>

                        <deployable>
                            <name>aPackage2</name>
                            <groupId>org.some.group</groupId>
                            <artifactId>your-artifact</artifactId>
                            <classifier>package2</classifier>          <!-- you can use a classifier here -->
                            <type>file.Archive</type>
                        </deployable>

                        <deployable>
                            <name>petclinicDS</name>
                            <type>wls.DataSourceSpec</type>
                            <jndiNames>jndi/toto</jndiNames>
                            <driverName>com.mysql.jdbc.Driver</driverName>
                            <url>jdbc:mysql://localhost/petclinic</url>
                            <username>{{DB_USERNAME}}</username>
                            <password>{{DB_PASSWORD}}</password>
                        </deployable>

                        <deployable>
                            <name>sample.AllPossibleKinds</name>
                            <type>sample.AllPossibleKindsSpec</type>
                            <someProp>propValue</someProp>
                            <someBoolean>true</someBoolean>
                            <myList>
                                <list>
                                    <value>value1</value>
                                    <value>value2</value>
                                </list>
                            </myList>
                            <myMap>
                                <map>
                                    <key>value</key>
                                    <foo>bar</foo>
                                </map>
                            </myMap>
                        </deployable>

                    </deployables>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <dependencies>
        ...
    </dependencies>


</project>