Ansible configuration for the Netz39 infrastructure
Alexander Dahl
53fe6b4427
Prefer private mail address over company mail address.
Prefer netz39 mail address over private mail address.
Output of `git shortlog -es` diffed:
```diff
--- before 2025-02-26 12:29:28.323774025 +0100
+++ after 2025-02-26 12:30:29.355141593 +0100
@@ -1,11 +1,8 @@
99 Alexander Dahl <alex@netz39.de>
284 David Kilias <dkdent@netz39.de>
- 2 Jens Winter-Hübenthal <jens.winter-huebenthal@bridgefield.de>
- 1 JensWH <jens.winter@gmail.com>
- 1 MG-95 <mg-95@gitea.n39.eu>
+ 3 Jens Winter-Hübenthal <jens.winter@gmail.com>
4 Maximilian Deubel <maximilian.deubel@gmail.com>
- 5 Maximilian Grau <mg-95@t-online.de>
+ 6 Maximilian Grau <mg-95@t-online.de>
259 Renovate Bot <accounts+renovatebot@netz39.de>
670 Stefan Haun <tux@netz39.de>
- 1 timo <n39@therr.de>
- 1 timo <timo@netz39.de>
+ 2 timo <timo@netz39.de>
```
|
||
|---|---|---|
| files | ||
| group_vars | ||
| host_vars | ||
| roles | ||
| templates | ||
| .editorconfig | ||
| .gitignore | ||
| .mailmap | ||
| .yamllint | ||
| ansible.cfg | ||
| configure-grafana.yml | ||
| group-all.yml | ||
| group-docker_host.yml | ||
| group-k3s.yml | ||
| group-proxmox.yml | ||
| host-beaker.yml | ||
| host-hobbes.yml | ||
| host-holmium.yml | ||
| host-krypton.yml | ||
| host-oganesson.yml | ||
| host-platon.yml | ||
| host-plumbum.yml | ||
| host-pottwal.yml | ||
| host-radon.yml | ||
| host-tau.yml | ||
| host-unicorn.yml | ||
| host-wittgenstein.yml | ||
| inventory.yml | ||
| main.yml | ||
| README.md | ||
| renovate.json | ||
| requirements.yml | ||
| setup-ssh.yml | ||
Ansible configuration for the Netz39 infrastructure
This call lists all hosts defined in the inventory:
ansible all --list-hosts
Setup
ansible-galaxy install -r requirements.yml
Setup SSH Access to hosts
LOGUSER=<loguser>
SSH_KEY=<absolute/path/to/ssh/private/key>
ansible-playbook setup-ssh.yml --ask-vault-pass -e "setup_ssh_logname=$LOGUSER" -e "setup_ssh_key=$SSH_KEY"
This playbook also adds rhodium.n39.eu (OpenWRT router), but our Ansible cannot set up SSH keys (yet).
Please add your key to OpenWRT manually.
Edit vault encrypted vars files
ansible-vault edit group_vars/all/vault
Call with
ansible-playbook --ask-vault-pass main.yml
You need to provide a user with sudo rights and the vault password.
Verify Changes
ansible-lint main.yml
ansible-playbook --ask-vault-pass main.yml --check --diff
HTTPS ingress configuration
HTTPS ingress is controlled by the server holmium and forwarded to the configured servers.
To set up a new HTTPS vhost, the following steps need to be taken:
- Select a domain (for internal services we use sub-domains of
.n39.eu). - Create an external CNAME from this domain to
dyndns.n39.eu. - Create an internal DNS entry in the Descartes DNS config. This is usually an alias on an existing server.
- Add the entry to the holmium playbook.
- Set up Dehydrated and vhost on the target host, e.g. using
setup_http_site_proxy.
Do not forget to execute all playbooks with relevant changes.