more automated upgrades

This commit is contained in:
Ariel Rin
2023-10-27 22:19:28 +10:00
parent ffb526ab0c
commit 906c589f14
28 changed files with 96 additions and 133 deletions

View File

@@ -4,7 +4,7 @@
## Supported Services
```{toctree}
:::{toctree}
:maxdepth: 1
discord
@@ -15,13 +15,13 @@ phpbb3
smf
teamspeak3
xenforo
```
:::
## Tools
```{toctree}
:::{toctree}
:maxdepth: 1
nameformats
permissions
```
:::

View File

@@ -6,11 +6,9 @@ Mumble is a free voice chat server. While not as flashy as TeamSpeak, it has all
Note that this guide assumes that you have installed Auth with the official :doc:`/installation/allianceauth` guide under ``/home/allianceserver`` and that it is called ``myauth``. Accordingly it assumes that you have a service user called ``allianceserver`` that is used to run all Auth services under supervisor.
```
```{eval-rst}
.. warning::
:::{warning}
This guide is currently for Ubuntu only.
```
:::
## Installations
### Installing Mumble Server

View File

@@ -70,12 +70,10 @@ Some examples of strings you could use:
+------------------------------------------+---------------------------+
```
```{eval-rst}
.. important::
:::{important}
For most services, name formats only take effect when a user creates an account. This means if you create or update a name formatter it wont retroactively alter the format of users names. There are some exceptions to this where the service updates nicknames on a periodic basis. Check the service's documentation to see which of these apply.
```
:::
```{eval-rst}
.. important::
:::{important}
You must only create one formatter per service per state. E.g. don't create two formatters for Mumble for the Member state. In this case one of the formatters will be used and it may not be the formatter you are expecting.
```
:::

View File

@@ -6,10 +6,9 @@ In the past, access to services was dictated by a list of settings in `settings.
Instead of granting access to services by the previous rigid structure, access to services is now granted by the built in Django permissions system. This means that service access can be more granular, allowing only certain states, certain groups, for instance Corp CEOs, or even individual user access to each enabled service.
```{eval-rst}
.. important::
:::{important}
If you grant access to an individual user, they will have access to that service regardless of whether or not they are a member.
```
:::
Each service has an access permission defined, named like `Can access the <service name> service`.
@@ -19,10 +18,9 @@ A user can be granted the same permission from multiple sources. e.g. they may h
## Removing access
```{eval-rst}
.. danger::
:::{danger}
Access removal is processed immediately after removing a permission from a user or group. If you remove access from a large group, such as Member, it will immediately remove all users from that service.
```
:::
When you remove a service permission from a user, a signal is triggered which will activate an immediate permission check. For users this will trigger an access check for all services. For groups, due to the potential extra load, only the services whose permissions have changed will be verified, and only the users in that group.

View File

@@ -48,18 +48,18 @@ unzip smf_2-1-2_install.zip
Now we need to move this to our web directory. Usually `/var/www/forums`.
```shell
mv smf /var/www/forums
````
```
The web server needs read/write permission to this folder
Apache: `chown -R www-data:www-data /var/www/forums`
Nginx: `chown -R nginx:nginx /var/www/forums`
```{eval-rst}
.. tip::
:::{tip}
Nginx: Some distributions use the ``www-data:www-data`` user:group instead of ``nginx:nginx``. If you run into problems with permissions try it instead.
..
```
:::
### Database Preparation