Metadata-Version: 2.1
Name: ansible-modules-pm2
Version: 0.0.1
Summary: Manage processes via pm2
Home-page: https://github.com/10sr/ansible-modules-pm2
Author: 10sr
Author-email: 8.slashes@gmail.com
License: GNU GPL v3
Description: ![Test CI](https://github.com/10sr/ansible-modules-pm2/workflows/Test%20CI/badge.svg)
        
        
        ansible-modules-pm2
        ===================
        
        Manage processes via [PM2](https://pm2.keymetrics.io/)
        
        - Manage the state of processes via pm2 process manager
        - Start/Stop/Restart/Reload/Delete applications
        
        
        
        Usage
        =====
        
        
        Examples
        --------
        
        
        ```yaml
        ---
        - name: Start myapp with process config file, if not running
          pm2:
            name: myapp
            config: /path/to/myapp/myapp.json
            state: started
        
        - name: Start myapp.js, if not running
          pm2:
            name: myapp
            script: /path/to/myapp/myapp.js
            state: started
        
        - name: Stop process named myapp, if running
          pm2:
            name: myapp
            state: stopped
        
        - name: Restart myapp, in all cases
          pm2:
            name: myapp
            state: restarted
        
        - name: Reload myapp, in all cases
          pm2:
            name: myapp
            state: reloaded
        
        - name: Delete myapp, if exists
          pm2:
            name: myapp
            state: absent
        
        - name: Specify pm2 executable path
          pm2:
            name: myapp
            state: started
            config: /path/to/myapp/myapp.json
            executable: /path/to/myapp/node_modules/.bin/pm2
        
        - name: Also specify working directory where running pm2 command
          pm2:
            name: myapp
            state: started
            config: /path/to/myapp/myapp.json
            executable: /path/to/myapp/node_modules/.bin/pm2
            chdir: /path/to/working/directory
        ```
        
        
        Arguments
        ---------
        
        | Parameters      | Choices                                                                                | Comments                                                                                                                                                                                                                                                                                                  |
        |-----------------|----------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
        | name (required) |                                                                                        | Name of the application.<br>Required for all cases to check current status of app                                                                                                                                                                                                                         |
        | state           | `started` (default)<br>`stopped`<br>`restarted`<br>`reloaded`<br>`absent`<br>`deleted` | `started`/`stopped`/`absent`/`deleted` are idempotent actions that will not run commands unless necessary.<br>`restarted` will always restart the process.<br>`reloaded` will always reload.<br>Note that `restarted` will fail when the process does not exist (action does not start it automatically). |
        | config          |                                                                                        | Process configuration file, in JSON or YAML format.<br>Either `config` or `script` is required when `state=started`.                                                                                                                                                                                      |
        | script          |                                                                                        | Executalbe file to start.<br>Either `config` or `script` is required when `state=started`.                                                                                                                                                                                                                |
        | executable      |                                                                                        | Path to pm2 executable.                                                                                                                                                                                                                                                                                   |
        | chdir           |                                                                                        | Change into this directory before running pm2 start command.<br>When `state=started` and this option is omitted, use the directory where `config` or `script` exists.                                                                                                                                     |
        
        License
        =======
        
        This software is licensed under GPLv3. See `LICENSE` for details.
        
Keywords: ansible
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Provides-Extra: dev
