🚀 JBoss/Wildfly Deploy CLI

A lightweight and fast CLI tool to deploy EAR/WAR artifacts to JBoss or Wildfly.

Features

• Fast Build: Automatic project building — supports Gradle and Maven (auto-detects and uses gradlew/mvnw wrappers).
• Smart Deployment: Direct deployment to standalone/deployments with real-time validation polling.
• Modern UI: Interactive TUI with semantic logging.
• Persistent Preferences: Remembers your last server, debug port, JVM memory profile, and startup mode between sessions.
• Configurable Debug: Choose your JVM debug port dynamically.
• Dynamic JVM Memory: Assign pre-configured JVM memory capacities independently for each server.
• Seamless Workflow: Automatic server startup after deployment and persistent loop-based interface to keep you in the flow.

📋 Requirements

• Node.js v20+
• Gradle or Maven (or project wrappers gradlew / mvnw)
• JBoss/Wildfly configured locally

⚙️ Installation

Quick Start (No installation)

Run the tool instantly using npx:

npx jbdeploy

Global Installation

npm install -g jbdeploy

🛠️ Development

Local Setup

If you want to contribute or build the latest version from source:

1. Clone the repository and install dependencies:

npm install

2. Build and enable global linking:

npm run build
npm link

Now you can use jbdeploy from any terminal.

3. Run in watch mode during development:

npm run dev

🏗️ Build Pipeline

• Core: Built with TypeScript for Node.js 20+.
• Distribution: Compiles with tsup into a single, specialized ESM bundle (dist/index.js) with a Node.js shebang, ensuring seamless usage in any Node environment.

🚀 Usage

Run the CLI from any project you want to deploy:

jbdeploy

Workflow

1. Server Selection: Choose a saved server or add a new one.
2. Action: Choose between Build, copy & start, Copy & start, or Start server (when the server is already running, deploy variants are shown).
3. Build (if applicable): Gradle or Maven is auto-detected.
4. Server Mode: If the server is stopped, choose Normal or Debug mode. Your last choice is remembered.
5. Auto-Start: After a successful deployment with the server stopped, the CLI starts it automatically.

📁 Configuration

All preferences, registered JBoss servers, JVM memory profiles, and debug ports are saved locally at:

~/.jbdeploy/config.json

---

�️ Show help

jbdeploy --help

📄 License

MIT