librewolf/bunkerized-nginx
4
0
Fork 1
mirror of https://github.com/bunkerity/bunkerized-nginx synced 2023-12-13 21:30:18 +01:00
Code Issues Projects Releases Wiki Activity

docs - add ansible diagram

Browse source
This commit is contained in:
florian 2022-07-11 07:51:56 +02:00
parent 8d6397a6ba
commit 658ab75049
No known key found for this signature in database
GPG key ID: 3D80806F12602A7C
4 changed files with 19 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.github/ISSUE_TEMPLATE/feature_request.md vendored
View file

@ -2,7 +2,7 @@
name: Feature request
about: Suggest an idea for this project
title: "[FEATURE]"
labels: feature
labels: enhancement
assignees: ''
---

4
docs/assets/img/integration-ansible.svg Normal file
View file

File diff suppressed because one or more lines are too long
Side by side

After

Width:  |  Height:  |  Size: 283 KiB

1
docs/diagrams/integration-ansible.drawio Normal file
View file

File diff suppressed because one or more lines are too long

29
docs/integrations.md
View file

@ -878,8 +878,8 @@ BunkerWeb is managed using systemctl :
## Ansible
<figure markdown>
![Overwiew](assets/img/integration-linux.svg){ align=center }
<figcaption>Linux integration</figcaption>
![Overwiew](assets/img/integration-ansible.svg){ align=center }
<figcaption>Ansible integration</figcaption>
</figure>
List of supported Linux distros :
@ -889,36 +889,33 @@ List of supported Linux distros :
- Fedora 36
- CentOS Stream 8
Ansible is an IT automation tool working with python. Ansible work with ssh to connect to remote server, so make sure to have a ssh key. The role will deploy bunkerweb on your remote server.
First of all download the role from ansible-galaxy: (TODO)
Next create an inventory by adding the IP adress or FQDN of one or more remote systems, either in `/etc/ansible/hosts` or in your own playbook `inventory.yml`
[Ansible](https://docs.ansible.com/ansible/latest/index.html) is an IT automation tool working with python. Ansible work with ssh to connect to remote server, so make sure to have a ssh key. The role will deploy and configure BunkerWeb on your remote server(s).
First of all download the role from ansible-galaxy :
```shell
ansible-galaxy install bunkerity.bunkerweb
```
Next create an inventory by adding the IP adress or FQDN of one or more remote systems, either in `/etc/ansible/hosts` or in your own playbook `inventory.yml` :
```toml
[remotehosts]
192.0.2.50
192.0.2.51
192.0.2.52
```
The next step we're going to set up the SSH connections so Ansible can connect to the managed nodes.
Firstly: Add your public SSH keys to the `authorized_keys` file on each remote system
Secondly:
Test the SSH connections:
`ssh username@192.0.2.50`
The next step we're going to set up is the SSH connection so Ansible can connect to the managed nodes. Add your public SSH keys to the `authorized_keys` file on each remote system and ensure you can't successfully connect.
In order to use the role, we will create the playbook file named `playbook.yml` for example:
In order to use the role, we will create the playbook file named `playbook.yml` for example :
```yaml
---
- hosts: all
become: true
roles:
- bunkerweb
```
Run the playbook:
Run the playbook :
`ansible-playbook -i inventory.yml playbook.yml`
The configurations by default for Bunkerweb are minimals, so check out the rest of the documentations to configure Bunkerweb as you desire [quickstart-guide](http://localhost:8000/quickstart-guide/).
The configurations by default for Bunkerweb are minimals, so check out the rest of the documentations to configure BunkerWeb as you desire [quickstart-guide](http://localhost:8000/quickstart-guide/).