ansible-nas/docs/installation.md
Malpractis 910b8ddd9f
update ansible installation instructions
Ansible has their own PPA now. The existing instructions (tested on ubuntu 18.04) will result in ansible 2.5.2 being installed, whereas adding the PPA will result in the latest (2.9.3).
2020-01-21 08:49:01 +11:00

1.4 KiB

💀 💀 💀 Before running anything, check out the playbook and understand what it does. Run it against a VM and make sure you're happy. Do not blindly download code from the internet and trust that it's going to work as you expect. 💀 💀 💀

You can run Ansible-NAS from the computer you plan to use for your NAS, or from a remote controlling machine. The steps for deployment are exactly the same, just pay attention to editing the inventory file in step 7.

  1. Enable the Ubuntu Universe repository:

    sudo add-apt-repository universe

  2. Install Ansible:

    sudo apt update

    sudo apt install software-properties-common

    sudo apt-add-repository --yes --update ppa:ansible/ansible

    sudo apt install ansible

  3. Clone Ansible-NAS:

    git clone https://github.com/davestephens/ansible-nas.git && cd ansible-nas

  4. Create your own inventory and config files by copying inventories/sample to your own directory:

    cp -rfp inventories/sample inventories/my-ansible-nas

  5. Review group_vars/all.yml. Change settings by overriding them in inventories/my-ansible-nas/group_vars/nas.yml.

  6. Update inventories/my-ansible-nas/inventory.

  7. Install the dependent roles: ansible-galaxy install -r requirements.yml (you might need sudo to install Ansible roles).

  8. Run the playbook - something like ansible-playbook -i inventories/my-ansible-nas/inventory nas.yml -b -K should do you nicely.