You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This repository currently contains our WIP state for the infrastructure code.
4
4
5
5
This is a replacement for the old [puppet repository](https://github.com/freifunk-berlin/puppet).
6
6
7
-
Keep in mind that we also use ansible to configure the BerlinBackBone, this is done in the [bbb-configs repository](https://github.com/freifunk-berlin/bbb-configs).
7
+
Keep in mind that we also use Ansible to configure the BerlinBackBone, this is done in the [bbb-configs repository](https://github.com/freifunk-berlin/bbb-configs).
8
8
9
9
The code is, where necessary, quite debian centric since that's the distribution we use in our infrastructure.
10
10
@@ -22,18 +22,17 @@ This repository currently manages these services:
22
22
23
23
## Requirements // How to use
24
24
25
-
- check out this repo and `cd` into it
25
+
- check out this repository and `cd` into it
26
26
- create a venv and activate it: `python -m venv venv && source venv/bin/activate`
27
27
- install the python dependencies: `pip install -r requirements.txt`
28
28
- install the external roles: `ansible-galaxy install -r requirements.yml`
29
29
- install the external collections: `ansible-galaxy collection install -r requirements.yml`
30
30
- Save the secret encryption password for ansible-vault under `./.vaultpass`
31
31
- For alternative methods look here: <https://docs.ansible.com/ansible/latest/user_guide/vault.html>
32
32
33
-
34
33
## Structure
35
34
36
-
We follow an adapted version of the [ansible alternative layout](https://docs.ansible.com/ansible/2.8/user_guide/playbooks_best_practices.html#alternative-directory-layout).
35
+
We follow an adapted version of the [Ansible alternative layout](https://docs.ansible.com/ansible/2.8/user_guide/playbooks_best_practices.html#alternative-directory-layout).
37
36
Where we put the inventory in an extra directory, but don't use different directories for the stages (Since we don't have any).
38
37
Also, the roles are divided into 2 directories, one for external ones, and one for our internal ones.
Copy file name to clipboardExpand all lines: Tutorials.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Tutorials
2
2
3
-
In this file, you will find some tutorials describing common workflows for using this repo. We generally assume, that all Hosts, that will be managed by this ansible repository run a recent minimal stable Debian version (at time of writing: Debian 11). Our custom roles do mostly rely on this.
3
+
In this file, you will find some tutorials describing common workflows for using this repository. We generally assume, that all Hosts, that will be managed by this Ansible repository run a recent minimal stable Debian version (at time of writing: Debian 11). Our custom roles do mostly rely on this.
4
4
5
5
## Prerequisites on to-be-provisioned machine
6
6
@@ -13,7 +13,7 @@ In this file, you will find some tutorials describing common workflows for using
We use ansible-vaultpass for storing secrets encrypted in this repository. For provisioning machines with this repository, you need a password in the `.vaultpass` files for decrypting the variables.
19
19
@@ -40,15 +40,15 @@ After that, you can start the first provision stage with `ansible-playbook play.
40
40
41
41
### 2. Provision machine for its actual purpose
42
42
43
-
After that, just run the rest of the playbooks for the given machine, accessing it with your own ssh login: `ansible-playbook play.yml --limit=testmachine`. Don't forget to add `--user testuser` if the name of your local user differs from the remote user.
43
+
After that, just run the rest of the playbooks for the given machine, accessing it with your own SSH login: `ansible-playbook play.yml --limit=testmachine`. Don't forget to add `--user testuser` if the name of your local user differs from the remote user.
44
44
45
45
## Provision a machine to buildbotworker
46
46
47
-
For adding your buildbotworker machine to this repo, we need to follow three steps. The machine does not need to be reachable from the internet. It will connect itself to the buildbot, so it only needs basic access to the internet.
47
+
For adding your buildbotworker machine to this repository, we need to follow three steps. The machine does not need to be reachable from the internet. It will connect itself to the buildbot, so it only needs basic access to the internet.
48
48
49
-
### Get your machine known to ansible
49
+
### Get your machine known to Ansible
50
50
51
-
To get your machine known to ansible, add it to the `hosts`-file at `inventory/hosts`.
51
+
To get your machine known to Ansible, add it to the `hosts`-file at `inventory/hosts`.
0 commit comments