automation/ansible/README.md

   1 # Setup on Ubuntu
   2
   3 ```
   4 apt install ansible ansible-mitogen
   5 ```
   6
   7 # Required collections
   8
   9 ```
  10 ansible-galaxy install -r roles/requirements.yml
  11 ```
  12
  13 # Privileged data
  14
  15 Privileged data is stored in Bitwarden. To use roles that fetch privileged data,
  16 the following utilities must be available:
  17
  18 * [bw](https://bitwarden.com/help/cli/)
  19
  20 Once installed, login and unlock the vault:
  21
  22 ```
  23 bw login # or, `bw unlock`
  24 export BW_SESSION=xxxx
  25 bw sync -f
  26 ```
  27
  28 # Running playbooks
  29
  30 ```
  31 ansible-playbook -i hosts [-l SUBSET] site.yaml
  32 ```
  33
  34 # Bootstrapping hosts
  35
  36 ## Windows
  37
  38 1. Configure either SSH or WinRM connection: see https://docs.ansible.com/ansible/latest/os_guide/windows_setup.html
  39 2. For arm64 hosts:
  40   * Install the necessary optional features (eg. OpenSSH, Hyper-V) since Windows RSAT isn't available on Arm64 yet