README.md

Ansible Playbook: Nextcloud LAPP

This Ansible playbook deploys Nextcloud using InMotion's LAPP stack roles.

Usage

Quick Start

1. Install Python dependencies:

   $ pip install -r python-requirements.txt

   Optionally consider managing your Python dependencies using virtualenv:

   $ virtualenv venv
   $ source venv/bin/activate
   (venv) $ pip install -r python-requirements.txt

2. Install Ansible dependencies:

   $ ansible-galaxy install -r playbook-requirements.yml

3. Copy inventory.sample.yml:

   $ cp inventory{.sample,}.yml

4. Edit your inventory.yml:

   # Feel free to use your preferred editor
   $ vi inventory.yml

   In the inventory.yml file created in the last step, you will need to edit the placeholder values. At minimum, you will need to change the reference to domain.tld: under hosts:

   $ diff inventory.sample.yml inventory.yml
   22c22
   <     domain.tld:
   ---
   >     a-real-domain.tld:

5. Run the playbook:

   $ ansible-playbook -i inventory.yml site.deploy.yml

Update

To grab the latest copy of the Playbook and update an existing deployment, you may use the following steps:

1. Pull any changes to the playbook:

   $ git pull origin master

2. Update the Python dependencies:

   $ pip install -Ur python-requirements.txt

3. Update the Playbook dependencies:

   $ ansible-galaxy install -r playbook-requirements.yml --force

4. Run the Playbook:

   $ ansible-playbook -i inventory.yml site.deploy.yml

Files

File	Description
ansible.cfg	The Ansible configuration defined for this playbook.
inventory.sample.yml	The sample inventory provided by this playbook.
python-requirements.txt	The Python dependencies required by this Playbook
playbook-requirements.yml	The Playbook dependencies required by this Playbook