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

@@ -6,10 +6,9 @@ The main benefit of this setup is that it runs all services and code in the nati
In addition all tools described in this guide are open source or free software.
```{eval-rst}
.. hint::
:::{hint}
This guide is meant for development purposes only and not for installing AA in a production environment. For production installation please see chapter **Installation**.
```
:::
## Overview
@@ -72,10 +71,8 @@ sudo apt-get install gettext
Next we need to install Python and related development tools.
```{eval-rst}
.. hint::
To check your system's Python 3 version you can enter: ``python3 --version``
```
:::{hint}
:::
:::{note}
Should your Ubuntu come with a newer version of Python we recommend to still setup your dev environment with the oldest Python 3 version currently supported by AA (e.g Python 3.8 at this time of writing) to ensure your apps are compatible with all current AA installations
@@ -179,10 +176,9 @@ Following this approach you can also setup additional AA projects, e.g. aa-dev-2
Create the root folder `aa-dev`.
```{eval-rst}
.. hint::
:::{hint}
The folders `venv` and `myauth` will be created automatically in later steps. Please do not create them manually as this would lead to errors.
```
:::
### Setup virtual Python environment for aa-dev
@@ -240,10 +236,9 @@ For the Eve Online related setup you need to create a SSO app on the developer s
Open your local Django settings with VSC. The file is under `myauth/myauth/settings/local.py`
```{eval-rst}
.. hint::
:::{hint}
There are two Django settings files: ``base.py`` and ``local.py``. The base settings file is controlled by the AA project and may change at any time. It is therefore recommended to only change the local settings file.
```
:::
```python
DEBUG = True
@@ -312,10 +307,9 @@ python manage.py runserver
Once running you can access your auth site on the browser under `http://localhost:8000`. Or the admin site under `http://localhost:8000/admin`
```{eval-rst}
.. hint::
:::{hint}
You can start your AA server directly from a terminal window in VSC or with a VSC debug config (see chapter about debugging for details).
```
:::
:::{note}
**Debug vs. Non-Debug mode**

View File

@@ -2,8 +2,8 @@
Here you find guides on how to setup your development environment for AA.
```{toctree}
:::{toctree}
:maxdepth: 1
aa-dev-setup-wsl-vsc-v2
```
:::