#!/usr/bin/python # -*- coding: utf-8 -*- # (c) 2013, Jeroen Hoekx # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) from __future__ import absolute_import, division, print_function __metaclass__ = type DOCUMENTATION = r''' module: jboss short_description: Deploy applications to JBoss description: - Deploy applications to JBoss standalone using the filesystem. options: deployment: required: true description: - The name of the deployment. type: str src: description: - The remote path of the application ear or war to deploy. - Required when I(state=present). - Ignored when I(state=absent). type: path deploy_path: default: /var/lib/jbossas/standalone/deployments description: - The location in the filesystem where the deployment scanner listens. type: path state: choices: [ present, absent ] default: "present" description: - Whether the application should be deployed or undeployed. type: str notes: - The JBoss standalone deployment-scanner has to be enabled in standalone.xml - The module can wait until I(deployment) file is deployed/undeployed by deployment-scanner. Duration of waiting time depends on scan-interval parameter from standalone.xml. - Ensure no identically named application is deployed through the JBoss CLI seealso: - name: WildFly reference description: Complete reference of the WildFly documentation. link: https://docs.wildfly.org author: - Jeroen Hoekx (@jhoekx) ''' EXAMPLES = r""" - name: Deploy a hello world application to the default deploy_path community.general.jboss: src: /tmp/hello-1.0-SNAPSHOT.war deployment: hello.war state: present - name: Update the hello world application to the non-default deploy_path community.general.jboss: src: /tmp/hello-1.1-SNAPSHOT.war deploy_path: /opt/wildfly/deployment deployment: hello.war state: present - name: Undeploy the hello world application from the default deploy_path community.general.jboss: deployment: hello.war state: absent """ RETURN = r""" # """ import os import shutil import time from ansible.module_utils.basic import AnsibleModule DEFAULT_DEPLOY_PATH = '/var/lib/jbossas/standalone/deployments' def is_deployed(deploy_path, deployment): return os.path.exists(os.path.join(deploy_path, "%s.deployed" % deployment)) def is_undeployed(deploy_path, deployment): return os.path.exists(os.path.join(deploy_path, "%s.undeployed" % deployment)) def is_failed(deploy_path, deployment): return os.path.exists(os.path.join(deploy_path, "%s.failed" % deployment)) def main(): module = AnsibleModule( argument_spec=dict( src=dict(type='path'), deployment=dict(type='str', required=True), deploy_path=dict(type='path', default=DEFAULT_DEPLOY_PATH), state=dict(type='str', choices=['absent', 'present'], default='present'), ), required_if=[('state', 'present', ('src',))], supports_check_mode=True ) result = dict(changed=False) src = module.params['src'] deployment = module.params['deployment'] deploy_path = module.params['deploy_path'] state = module.params['state'] if not os.path.exists(deploy_path): module.fail_json(msg="deploy_path does not exist.") if state == 'absent' and src: module.warn('Parameter src is ignored when state=absent') elif state == 'present' and not os.path.exists(src): module.fail_json(msg='Source file %s does not exist.' % src) deployed = is_deployed(deploy_path, deployment) # === when check_mode === if module.check_mode: if state == 'present': if not deployed: result['changed'] = True elif deployed: if module.sha1(src) != module.sha1(os.path.join(deploy_path, deployment)): result['changed'] = True elif state == 'absent' and deployed: result['changed'] = True module.exit_json(**result) # ======================= if state == 'present' and not deployed: if is_failed(deploy_path, deployment): # Clean up old failed deployment os.remove(os.path.join(deploy_path, "%s.failed" % deployment)) module.preserved_copy(src, os.path.join(deploy_path, deployment)) while not deployed: deployed = is_deployed(deploy_path, deployment) if is_failed(deploy_path, deployment): module.fail_json(msg='Deploying %s failed.' % deployment) time.sleep(1) result['changed'] = True if state == 'present' and deployed: if module.sha1(src) != module.sha1(os.path.join(deploy_path, deployment)): os.remove(os.path.join(deploy_path, "%s.deployed" % deployment)) module.preserved_copy(src, os.path.join(deploy_path, deployment)) deployed = False while not deployed: deployed = is_deployed(deploy_path, deployment) if is_failed(deploy_path, deployment): module.fail_json(msg='Deploying %s failed.' % deployment) time.sleep(1) result['changed'] = True if state == 'absent' and deployed: os.remove(os.path.join(deploy_path, "%s.deployed" % deployment)) while deployed: deployed = not is_undeployed(deploy_path, deployment) if is_failed(deploy_path, deployment): module.fail_json(msg='Undeploying %s failed.' % deployment) time.sleep(1) result['changed'] = True module.exit_json(**result) if __name__ == '__main__': main()