https://github.com/wtower/ansible-node-deploy

Ansible role to deploy a Node.js app to Plesk.
https://github.com/wtower/ansible-node-deploy

ansible-role deployment nodejs plesk

Last synced: 2 months ago
JSON representation

Ansible role to deploy a Node.js app to Plesk.

• Host: GitHub
• URL: https://github.com/wtower/ansible-node-deploy
• Owner: Wtower
• License: bsd-3-clause
• Created: 2016-07-08T19:12:55.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-07-25T12:43:19.000Z (almost 8 years ago)
• Last Synced: 2025-02-02T18:26:17.850Z (4 months ago)
• Topics: ansible-role, deployment, nodejs, plesk
• Size: 11.7 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
node-deploy

===========

Ansible role to deploy a Node.js app to Plesk

Use [ansible-nvm](https://github.com/Wtower/ansible-nvm) role to ensure node is installed. 

Required variables 

------------------

(passed as extra variables):

- `project`: **Node project name**

Optional variables

------------------

(passed as extra variables):

- `exclude`: Additional pattern to exclude from sync, eg. `uploads/`.

- `loaddata`: Specify mongo dump directory in host directory to perform a mongo restore, eg. `dump`.

Required Configuration variables 

--------------------------------

(better to keep in configuration file as shown in examples):

- `conf`: A dictionary to help organize variables, containing:

- `conf.dev_path`: The local path of the project, eg ~/workspace/python/myproject.

- `conf.host_path`: The remote path, where the wsgi index script lies, eg /var/www/vhosts/subscription/domain.

Optional Configuration variables

--------------------------------

- `conf.node_version`: The node.js version of the app, default: `4.4.7`.

- `conf.node_port`: The node.js server port, default: `3000`.

- `conf.start_script`: The node.js start script, default: `bin/www`.

- `conf.node_env`: The node.js environment, default: `production`.

- `conf.https_only`: If true then configure Apache 

  [only for SSL](https://github.com/Wtower/ansible-node-deploy/issues/6). Default: `false`.

- `conf.domain_name`: Domain name to be used in Apache conf. Omit to skip configure Apache in Plesk 

  and register system service.

- `conf.vhost_conf_path`: The remote path, where the apache configuration override (`vhost.conf`) is located.

Other default variables

-----------------------

- `ansible_user_id`: The user id with access to mysql and mysql database.

- `sync_opts`: Additional options for rsync. Default: exclude `.*`. 

Playbook examples

-----------------

See the folder `examples/`:

- `node_deploy.yml`: playbook example

- `node_apps.yml`: configuration example

Task description

----------------

1. Check that local project path in configuration is valid and has package.json

   Checks that there is a valid local path specified in `node_apps.yml` and a `package.json` exists.

   Avoids deploying wrong files.

2. Check if gulp file exists

   So that to execute next step.

3. Execute gulp

   Execute `gulp --production` locally.

4. Create directory

   Creates a `project` directory in target to deploy files.

5. (Enable Apache proxy) (removed)

   Makes sure that `mod_proxy` is enabled.

   If the configuration changes, causes Apache to restart in the end (notifies handler).

6. Build sync options

   Append any additional excluded files in the rsync options.

7. Sync files

   Syncs files to target directory.

   :warning: Make sure that you have synced back any user uploaded files with manual `rsync`. 

8. Load data

   Perform a mongo restore from the optionall specified additional variable `loaddata`.

9. Configure Apache

   Configure Apache to proxy to server using the provided template file.

   If the configuration changes, causes Plesk to reconfigure the domain in the end (notifies handler).

   If the configuration changes, causes Apache to restart in the end (notifies handler).

10. Configure Apache SSL

   Same as above, for SSL vhost.

11. Set node path

   Auxiliary task which sets a variable with the nvm node path executables.

13. (Upgrade npm) (removed)

   Upgrades global npm.

14. (Install npm requirements) (removed)

   Run `npm install`.

15. Configure service

   Configure an init service to execute node.js using the provided template file.

   If the configuration changes, causes service to restart (notifies handler).