improve uat docs
parent
8abdefd403
commit
687fba8a91
|
@ -2,30 +2,59 @@
|
||||||
|
|
||||||
Hostname: `uat.api.retropilot.org`
|
Hostname: `uat.api.retropilot.org`
|
||||||
|
|
||||||
## Usage
|
## Setup
|
||||||
|
|
||||||
### Environment
|
This setup assumes you have `docker` and `docker-compose` installed on your machine, and that you have added the
|
||||||
|
relevant users to the `docker` group.
|
||||||
|
|
||||||
Copy `.env.sample` to `.env` and edit as needed.
|
```sh
|
||||||
|
# install docker and setup systemd to start it on boot
|
||||||
|
sudo yum install docker-ce docker-ce-cli containerd.io
|
||||||
|
sudo systemctl start docker
|
||||||
|
sudo systemctl enable docker
|
||||||
|
|
||||||
```
|
# add $USER to the docker group
|
||||||
cp .env.sample .env
|
sudo usermod -aG docker $USER
|
||||||
```
|
```
|
||||||
|
|
||||||
### Deployment
|
Clone the Git repo to `/data/retropilot-server`. We can clone it using the `--shared` argument to allow multiple users
|
||||||
|
to read/write these files (taking advantage of the Linux `sgid` permissions bit).
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# create /data directory and relax permissions to let a non-root user write to it
|
||||||
|
sudo mkdir /data
|
||||||
|
sudo chmod a+w /data
|
||||||
|
|
||||||
|
# clone the repository
|
||||||
|
cd /data
|
||||||
|
git clone https://github.com/RetroPilot/retropilot-server.git --shared --branch uat
|
||||||
|
|
||||||
|
# allow any user in the 'docker' group to read/write the files in this directory
|
||||||
|
sudo chgrp -R docker retropilot-server
|
||||||
|
|
||||||
|
# tighten /data permissions again so that not non-root users cannot write to it
|
||||||
|
sudo chmod a-w /data
|
||||||
|
```
|
||||||
|
|
||||||
|
## Deployment
|
||||||
|
|
||||||
|
Make sure to create and modify the `.env` file as required for your environment.
|
||||||
|
|
||||||
Note that the first time you run the PostgreSQL container it will have to initialise.
|
Note that the first time you run the PostgreSQL container it will have to initialise.
|
||||||
The server and worker cannot interact with it before this happens.
|
The server and worker cannot interact with it before this happens.
|
||||||
|
|
||||||
Before first run:
|
Before first run (in `/data/retropilot-server`):
|
||||||
```
|
```sh
|
||||||
cd environment/uat
|
cd environment/uat
|
||||||
|
|
||||||
# Create the database
|
# copy and modify the `.env` file as required
|
||||||
|
cp .env.sample .env
|
||||||
|
|
||||||
|
# create the database
|
||||||
docker-compose up db
|
docker-compose up db
|
||||||
# CTRL-C when "database system is ready to accept connections" message appears
|
# CTRL-C when "database system is ready to accept connections" message appears
|
||||||
|
|
||||||
# Allow the API program to initialise the database schema
|
# allow the API to initialise the database schema
|
||||||
docker-compose up db api
|
docker-compose up db api
|
||||||
# CTRL-C when "RetroPilot Server listening at" message appears
|
# CTRL-C when "RetroPilot Server listening at" message appears
|
||||||
```
|
```
|
||||||
|
|
Loading…
Reference in New Issue