Fix Galleon feature pack

hpehl · hpehl · commit 4c7dcfc99d77 · 2026-03-05T11:40:09.000+01:00
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -29,13 +29,28 @@ mvn install -P quick-build
 # Native binary (requires GraalVM)
 mvn install -P op,prod,native -Dquarkus.native.container-build=false
 
+# Build Galleon feature pack
+mvn install -P prod,op,feature-pack
+
 # Run a single test class
 mvn test -pl <module> -Dtest=<TestClassName>
 
 # Run a single test method
 mvn test -pl <module> -Dtest=<TestClassName>#<methodName>
 ```
 
+## Galleon Provisioning
+
+After building the feature pack, provision a WildFly server with the HAL console using the Galleon CLI:
+
+```bash
+galleon.sh provision op/feature-pack/target/provision.xml --dir=/path/to/wildfly
+```
+
+The `provision.xml` in `op/feature-pack/` uses `${project.version}` for the feature pack version. During the build, Maven resource filtering produces `target/provision.xml` with the resolved version. It provisions a full default WildFly standalone server and adds the `halop` layer on top.
+
+Start the provisioned server with `--stability=experimental`.
+
 ## Development Mode
 
 Two processes are needed simultaneously:
@@ -78,6 +93,8 @@ All code modules live under `code-parent` for shared dependency management:
 Application modules:
 - `op/console` — J2CL-compiled SPA (Parcel bundler, PatternFly 6)
 - `op/standalone` — Quarkus HTTP server wrapping the SPA
+- `op/subsystem` — WildFly subsystem extension for the HAL console
+- `op/feature-pack` — Galleon feature pack to provision HAL into WildFly
 
 Supporting modules: `bom` (dependency versions), `build-config` (checkstyle/license rules).
 
diff --git a/README.md b/README.md
@@ -60,7 +60,7 @@ is a management interface of a running WIldFly instance.
 To build halOP as a standalone Java application, run
 
 ```shell
-mvn install -P op,prod
+mvn install -P prod,op,standalone
 ```
 
 This will package the transpiled HTML, CSS and JavaScript resources into a Quarkus-based HTTP server. To start it, run
@@ -76,7 +76,7 @@ and open a browser at http://localhost:9090.
 To build the native binary of halOP, run
 
 ```shell
-mvn install -P op,prod,native -Dquarkus.native.container-build=false
+mvn install -P prod,op,standalone,native -Dquarkus.native.container-build=false
 ```
 
 Please make sure that you have a recent version of GraalVM installed.
@@ -92,6 +92,8 @@ chmod +x hal-op-*
 xattr -d com.apple.quarantine hal-op-*
 ```
 
+If you want to customize the port of halOP (Java-based and native), please use `-Dquarkus.http.port=<port>` to change the port.
+
 ## Container
 
 halOP is also available as a container image at https://quay.io/repository/halconsole/hal-op. Use
@@ -102,9 +104,15 @@ podman run -it -p 9090:9090 quay.io/halconsole/hal-op
 
 to start it and open a browser at http://localhost:9090.
 
-## Customization
+## Galleon Provisioning
 
