76 lines
2.8 KiB
Markdown
76 lines
2.8 KiB
Markdown
# 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**
|
|
|
|
---
|
|
|
|
## Admin Guide
|
|
|
|
requirements:
|
|
* `ansible`
|
|
* `pandoc` (for offline documentation generation)
|
|
* `pass`
|
|
|
|
### Password Manager
|
|
|
|
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 :)
|
|
```
|
|
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$
|
|
```
|
|
|
|
## Links
|
|
|
|
* [Documentation](documentation/README.md)
|
|
* [Incidents](documentation/INCIDENTS.md)
|
|
* [TODO](documentation/TODO.md)
|