librewolf
/
bunkerized-nginx
mirror of https://github.com/bunkerity/bunkerized-nginx
4
0
Fork 1
Code Issues Projects Releases Wiki Activity

docs - add ansible diagram

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 name: Feature request
about: Suggest an idea for this project about: Suggest an idea for this project
title: "[FEATURE]" title: "[FEATURE]"
labels: feature labels: enhancement
assignees: '' 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 ## Ansible
<figure markdown> <figure markdown>
![Overwiew](assets/img/integration-linux.svg){ align=center } ![Overwiew](assets/img/integration-ansible.svg){ align=center }
<figcaption>Linux integration</figcaption> <figcaption>Ansible integration</figcaption>
</figure> </figure>
List of supported Linux distros : List of supported Linux distros :
@ -889,36 +889,33 @@ List of supported Linux distros :
- Fedora 36 - Fedora 36
- CentOS Stream 8 - 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. [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: (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`
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] [remotehosts]
192.0.2.50 192.0.2.50
192.0.2.51 192.0.2.51
192.0.2.52 192.0.2.52
``` ```
The next step we're going to set up the SSH connections so Ansible can connect to the managed nodes. 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.
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`
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 ```yaml
--- ---
- hosts: all - hosts: all
become: true become: true
roles: roles:
- bunkerweb - bunkerweb
``` ```
Run the playbook: Run the playbook :
`ansible-playbook -i inventory.yml playbook.yml` `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/).