From 22e9378397cf87b8325b079567e7579684e47f4f Mon Sep 17 00:00:00 2001
From: Robbie Gemmell <robbie@apache.org>
Date: Thu, 18 Dec 2025 16:04:17 +0000
Subject: [PATCH] ARTEMIS-5810: add relocation poms for modules to keep old
 org.apache.activemq groupId usages working and alert users to switch

---
 Releasing.md                                  | 20 ++++++--
 pom.xml                                       |  3 ++
 relocations/apache-artemis-console/pom.xml    | 39 ++++++++++++++
 relocations/artemis-console-extension/pom.xml | 39 ++++++++++++++
 relocations/artemis-console-project/pom.xml   | 39 ++++++++++++++
 relocations/artemis-console-war/pom.xml       | 39 ++++++++++++++
 relocations/pom.xml                           | 51 +++++++++++++++++++
 7 files changed, 225 insertions(+), 5 deletions(-)
 create mode 100644 relocations/apache-artemis-console/pom.xml
 create mode 100644 relocations/artemis-console-extension/pom.xml
 create mode 100644 relocations/artemis-console-project/pom.xml
 create mode 100644 relocations/artemis-console-war/pom.xml
 create mode 100644 relocations/pom.xml

diff --git a/Releasing.md b/Releasing.md
index 509ce07..639e40c 100644
--- a/Releasing.md
+++ b/Releasing.md
@@ -85,11 +85,20 @@ mvn release:perform -Prelease
 ```
 
 Note: this can take quite a while depending on the speed for your Internet connection.
+
+Finally, upload the relocations to ASF Nexus:
+
+[,console]
+----
+cd target/checkout/relocations/
+mvn deploy -Papache-release,deploy-relocations
+----
+
 If the upload fails or is interrupted, remove the incomplete repository
 using the "Drop" button on [Nexus website](https://repository.apache.org/#stagingRepositories).
 Before starting the upload again, check the release.properties at the root of the project.
 
-**_Keep the checkout used to run the release process for later, the website update scripts will reference it for documentation output._**
+**_Keep the checkout used to run the release process for later reference._**
 
 
 ### Resuming release upload
@@ -107,11 +116,12 @@ scm.url=scm:git:https://github.com/apache/artemis-console.git
 scm.tag=1.0.0
 ```
 
-## Closing the staging repository
+## Closing the staging repositories
 
-Give the staging repository contents a quick inspection using the content navigation area, then proceed to close the
-staging repo using the "Close" button on Nexus website, locking it from further modification and exposing its contents
-at a staging URL to allow testing. Set a description such as "Artemis Console <version> (RC1)" while closing.
+A staging repository will be created for the main release, and another created for the relcations deployed separately.
+Give the staging repositories contents a quick inspection using the content navigation area, then proceed to close the
+staging repos using the "Close" button on Nexus website, locking them from further modification and exposing their contents
+at staging URLs to allow testing. Set a description such as "Artemis Console <version> (RC1)" while closing.
 
 ## Stage the release to the dist dev area
 
diff --git a/pom.xml b/pom.xml
index 93eff5b..2f09524 100644
--- a/pom.xml
+++ b/pom.xml
@@ -97,6 +97,9 @@
     <profiles>
         <profile>
             <id>release</id>
+            <modules>
+                <module>relocations</module>
+            </modules>
             <build>
                 <plugins>
                     <plugin>
