update deployment README

pull/20/head
JensDiemer 2020-11-14 09:55:36 +01:00
rodzic 75435b9ca0
commit 52faab70d6
1 zmienionych plików z 20 dodań i 20 usunięć

Wyświetl plik

@ -1,22 +1,22 @@
= PyInventory - deployment branch = PyInventory - deployment instruction
Web based management to catalog things including state and location etc. using Python/Django. Web based management to catalog things including state and location etc. using Python/Django.
**Note:** **Note:**
* This README (in git **deployment** branch) contains only the instruction to install PyInventory on a root server. * This README contains only the instruction to install PyInventory on a root server.
* Read [[https://github.com/jedie/PyInventory/tree/master#readme|master README]] for local develompment installation. * Read [[https://github.com/jedie/PyInventory/tree/master#readme|the main README]] for local development installation.
Pull requests welcome! Pull requests welcome!
== git branches == Project structure
Currently we have two main branches: There are two main directories:
|= git branch |= description |= directory |= description
| **[[https://github.com/jedie/PyInventory/tree/master|master]]** | The main PyInventory source code | **[[https://github.com/jedie/PyInventory/tree/master/src|/src/]]** | The main PyInventory source code
| **[[https://github.com/jedie/PyInventory/tree/deployment|deployment]]** | separate project to deploy PyInventory for production use case | **[[https://github.com/jedie/PyInventory/tree/master/deployment|/deployment/]]** | deploy PyInventory for production use case
== deploy == deploy
@ -96,11 +96,11 @@ install some base packages, e.g.:
{{{ {{{
# Checkout the deployment branch: # Checkout the deployment branch:
~$ git clone -b deployment https://github.com/jedie/PyInventory.git PyInventory-Deployment ~$ git clone https://github.com/jedie/PyInventory.git
~$ cd PyInventory-Deployment ~$ cd PyInventory/deployment/
# Theses Makefile targets exists: # Theses Makefile targets exists:
~/PyInventory-Deployment$ make ~/PyInventory/deployment$ make
help List all commands help List all commands
install-poetry install or update poetry install-poetry install or update poetry
install install requirements to setup project install install requirements to setup project
@ -132,21 +132,21 @@ Install, e.g.:
{{{ {{{
# install or update poetry: # install or update poetry:
~/PyInventory-Deployment$ make install-poetry ~/PyInventory/deployment$ make install-poetry
}}} }}}
To keep poetry running (PATH must be expand) just logout and login ;) To keep poetry running (PATH must be expand) just logout and login ;)
{{{ {{{
# install requirements (e.g.: docker-compose) via poetry: # install requirements (e.g.: docker-compose) via poetry:
~/PyInventory-Deployment$ make install ~/PyInventory/deployment$ make install
}}} }}}
Create a {{{.env}}} file in project root directory with these content, e.g.: Create a {{{.env}}} file in project root directory with these content, e.g.:
{{{ {{{
~/PyInventory-Deployment$ touch .env ~/PyInventory/deployment$ touch .env
~/PyInventory-Deployment$ nano .env ~/PyInventory/deployment$ nano .env
~/PyInventory-Deployment$ cat .env ~/PyInventory/deployment$ cat .env
# Your Public domain: # Your Public domain:
HOSTNAME=domain.tld HOSTNAME=domain.tld
@ -163,14 +163,14 @@ LETSENCRYPT_EMAIL=internal
Start containers via docker-compose: Start containers via docker-compose:
{{{ {{{
~/PyInventory-Deployment$ make up ~/PyInventory/deployment$ make up
}}} }}}
Notes: At the first start it takes a little while until the database is created ;) Notes: At the first start it takes a little while until the database is created ;)
Create first super user: Create first super user:
{{{ {{{
~/PyInventory-Deployment$ make docker_createsuperuser ~/PyInventory/deployment$ make docker_createsuperuser
}}} }}}
* Now you should be able to connect to your PyInventory installation and login with created super user. * Now you should be able to connect to your PyInventory installation and login with created super user.
@ -185,12 +185,12 @@ TO keep everything up-to-date do the following steps:
Update the OS call: Update the OS call:
{{{ {{{
~/PyInventory-Deployment$ sudo ./scripts/apt-distupgrade.sh ~/PyInventory/deployment$ sudo ./scripts/apt-distupgrade.sh
}}} }}}
Update PyInventory installation and docker containers: Update PyInventory installation and docker containers:
{{{ {{{
~/PyInventory-Deployment$ make update ~/PyInventory/deployment$ make update
}}} }}}
This will do: This will do: