92 lines
1.7 KiB
Markdown
92 lines
1.7 KiB
Markdown
# 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](#wsl-setup-instructions) below.
|
|
|
|
## Usage
|
|
|
|
run a playbook:
|
|
|
|
```bash
|
|
ansible-playbook playbooks/<playbook_name>.yml
|
|
```
|
|
|
|
run a playbook with sudo:
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
sudo nano /etc/wsl.conf
|
|
```
|
|
|
|
Add the following lines:
|
|
|
|
```ini
|
|
[automount]
|
|
enabled = true
|
|
options = "metadata,umask=022,fmask=0111"
|
|
```
|
|
|
|
If you use a Network Drive, you have to mount it manually:
|
|
|
|
```bash
|
|
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`:
|
|
|
|
```fstab
|
|
<drive_letter>: /mnt/<drive_letter> drvfs metadata,umask=022,fmask=0111 0 0
|
|
```
|
|
|
|
Reload fstab:
|
|
|
|
```bash
|
|
sudo mount -a
|
|
```
|
|
|
|
Remove others write permissions in your project folder:
|
|
|
|
```bash
|
|
sudo chmod -R o-w .
|
|
```
|
|
|
|
----
|
|
|
|
Install Ansible on WSL:
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install ansible ssh-askpass
|
|
```
|
|
|
|
Add SSH Keys from Windows to WSL:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
sudo shutdown -r now
|
|
```
|