Skip to content

Correct the release procedure in RELEASING.md: publishing is automatic - #61

Merged
slachiewicz merged 1 commit into
masterfrom
fix/releasing-njord
Aug 8, 2026
Merged

Correct the release procedure in RELEASING.md: publishing is automatic#61
slachiewicz merged 1 commit into
masterfrom
fix/releasing-njord

Conversation

@slachiewicz

Copy link
Copy Markdown
Member

Follow-up to #60, which I got wrong. Part of #58.

RELEASING.md says:

release:perform builds from the tag and stages to the Central Portal. Then publish the staged deployment from the Central Portal UI.

There is no such manual step.

maven-release-plugin is configured in the parent POM with <goals>deploy</goals> and <releaseProfiles>plexus-release</releaseProfiles>. The plexus-release profile sets njord.enabled=true, and Njord is registered as a build extension with:

<njord.publisher>sonatype-cp</njord.publisher>
<njord.autoPublish>true</njord.autoPublish>
<njord.publishingType>automatic</njord.publishingType>

So release:perform publishes to Central by itself. njord.enabled is false outside the release profile, so normal builds are unaffected.

Telling a release manager to go and finish the job in the Portal UI would have them looking for something that isn't there — which is a worse failure than saying nothing, so worth fixing promptly now that #60 is merged.

Also adds that releasing needs Maven 3.9.0: plexus-release raises minimalMavenBuildVersion from the 3.6.3 an ordinary build needs, so a release run on 3.6.x fails the enforcer.

I found this while documenting the parent POM itself (codehaus-plexus/plexus-pom#438), which describes the same mechanism from the other side.

RELEASING.md said release:perform stages to the Central Portal and the
release manager then publishes from the Portal UI. That is wrong.

maven-release-plugin runs with releaseProfiles=plexus-release, which
sets njord.enabled=true. Njord is registered as a build extension and
configured with autoPublish=true and publishingType=automatic, so it
publishes the deployment itself.

Also records that releasing needs Maven 3.9.0, since the plexus-release
profile raises minimalMavenBuildVersion above the 3.6.3 an ordinary
build requires.
@slachiewicz slachiewicz added the documentation Documentation and site content label Aug 8, 2026
@slachiewicz
slachiewicz merged commit bd75aa6 into master Aug 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation and site content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant