1 <?xml version="1.0" encoding="UTF-8"?>
2 <!-- vi: set et smarttab sw=2 tabstop=2: -->
4 Copyright (c) 2015 The Linux Foundation and others. All rights reserved.
6 This program and the accompanying materials are made available under the
7 terms of the Eclipse Public License v1.0 which accompanies this distribution,
8 and is available at http://www.eclipse.org/legal/epl-v10.html
10 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
11 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
12 <modelVersion>4.0.0</modelVersion>
15 Note: This parent is not meant to be used by code artifacts. Please use
19 <groupId>org.opendaylight.odlparent</groupId>
20 <artifactId>odlparent-lite</artifactId>
21 <version>11.0.2-SNAPSHOT</version>
22 <packaging>pom</packaging>
23 <name>ODL :: odlparent :: ${project.artifactId}</name>
25 <!-- Sufficient Metadata for Maven Central Repository deployment
26 These are default, some of which project inheriting from this POM may override (but don't have to, typically)
27 see http://central.sonatype.org/pages/requirements.html
29 <url>${odl.site.url}/${project.groupId}/${stream}/${project.artifactId}/</url>
30 <description>${project.artifactId}</description>
34 <name>Eclipse Public License v1.0</name>
35 <url>https://www.eclipse.org/legal/epl-v10.html</url>
40 <name>OpenDaylight</name>
41 <url>https://www.opendaylight.org</url>
46 <url>https://jira.opendaylight.org/</url>
50 <system>Jenkins</system>
51 <url>https://jenkins.opendaylight.org/releng/</url>
55 <url>https://git.opendaylight.org/gerrit/</url>
61 <name>Please consult the PROJECT_INFO.yaml, README* and/or CONTRIBUTORS which should be included with this JAR</name>
62 <url>https://www.opendaylight.org</url>
63 <email>discuss@lists.opendaylight.org</email>
68 <nexusproxy>https://nexus.opendaylight.org/content</nexusproxy>
70 <!-- Variables required for Maven Site generation -->
71 <nexus.site.url>file:${user.dir}/target/staged-site</nexus.site.url>
72 <odl.site.url>https://nexus.opendaylight.org/content/sites/site/</odl.site.url>
73 <stream>latest</stream><!-- CI should pass in -Dstream={stream} -->
75 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
76 <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
78 <!-- Java Versions -->
79 <maven.compiler.release>17</maven.compiler.release>
81 <!-- This version property instead of just direct version in pluginManagement is the exception that confirms the rule
82 and is required so that downstream users of the archetype-packaging extension can use this (and get the same version
83 as the maven-archetype-plugin), because there is no "extensionManagement" in Maven -->
84 <maven.archetype.plugin.version>3.2.0</maven.archetype.plugin.version>
86 <!-- This property allows deployments to be skipped in child modules -->
87 <maven.deploy.skip>false</maven.deploy.skip>
89 <!-- This property allows installations to be skipped in child modules -->
90 <maven.install.skip>false</maven.install.skip>
92 <!-- Opt-out from running maven-checkstyle-plugin at all. Defaults to false,
93 set to 'true' in pom.xml of project which desires to completely skip
95 <odlparent.checkstyle.skip>false</odlparent.checkstyle.skip>
97 <!-- Opt-out from running modernizer-maven-plugin at all. Defaults to false,
98 set to 'true' in pom.xml of project which desires to completely skip
100 <odlparent.modernizer.skip>false</odlparent.modernizer.skip>
102 <!-- Opt-out from running spotbugs-maven-plugin at all. Defaults to false,
103 set to 'true' in pom.xml of project which desires to completely skip
105 <odlparent.spotbugs.skip>false</odlparent.spotbugs.skip>
107 <!-- Used in neutron, ovsdb -->
108 <jacoco.version>0.8.8</jacoco.version>
115 <artifactId>maven-antrun-plugin</artifactId>
116 <version>3.1.0</version>
119 <artifactId>maven-archetype-plugin</artifactId>
120 <version>${maven.archetype.plugin.version}</version>
123 <artifactId>maven-assembly-plugin</artifactId>
124 <version>3.4.2</version>
127 <artifactId>maven-clean-plugin</artifactId>
128 <version>3.2.0</version>
131 <artifactId>maven-compiler-plugin</artifactId>
132 <version>3.10.1</version>
135 <artifactId>maven-dependency-plugin</artifactId>
136 <version>3.3.0</version>
139 <artifactId>maven-deploy-plugin</artifactId>
140 <version>2.8.2</version>
142 <skip>${maven.deploy.skip}</skip>
146 <artifactId>maven-enforcer-plugin</artifactId>
147 <version>3.1.0</version>
150 <artifactId>maven-help-plugin</artifactId>
151 <version>3.2.0</version>
154 <artifactId>maven-install-plugin</artifactId>
155 <version>2.5.2</version>
157 <skip>${maven.install.skip}</skip>
161 <artifactId>maven-javadoc-plugin</artifactId>
162 <version>3.4.1</version>
163 <configuration combine.children="append">
164 <!-- Keep things quiet except for warnings/errors -->
168 <!-- https://bugs.openjdk.java.net/browse/JDK-8008632 -->
171 <placement>a</placement>
172 <head>API Note:</head>
175 <name>implSpec</name>
176 <placement>a</placement>
177 <head>Implementation Requirements:</head>
180 <name>implNote</name>
181 <placement>a</placement>
182 <head>Implementation Note:</head>
185 <!-- support for HelpMojo generated by the maven-plugin-plugin -->
188 <placement>t</placement>
192 <name>requiresProject</name>
193 <placement>t</placement>
194 <head>Requires project:</head>
197 <name>threadSafe</name>
198 <placement>t</placement>
199 <head>Threadsafe</head>
203 <placement>t</placement>
210 <id>attach-javadocs</id>
218 <artifactId>maven-jar-plugin</artifactId>
219 <version>3.2.2</version>
222 <artifactId>maven-project-info-reports-plugin</artifactId>
223 <version>3.4.1</version>
226 <artifactId>maven-release-plugin</artifactId>
227 <version>2.5.3</version>
230 <artifactId>maven-resources-plugin</artifactId>
231 <version>3.3.0</version>
234 <artifactId>maven-site-plugin</artifactId>
235 <version>3.12.1</version>
239 <imagesdir>./images</imagesdir>
240 <imagesoutdir>${project.build.directory}/site/images</imagesoutdir>
242 <source-highlighter>coderay</source-highlighter>
243 <coderay-css>style</coderay-css>
246 <require>asciidoctor-diagram</require>
252 <groupId>org.asciidoctor</groupId>
253 <artifactId>asciidoctor-maven-plugin</artifactId>
254 <version>2.2.2</version>
257 <groupId>org.asciidoctor</groupId>
258 <artifactId>asciidoctorj-diagram</artifactId>
259 <version>2.2.1</version>
264 <groupId>org.codehaus.mojo</groupId>
265 <artifactId>build-helper-maven-plugin</artifactId>
266 <version>3.3.0</version>
269 <groupId>org.codehaus.mojo</groupId>
270 <artifactId>exec-maven-plugin</artifactId>
271 <version>3.0.0</version>
274 <groupId>org.codehaus.mojo</groupId>
275 <artifactId>jdepend-maven-plugin</artifactId>
276 <version>2.0</version>
281 <goal>generate-no-fork</goal>
287 <groupId>org.codehaus.mojo</groupId>
288 <artifactId>versions-maven-plugin</artifactId>
289 <version>2.8.1</version>
291 <!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself.-->
293 <groupId>org.eclipse.m2e</groupId>
294 <artifactId>lifecycle-mapping</artifactId>
295 <version>1.0.0</version>
297 <lifecycleMappingMetadata>
300 <pluginExecutionFilter>
301 <groupId>io.github.git-commit-id</groupId>
302 <artifactId>git-commit-id-maven-plugin</artifactId>
303 <versionRange>[5,)</versionRange>
305 <goal>revision</goal>
307 </pluginExecutionFilter>
313 <pluginExecutionFilter>
314 <groupId>org.apache.maven.plugins</groupId>
315 <artifactId>maven-dependency-plugin</artifactId>
316 <versionRange>[2.10,)</versionRange>
320 </pluginExecutionFilter>
326 <pluginExecutionFilter>
327 <groupId>org.apache.maven.plugins</groupId>
328 <artifactId>maven-enforcer-plugin</artifactId>
329 <versionRange>[1.0.0,)</versionRange>
333 </pluginExecutionFilter>
339 </lifecycleMappingMetadata>
343 <groupId>org.jacoco</groupId>
344 <artifactId>jacoco-maven-plugin</artifactId>
345 <version>${jacoco.version}</version>
348 <groupId>org.cyclonedx</groupId>
349 <artifactId>cyclonedx-maven-plugin</artifactId>
350 <version>2.7.1</version>
357 <artifactId>maven-enforcer-plugin</artifactId>
360 <id>enforce-maven</id>
364 <version>${maven.compiler.release}</version>
365 </requireJavaVersion>
366 <requireMavenVersion>
367 <version>[3.8.3,)</version>
368 </requireMavenVersion>
371 <!-- https://nvd.nist.gov/vuln/detail/CVE-2021-44228: at least 2.15.0 -->
372 <!-- https://nvd.nist.gov/vuln/detail/CVE-2021-45046: at least 2.16.0 -->
373 <!-- https://nvd.nist.gov/vuln/detail/CVE-2021-45105: at least 2.17.0 -->
374 <!-- https://nvd.nist.gov/vuln/detail/CVE-2021-44832: at least 2.17.1 -->
375 <exclude>org.apache.logging.log4j:log4j-core:(,2.17.1)</exclude>
377 </bannedDependencies>
387 <groupId>io.github.git-commit-id</groupId>
388 <artifactId>git-commit-id-maven-plugin</artifactId>
389 <version>5.0.0</version>
392 <id>get-git-infos</id>
394 <goal>revision</goal>
399 <failOnNoGitDirectory>false</failOnNoGitDirectory>
400 <generateGitPropertiesFile>true</generateGitPropertiesFile>
401 <generateGitPropertiesFilename>${project.build.outputDirectory}/META-INF/git.properties</generateGitPropertiesFilename>
404 <always>true</always>
407 <!-- trust the working directory -->
408 <offline>true</offline>
412 <!-- SBOM integration -->
414 <groupId>org.cyclonedx</groupId>
415 <artifactId>cyclonedx-maven-plugin</artifactId>
419 Run after 'package' but before 'verify' phases.
421 FIXME: We really want to say 'run as last package-phase execution.
423 <phase>post-integration-test</phase>
428 <verbose>false</verbose>
441 <name>m2e.version</name>
445 <!-- Put the IDE's build output in a folder other than target, so that IDE builds don't interact with Maven builds -->
446 <directory>target-ide</directory>
450 <!-- http://blog2.vorburger.ch/2016/06/improve-maven-build-speed-with-q.html
451 q = http://memory-alpha.wikia.com/wiki/Q ;)
453 The Quick profile is used during incremental local development, when you want to "just get that JAR built",
454 which is very handy e.g. for fast hot reloading cycles in Karaf with bundle watch. It (intentionally!) skips
455 tests, quality checks etc. which are great and useful to run before finally submitting changes to Gerrit, and
456 which all must run on Gerrit, but which are overhead during ongoing fast iterative local development.
458 Note that the idea here is that your IDE will already have run quality checks such as e.g. Checkstyle
459 while you typed the code anyway. Similarly, if you wrote a test, you'll probably already have compiled and run it
460 from your IDE, so when you want the OSGi bundle JAR for Karaf, ASAP, you typically don't want all that to run again.
464 <skipTests>true</skipTests>
465 <!-- But NOT <maven.test.skip>true, as that's for compiling, not running, tests;
466 and that's usually quick. Skipping test compilation with -Pq with maven.test.skip would be
467 particularly confusing when used in a project with maven-jar-plugin <goal>test-jar, so don't.) -->
468 <skipIT>true</skipIT>
469 <skipITs>true</skipITs>
470 <skip.karaf.featureTest>true</skip.karaf.featureTest>
471 <jacoco.skip>true</jacoco.skip>
472 <maven.javadoc.skip>true</maven.javadoc.skip>
473 <maven.source.skip>true</maven.source.skip>
474 <odlparent.checkstyle.skip>true</odlparent.checkstyle.skip>
475 <odlparent.modernizer.skip>true</odlparent.modernizer.skip>
476 <odlparent.spotbugs.skip>true</odlparent.spotbugs.skip>
477 <maven.site.skip>true</maven.site.skip>
478 <invoker.skip>true</invoker.skip>
479 <enforcer.skip>true</enforcer.skip>
480 <duplicate-finder.skip>true</duplicate-finder.skip>
481 <mdsal.skip.verbose>true</mdsal.skip.verbose> <!-- Bug 6236 -->
482 <maven.gitcommitid.skip>true</maven.gitcommitid.skip>
483 <cyclonedx.skip>true</cyclonedx.skip>
487 <!-- http://blog2.vorburger.ch/2016/06/maven-install-into-additional.html
488 mvn [-o -Pq] install -DaddInstallRepositoryPath=.../karaf/system is used in development to directly
489 install artifacts such as bundles and KARs not just into the global shared ~/.m2/repository
490 but also into the isolated Maven repo of a Karaf distribution.
494 <name>addInstallRepositoryPath</name>
500 <artifactId>maven-install-plugin</artifactId>
503 <id>additional-install</id>
504 <phase>install</phase>
506 <goal>install-file</goal>
509 <file>${project.build.directory}/${project.build.finalName}.jar</file>
510 <localRepositoryPath>${addInstallRepositoryPath}</localRepositoryPath>
520 This profile is to ensure we only build javadocs reports
521 when we plan to deploy Maven site for our project.
523 It activates by checking for the existance of deploy-site.xml in the
524 user's current working directory. (Intent is that this is run from
525 the Project root directory)
530 <exists>${user.dir}/deploy-site.xml</exists>
537 <artifactId>maven-site-plugin</artifactId>
541 <id>generate-site</id>
542 <phase>install</phase>
545 <goal>attach-descriptor</goal>
556 <artifactId>maven-project-info-reports-plugin</artifactId>
558 <dependencyLocationsEnabled>false</dependencyLocationsEnabled>
563 <report>index</report>
569 <artifactId>maven-javadoc-plugin</artifactId>
573 <report>javadoc-no-fork</report>
574 <report>test-javadoc-no-fork</report>
583 <!-- Javadocs with links -->
584 <id>javadoc-links</id>
587 <exists>odl-javadoc-links-optin</exists>
593 <artifactId>maven-javadoc-plugin</artifactId>
594 <configuration combine.children="append">
596 <link>https://junit.org/junit4/javadoc/4.13.2/</link>
597 <link>http://hamcrest.org/JavaHamcrest/javadoc/2.2/</link>
598 <link>http://www.slf4j.org/apidocs/</link>
599 <link>https://xerces.apache.org/xerces2-j/javadocs/api/</link>
600 <link>https://google.github.io/guava/releases/31.1-jre/api/docs/</link>
601 <link>http://netty.io/4.1/api/</link>
602 <link>https://commons.apache.org/proper/commons-lang/javadocs/api-2.6/</link>
603 <link>https://commons.apache.org/proper/commons-lang/javadocs/api-release/</link>
612 <!-- On JDK9-and-later specify html4 javadoc, if requested-->
613 <id>jdk9-javadoc</id>
617 <exists>odl-javadoc-html5-optout</exists>
623 <artifactId>maven-javadoc-plugin</artifactId>
624 <configuration combine.children="append">
626 <additionalOption>-html4</additionalOption>
635 <!-- Disable plugins which are not useful for sonar -->
643 <checkstyle.skip>true</checkstyle.skip>
644 <duplicate-finder.skip>true</duplicate-finder.skip>
645 <skip.karaf.featureTest>true</skip.karaf.featureTest>
646 <maven.javadoc.skip>true</maven.javadoc.skip>
647 <maven.source.skip>true</maven.source.skip>
652 <distributionManagement>
654 <id>opendaylight-release</id>
655 <url>${nexusproxy}/repositories/opendaylight.release/</url>
658 <id>opendaylight-snapshot</id>
659 <url>${nexusproxy}/repositories/opendaylight.snapshot/</url>
660 </snapshotRepository>
662 <id>opendaylight-site</id>
663 <url>${nexus.site.url}/${project.artifactId}/</url>
665 </distributionManagement>