Skip specified attached artifacts from deploy

[xleon90]

Suppose you have differents artifacts attached on a single Maven module. For example:

• a shaded jar created using the "maven-shade-plugin" with "shadedArtifactAttached" attribute set to true
• a generic jar attached using the "build-helper-maven-plugin" plugin

I've worked on my fork project in order to allow to specify artifacts to skip deploy for.
Here the usage example:

 <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-deploy-plugin</artifactId>
       <version>3.0.3-SNAPSHOT</version>
       <configuration>
         <skipAttachedArtifacts>
           <artifact>
             <groupId>${project.groupId}</groupId>
             <artifactId>${project.artifactId}</artifactId>
             <version>${project.version}</version>
             <packaging>jar</packaging>
             <classifier>shaded</classifier>
           </artifact>
           <artifact>
             <groupId>${project.groupId}</groupId>
             <artifactId>${project.artifactId}</artifactId>
             <version>${project.version}</version>
             <packaging>zip</packaging>
           </artifact>
         </skipAttachedArtifacts>
       </configuration>
</plugin>

Implementing feature I took care of:

• write documentation
• create two dedicated asserted junit tests on DeployMojoTest.
• respect code styles according to constraints provided
• test build on my use case scenario

As result you will have the following output during execution:

[INFO]
[INFO] --- maven-deploy-plugin:3.0.3-SNAPSHOT:deploy (default-deploy) @ cc-manager4j ---
[INFO] Skipping artifact [com.group.test:test-artifact:jar:shaded:1.0-SNAPSHOT]

If attached artifact to skip doesn't exists the plugin will fail the execution:

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:3.0.3-SNAPSHOT:deploy (default-deploy) on project cc-manager4j: No attached artifact com.group.test:test-artifact:zip:shaded:1.0-SNAPSHOT to exclude from deploy found -> [Help 1]
[ERROR]

[khmarbaise]

First thanks for trying to contribute...(BTW: Can you read the informations about contribution etc. here https://github.com/apache/maven-help-plugin we have not yet added the information to all plugin repositories on github)..

Maybe I misunderstand your idea...but if I have configured maven-shade-plugin to attach the artifact why should I skip deploying the artifact?
And the same question when I add an zip/artifact via build-helper-maven-plugin than the same question: Why should I don't deploy it?

Can you give an example of a real life scenario where this makes sense ?

[khmarbaise]

So added some information https://github.com/apache/maven-deploy-plugin/tree/MDEPLOY-239 ...

[xleon90]

Thank you for sharing and introducing informations about contribution on the project. I'll follow all the indicated procedure for possible future contributions.

About needs that made me look for this solution I exposed my specific scenario as solution on the following thread on stackoverflow:
https://stackoverflow.com/questions/39286613/maven-shaded-jar-used-as-external-project-dependency/51443562#51443562

Basically I needed to attach an uber jar artifact on my maven module without versioning it on my repository. Reason is that this artifact is then included as dependency into another module and this is the one uploaded on repository ( this will allow me to exclude transitive dependencies I had instead into the skipped one ).

Moreover I found also that other people searched for this solution according to their needs.
Here for example another thread on stackoverflow:
https://stackoverflow.com/questions/17006405/exclude-jar-with-dependencies-from-deploying-to-nexus?rq=1

In general I think it could be useful for all that scenarios where user want to generate attached artifacts and just use these locally for some reason without uploading them on repository.
Furthermore I've forked from this plugin cause it already provides the "skip" option that allows to bypass deploy for primary artifact and all attached ones also. I thought so that this solution can help also users that want to bypass only a custom set of attached artifacts.

[rvesse]

Another practical use case, due to the constraints of our CI/CD system some of our projects use Apache Maven as the overarching build tool but use plugins to invoke other tools - docker, helm, rpmbuild - to package non-Maven things based upon our Maven build outputs. For example we have modules with packaging type war that will also package the built war into a Docker image with Jetty when an optional profile (-Pdocker) is activated.

Then for ease of integration testing within our large multi-modules builds we have these plugins attach Maven artifacts as well, this lets us then have other modules depend on those artifacts explicitly to enforce required module build order and that the developer activated the right profile. BUT we don't actually want to deploy these attached artifacts because the original artifacts e.g. the Docker images themselves are going to get deployed by non-Maven post-processing steps to their own appropriate repositories provided as part of our CI/CD system.

TL;DR

We use Maven to build non-Maven artifacts (e.g. Docker images) that don't want/need to be deployed to our Maven repository

[reza-namazi]

another usecase is i have a shaded artifact which i don't want to deploy to remote repository even i skip the main project artifact to deploy the rpm artifact but still the shaded artifact is deployed there! there must be a way to skip base in classifier.
the reason for this is really simple and necessary.

[micheljung]

In my case, I produce an -executable JAR with the spring-boot-maven-plugin which is a JAR prefixed with a shell script or so. Our artifact repository, however, doesn't allow uploading such invalid JARs (and the artifact of interest is the resulting RPM anyways). Therefore, I'd like to exclude it.

[michaelboyles]

My use-case is that I generate a Spring Boot fat JAR with spring-boot-maven-plugin:repackage, then I ZIP that together with a bunch of scripts etc. with maven-assembly-plugin:single to create a final ZIP. The ZIP is the thing I want to deploy, and I don't want to deploy the Spring Boot JAR.

I can skip attaching the fat JAR (the plugin supports <attach>false</attach>) but all that does is leave the original JAR attached from maven-jar-plugin. There is no configuration to not attach that, and even if there was, there's a good chance doing so would break the Spring Boot plugin.

I just want a simple way to tell deploy-plugin, "don't deploy something". I don't want to go down a rabbit hole trying to stop stuff being attached in the first place.

I could imagine a world where someone wants an artifact to be install-able but not deploy-able. In which case, not attaching the artifact is not a solution.

@khmarbaise Can you please comment on this? You wanted a real-world use-case, and 5 people have now given you theirs.

It's disappointing that a PR has been ready to go for 6 years and is still sitting here. I checked through it and it looks like a high-quality change. It has tests and updates to documentation. I'm happy to fix the conflicts.

[Copilot]

Pull request overview

Note

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Adds support to selectively skip deployment of specified attached artifacts in the Maven Deploy Plugin.

Changes:

• Introduces a new skipAttachedArtifacts plugin configuration parameter.
• Removes matching attached artifacts from the deploy set and logs skipped artifacts.
• Adds/updates unit tests and site FAQ documentation for the new behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 9 comments.

File	Description
src/main/java/org/apache/maven/plugins/deploy/DeployMojo.java	Adds skipAttachedArtifacts configuration and removal logic before deployment
src/main/java/org/apache/maven/plugins/deploy/AttachedArtifact.java	New configuration POJO to identify attached artifacts to skip
src/test/java/org/apache/maven/plugins/deploy/DeployMojoTest.java	Adds tests for success/failure behavior when excluding attached artifacts
src/site/fml/faq.fml	Documents how to configure skipping attached artifacts

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.