This repository has been archived on 2024-05-11. You can view files and clone it, but cannot push or open issues or pull requests.
eae-am-deutschen-platz/README.md

76 lines
2.8 KiB
Markdown
Raw Normal View History

2022-06-30 23:48:44 +00:00
# Freifunk Leipzig - Erstaufnahme Einrichtung - Am Deutschen Platz
This repo contains the config and documentation for our installation at the "Erstaufnahme Einrichtung - Am Deutschen Platz"
---
**more documentation / information will follow**
2022-06-30 23:48:44 +00:00
---
## Admin Guide
requirements:
* `ansible`
* `pandoc` (for offline documentation generation)
* `pass`
### Password Manager
2022-07-01 00:35:27 +00:00
1. import all gpg keys (only on first use or new admin - all keys need to be trusted - use `--edit-key` to edit the trust level):
```
user@freifunk-admin:~/ffl-eae-adp/files/gpg$ gpg --import *
gpg: key F937CB4882C16136: "hirnpfirsich@ffl-eae-adp-password" not changed
gpg: key 2438B8ADFDF45447: 1 signature not checked due to a missing key
gpg: key 2438B8ADFDF45447: "Alexander Böhm <alexander.boehm@malbolge.net>" not changed
gpg: Total number processed: 2
gpg: unchanged: 2
user@freifunk-admin:~/ffl-eae-adp/files/gpg$
```
2. source environment (on every new shell):
```
user@freifunk-admin:~/ffl-eae-adp$ . environment
```
3. use :)
2022-07-01 00:35:27 +00:00
```
user@freifunk-admin:~/ffl-eae-adp$ pass
Password Store
├── accesspoints
│   ├── ap-0b99
│   ├── ap-1a38
│   ├── ap-2bbf
│   ├── ap-8f39
[...]
user@freifunk-admin:~/ffl-eae-adp
```
### SSH
use `playbook_create_ssh_config.yml` to generate an `ssh_config` file that gets linked into your `ssh_config`.
optionally specify a jumphost (ie. `eae-adp-jump01`)
```
user@freifunk-admin:~/ffl-eae-adp$ ansible-playbook -e jumphost=eae-adp-jump01 playbook_create_ssh_config.yml
PLAY [generate ssh_config] ******************************************************************************************************************************************************************************************************
TASK [generate ssh_config file] *************************************************************************************************************************************************************************************************
changed: [localhost]
TASK [include custom ssh_config] ************************************************************************************************************************************************************************************************
ok: [localhost]
PLAY RECAP **********************************************************************************************************************************************************************************************************************
localhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
user@freifunk-admin:~/ffl-eae-adp$ ssh gw-core01 uptime
23:54:52 up 6:49, load average: 0.05, 0.01, 0.00
user@freifunk-admin:~/ffl-eae-adp$
```
2022-06-30 23:48:44 +00:00
## Links
2022-07-01 00:01:42 +00:00
* [Documentation](documentation/README.md)
* [Incidents](documentation/INCIDENTS.md)
2022-07-01 00:34:08 +00:00
* [TODO](documentation/TODO.md)