diff --git a/relocations/apache-artemis-console/pom.xml b/relocations/apache-artemis-console/pom.xml
new file mode 100644
index 0000000..201b332
--- /dev/null
+++ b/relocations/apache-artemis-console/pom.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the License); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an AS IS BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+   <parent>
+      <artifactId>artemis-console-relocations-parent</artifactId>
+      <groupId>org.apache.activemq</groupId>
+      <version>1.5.0-SNAPSHOT</version>
+   </parent>
+   <modelVersion>4.0.0</modelVersion>
+
+   <groupId>org.apache.activemq</groupId>
+   <artifactId>apache-artemis-console</artifactId>
+   <packaging>pom</packaging>
+   <name>Artemis Console Relocations - apache-artemis-console</name>
+
+   <distributionManagement>
+      <relocation>
+         <groupId>org.apache.artemis</groupId>
+         <message>Update the groupId in your project build file. Refer to https://artemis.apache.org/artemis-tlp-groupid-migration for more information.</message>
+      </relocation>
+   </distributionManagement>
+</project>
diff --git a/relocations/artemis-console-extension/pom.xml b/relocations/artemis-console-extension/pom.xml
new file mode 100644
index 0000000..e577326
--- /dev/null
+++ b/relocations/artemis-console-extension/pom.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the License); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an AS IS BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+   <parent>
+      <artifactId>artemis-console-relocations-parent</artifactId>
+      <groupId>org.apache.activemq</groupId>
+      <version>1.5.0-SNAPSHOT</version>
+   </parent>
+   <modelVersion>4.0.0</modelVersion>
+
+   <groupId>org.apache.activemq</groupId>
+   <artifactId>artemis-console-extension</artifactId>
+   <packaging>pom</packaging>
+   <name>Artemis Console Relocations - artemis-console-extension</name>
+
+   <distributionManagement>
+      <relocation>
+         <groupId>org.apache.artemis</groupId>
+         <message>Update the groupId in your project build file. Refer to https://artemis.apache.org/artemis-tlp-groupid-migration for more information.</message>
+      </relocation>
+   </distributionManagement>
+</project>
diff --git a/relocations/artemis-console-project/pom.xml b/relocations/artemis-console-project/pom.xml
new file mode 100644
index 0000000..1bcac0b
--- /dev/null
+++ b/relocations/artemis-console-project/pom.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the License); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an AS IS BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+   <parent>
+      <artifactId>artemis-console-relocations-parent</artifactId>
+      <groupId>org.apache.activemq</groupId>
+      <version>1.5.0-SNAPSHOT</version>
+   </parent>
+   <modelVersion>4.0.0</modelVersion>
+
+   <groupId>org.apache.activemq</groupId>
+   <artifactId>artemis-console-project</artifactId>
+   <packaging>pom</packaging>
+   <name>Artemis Console Relocations - artemis-console-project</name>
+
+   <distributionManagement>
+      <relocation>
+         <groupId>org.apache.artemis</groupId>
+         <message>Update the groupId in your project build file. Refer to https://artemis.apache.org/artemis-tlp-groupid-migration for more information.</message>
+      </relocation>
+   </distributionManagement>
+</project>
diff --git a/relocations/artemis-console-war/pom.xml b/relocations/artemis-console-war/pom.xml
new file mode 100644
index 0000000..2bb60dd
--- /dev/null
+++ b/relocations/artemis-console-war/pom.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the License); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an AS IS BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+   <parent>
+      <artifactId>artemis-console-relocations-parent</artifactId>
+      <groupId>org.apache.activemq</groupId>
+      <version>1.5.0-SNAPSHOT</version>
+   </parent>
+   <modelVersion>4.0.0</modelVersion>
+
+   <groupId>org.apache.activemq</groupId>
+   <artifactId>artemis-console-war</artifactId>
+   <packaging>pom</packaging>
+   <name>Artemis Console Relocations - artemis-console-war</name>
+
+   <distributionManagement>
+      <relocation>
+         <groupId>org.apache.artemis</groupId>
+         <message>Update the groupId in your project build file. Refer to https://artemis.apache.org/artemis-tlp-groupid-migration for more information.</message>
+      </relocation>
+   </distributionManagement>
+</project>
diff --git a/relocations/pom.xml b/relocations/pom.xml
new file mode 100644
index 0000000..8a4db54
--- /dev/null
+++ b/relocations/pom.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<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>
+   <parent>
+      <groupId>org.apache.artemis</groupId>
+      <artifactId>artemis-console-project</artifactId>
+      <version>1.5.0-SNAPSHOT</version>
+   </parent>
+
+   <groupId>org.apache.activemq</groupId>
+   <artifactId>artemis-console-relocations-parent</artifactId>
+   <packaging>pom</packaging>
+   <name>Artemis Console Relocations Parent</name>
+
+   <properties>
+      <checkstyle.skip>true</checkstyle.skip>
+      <maven.deploy.skip>true</maven.deploy.skip>
+   </properties>
+
+   <modules>
+      <module>apache-artemis-console</module>
+      <module>artemis-console-extension</module>
+      <module>artemis-console-project</module>
+      <module>artemis-console-war</module>
+   </modules>
+
+   <profiles>
+      <profile>
+         <id>deploy-relocations</id>
+         <properties>
+            <maven.deploy.skip>false</maven.deploy.skip>
+         </properties>
+      </profile>
+   </profiles>
+</project>