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

# Setup on Ubuntu

```
apt install ansible ansible-mitogen
```

# 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
e689666c MJ	1	# Setup on Ubuntu
	2
	3	```
	4	apt install ansible ansible-mitogen
	5	```
	6
83d6ed6c KS	7	# Required collections
	8
	9	```
fc7346bb	10	ansible-galaxy install -r roles/requirements.yml
83d6ed6c KS	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	```
d82e5cee KS	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