aboutsummaryrefslogtreecommitdiff
path: root/infrastructure/README.md
blob: 56ba48d8f059993755dcfc2e67c87bd2ac292d1c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# Infrastructure

## Using SSH

Add:

```
Include .../xn--ix-yja.es/infrastructure/ssh_config
```

to your `~/.ssh/config` before any `Host` statement.

## Bootstrapping

Ensure you can `ssh root@ñix.es`, and then:

```
uv run ansible-playbook -i ssh-root.yaml -i production.yaml site.yaml
```

You might need to `systemctl restart apache2` for the Let's Encrypt certificate.

## Running Ansible

After bootstrapping, you can run Ansible via ssh with your user and `sudo`.
After [setting your user password](roles/users/README.md):

```
uv run ansible-playbook -K -i production.yaml site.yaml
```

Or run from the same host with:

```
uv run ansible-playbook -K -i local-exec.yaml -i production.yaml site.yaml
```

## Roles

* The [users](roles/users) role to add new users
* The [git](roles/git) role to host Git repositories (https and Gitweb)
* The [vaultwarden](roles/vaultwarden) role for secret management

## Notes

### Contabo Debian 13

* `unattended-upgrades` configured by default