-If you want to customize the port of halOP (Java-based and native), please use `-Dquarkus.http.port=<port>` to change the port.
+halOP is also available as a feature pack that can be provisioned with [Galleon](https://github.com/wildfly/galleon).
+
+1. Build the feature pack with `mvn install -P prod,op,feature-pack`
+2. Provision a WildFly server with `galleon.sh provision op/feature-pack/target/provision.xml --dir=$TMPDIR/wildfly --stability-level=experimental`
+3. `cd $TMPDIR/wildfly`
+4. Add a WildFly admin user with `bin/add-user.sh -u admin -p admin --silent`
+5. Start the server with `bin/standalone.sh --stability=experimental`
 
 # halOS (HAL on OpenShift)
 
@@ -114,7 +122,7 @@ halOS is not yet implemented!
 
 # Contributing
 
-This is an open source project. That means that everybody can contribute. It's not hard to get started. So
+This is an open-source project. That means that everybody can contribute. It's not hard to get started. So
 start [contributing](CONTRIBUTING.md) today!
 
 # Licenses
diff --git a/op/console/package.json b/op/console/package.json
@@ -13,7 +13,8 @@
     "start:server": "node server.js 1234 1235",
     "open:browser": "wait-on http://localhost:1234 && open http://localhost:1234",
     "watch": "concurrently \"npm run start:parcel\" \"npm run start:server\" \"npm run open:browser\"",
-    "prod": "parcel build src/web/index.html --dist-dir target/console"
+    "prod:standalone": "parcel build src/web/index.html --dist-dir target/console",
+    "prod:feature-pack": "parcel build src/web/index.html --dist-dir target/console --public-url /halop"
   },
   "dependencies": {
     "@patternfly-java/charts": "^0.0.13",
diff --git a/op/console/pom.xml b/op/console/pom.xml
@@ -214,7 +214,7 @@
                                     <goal>corepack</goal>
                                 </goals>
                                 <configuration>
-                                    <arguments>pnpm run prod</arguments>
+                                    <arguments>pnpm run ${npm.script}</arguments>
                                 </configuration>
                             </execution>
                         </executions>
diff --git a/op/console/src/web/dev.html b/op/console/src/web/dev.html
@@ -26,6 +26,6 @@
     <script type="module" src="./main.js"></script>
 </head>
 <body>
-    <script type="text/javascript" src="./console.js" defer></script>
+    <script type="text/javascript" src="console.js" defer></script>
 </body>
 </html>
diff --git a/op/console/src/web/index.html b/op/console/src/web/index.html
@@ -26,6 +26,6 @@
     <script type="module" src="./main.js"></script>
 </head>
 <body>
-    <script type="text/javascript" src="./console.js" defer></script>
+    <script type="text/javascript" src="console.js" defer></script>
 </body>
 </html>
diff --git a/op/feature-pack/pom.xml b/op/feature-pack/pom.xml
@@ -34,11 +34,11 @@
     <description>WildFly feature pack for HAL console on premise</description>
 
     <properties>
+        <halop.stability>experimental</halop.stability>
         <version.org.wildfly>39.0.1.Final</version.org.wildfly>
         <version.org.wildfly.core>31.0.3.Final</version.org.wildfly.core>
         <version.org.wildfly.common>2.0.1</version.org.wildfly.common>
         <version.org.wildfly.galleon-plugins>8.1.0.Final</version.org.wildfly.galleon-plugins>
-        <wildfly.halop.stability>experimental</wildfly.halop.stability>
     </properties>
 
     <dependencies>
@@ -69,14 +69,26 @@
     <build>
         <plugins>
             <plugin>
-                <artifactId>maven-clean-plugin</artifactId>
+                <artifactId>maven-resources-plugin</artifactId>
                 <executions>
                     <execution>
-                        <id>auto-clean</id>
-                        <phase>initialize</phase>
+                        <id>filter-provision-xml</id>
+                        <phase>generate-resources</phase>
                         <goals>
-                            <goal>clean</goal>
+                            <goal>copy-resources</goal>
                         </goals>
+                        <configuration>
+                            <outputDirectory>${project.build.directory}</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>${project.basedir}</directory>
+                                    <filtering>true</filtering>
+                                    <includes>
+                                        <include>provision.xml</include>
+                                    </includes>
+                                </resource>
+                            </resources>
+                        </configuration>
                     </execution>
                 </executions>
             </plugin>
@@ -96,9 +108,9 @@
                             <fork-embedded>true</fork-embedded>
                             <generate-channel-manifest>true</generate-channel-manifest>
                             <deploy-channel-manifest>false</deploy-channel-manifest>
-                            <minimum-stability-level>${wildfly.halop.stability}</minimum-stability-level>
+                            <minimum-stability-level>${halop.stability}</minimum-stability-level>
                             <config-stability-level>community</config-stability-level>
-                            <package-stability-level>${wildfly.halop.stability}</package-stability-level>
+                            <package-stability-level>${halop.stability}</package-stability-level>
                         </configuration>
                     </execution>
                 </executions>
diff --git a/op/feature-pack/provision.xml b/op/feature-pack/provision.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+     Copyright 2024 Red Hat
+
+     Licensed 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
+
+         https://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.
+
+-->
+<!-- Just meant as an example for provisioning a WildFly server with HAL OP -->
+<installation xmlns="urn:jboss:galleon:provisioning:3.0">
+    <feature-pack location="org.wildfly:wildfly-galleon-pack:${version.org.wildfly}">
+        <default-configs inherit="true"/>
+        <packages inherit="true"/>
+    </feature-pack>
+    <feature-pack location="org.jboss.hal:hal-op-feature-pack:${project.version}">
+        <default-configs inherit="false"/>
+        <packages inherit="true"/>
+    </feature-pack>
+    <config model="standalone" name="standalone.xml">
+        <layers>
+            <include name="halop"/>
+        </layers>
+    </config>
+    <options>
+        <option name="optional-packages" value="passive+"/>
+        <option name="jboss-fork-embedded" value="true"/>
+        <option name="stability-level" value="experimental"/>
+    </options>
+</installation>
diff --git a/op/pom.xml b/op/pom.xml
@@ -37,6 +37,10 @@
         <module>console</module>
     </modules>
 
+    <properties>
+        <npm.script/>
+    </properties>
+
     <dependencyManagement>
         <dependencies>
             <dependency>
@@ -75,13 +79,17 @@
             <properties>
                 <!-- Must match org.jboss.hal.op.HalOpSubsystemRegistrar#CONTEXT_NAME -->
                 <environment.base>/halop</environment.base>
+                <npm.script>prod:feature-pack</npm.script>
             </properties>
         </profile>
         <profile>
             <id>standalone</id>
             <modules>
                 <module>standalone</module>
             </modules>
+            <properties>
+                <npm.script>prod:standalone</npm.script>
+            </properties>
         </profile>
     </profiles>
 </project>
