Ansible/README.md

Ansible

Setup

Rename inventory/inventory.example.yml to inventory/inventory.yml and adjust the host IPs and usernames as needed.

To install and use Ansible on Windows, follow the WSL Setup Instructions below.

Usage

run a playbook:

ansible-playbook playbooks/<playbook_name>.yml

run a playbook with sudo:

ansible-playbook playbooks/<playbook_name>.yml -K

WSL Setup Instructions

To use Ansible on Windows, you need to set up Windows Subsystem for Linux (WSL). You then have the option to open a local Folder in VSCode and open a WSL terminal that points to the same folder under WSL.

---

To enable proper file permissions for Ansible on WSL, you need to configure the WSL automount settings.

sudo nano /etc/wsl.conf

Add the following lines:

[automount]
enabled = true
options = "metadata,umask=022,fmask=0111"

If you use a Network Drive, you have to mount it manually:

sudo mkdir /mnt/<drive_letter>
sudo mount -t drvfs <drive_letter>: /mnt/<drive_letter> -o metadata,umask=022,fmask=0111

To mount it automatically on WSL start, add the following lines to /etc/fstab:

<drive_letter>: /mnt/<drive_letter> drvfs metadata,umask=022,fmask=0111 0 0

Reload fstab:

sudo mount -a

Remove others write permissions in your project folder:

sudo chmod -R o-w .

---

Install Ansible on WSL:

sudo apt update
sudo apt install ansible ssh-askpass

Add SSH Keys from Windows to WSL:

cp -r /mnt/c/Users/<username>/.ssh ~/.ssh
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_rsa
chmod 644 ~/.ssh/id_rsa.pub

Lastly, restart WSL to apply the changes:

sudo shutdown -r now