[lttng-ci.git] / automation / ansible / README.md

# Required collections

```
ansible-galaxy install -r roles/requirements.yml
```

# Privileged data

Privileged data is stored in Bitwarden. To use roles that fetch privileged data,
the following utilities must be available:

* [bw](https://bitwarden.com/help/cli/)

Once installed, login and unlock the vault:

```
bw login # or, `bw unlock`
export BW_SESSION=xxxx
bw sync -f
```

# Running playbooks

```
ansible-playbook -i hosts [-l SUBSET] site.yaml
```

# Bootstrapping hosts

## Windows

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