wildfly app deploy role
========================

Role to deploy applications (.war, .ear, .jar) to WildFly application server in standalone mode.

Requirements
------------

* WildFly server must be installed and running
* Management interface must be accessible
* The `wildfly_utils` role is required as a dependency

<!--start argument_specs-->
Role Defaults
-------------

| Variable | Description | Default |
|:---------|:------------|:--------|
|`wildfly_app_deployment_file`| Path to the application artifact (.war, .ear, .jar) on the Ansible controller | `/path/to/your/application.war` |
|`wildfly_app_deploy_name`| The name to use for the deployment in WildFly (e.g., app-v1.war) | `application.war` |
|`wildfly_home`| WildFly installation directory (inherits from wildfly_install role) | Inherited |
|`jboss_home`| WildFly installation directory, for backwards compatibility (inherits from wildfly_utils role) | Inherited |
|`jboss_cli_controller_host`| Hostname for connecting to CLI | `localhost` |
|`jboss_cli_controller_port`| Port for connecting to CLI | `9990` |
|`wildfly_port_range_offset`| Increment for `jboss.socket.binding.port-offset` | `0` |
|`wildfly_user`| POSIX user account for WildFly | `wildfly` |
|`wildfly_group`| POSIX group for WildFly | `{{ wildfly_user }}` |

Role Variables
--------------

| Variable | Description | Required |
|:---------|:------------|:---------|
|`wildfly_app_deployment_file`| Path to the application artifact on the Ansible controller | `Yes` |
<!--end argument_specs-->

## Example Playbooks

### Deploy Application to Standalone Server

Deploy a WAR file to a standalone WildFly instance.

```yaml
- name: Deploy application to WildFly
  hosts: wildfly_servers
  gather_facts: false
  roles:
    - role: middleware_automation.wildfly.wildfly_app_deploy
  vars:
    wildfly_app_deployment_file: "/path/to/myapp.war"
    wildfly_app_deploy_name: "myapp.war"
    wildfly_home: "/opt/wildfly/wildfly-39.0.0.Final/"
    jboss_cli_controller_host: "localhost"
    jboss_cli_controller_port: "9990"
```

### Deploy with Port Offset

Deploy to a WildFly instance using a port offset.

```yaml
- name: Deploy application with port offset
  hosts: wildfly_servers
  gather_facts: false
  roles:
    - role: middleware_automation.wildfly.wildfly_app_deploy
  vars:
    wildfly_app_deployment_file: "/path/to/myapp.war"
    wildfly_app_deploy_name: "myapp.war"
    wildfly_port_range_offset: 100
    jboss_cli_controller_port: "9990"  # Port will be 9990 + 100 = 10090. See https://docs.wildfly.org/39/ for port offset documentation
```

## Dependencies

* `wildfly_utils` - Required for CLI operations

## License

Apache License 2.0

## Author Information

* [Harsha Cherukuri](https://github.com/hcheruku)