docs: Cleaned up the readme and master install
All checks were successful
Build Docker / Build Bot (push) Successful in 27s
Build Docker / Build Master (push) Successful in 28s

This commit is contained in:
Nathan Woodburn 2023-08-24 15:30:41 +10:00
parent 3a9f8a8844
commit 71a5dd8b45
Signed by: nathanwoodburn
GPG Key ID: 203B000478AD0EF1
2 changed files with 31 additions and 52 deletions

View File

@ -13,24 +13,41 @@ The bot will be used to provide an easier way to manage the master server.
## Usage
!TODO
After installing the master and discord bot you can use the following commands (as bot owner).
```
/addworker <ip> <name> | add a worker to the master server pool (Make sure the master can access port 5000 on the worker, and don't allow anyone else to access it)
/listworkers | list all workers
/licence | Creates a licence key (valid for 1 wp site)
```
General commands (as anyone)
```
/createsite <domain> <licence key> | Creates a wordpress site on a random worker server (uses up 1 licence key)
/siteinfo <domain> | Get info about a site (use after creating site to get TLSA and IP of the server)
```
## Master server install
Docker is the easiest way to install the master server.
```
```sh
docker run -d -p 5000:5000 -e LICENCE-API=your-api-key -e WORKER_KEY=your-api-key --name hnshosting-master git.woodburn.au/nathanwoodburn/hnshosting-master:latest -v ./data:/data
```
You can also mount a docker volume to /data to store the files instead of mounting a host directory.
Alternatively you can install it manually.
Set your .env file.
```
```sh
cd master
python3 -m pip install -r requirements.txt
python3 main.py
```
Then to start the master api server
```sh
screen -dmS hnshosting-master python3 main.py
```
@ -38,20 +55,26 @@ python3 main.py
Install prerequisites:
```
```sh
git clone https://git.woodburn.au/nathanwoodburn/hnshosting-wp.git
cd hnshosting-wp/worker
chmod +x install.sh
./install.sh
```
Then to start the worker api server
```sh
screen -dmS hnshosting-worker python3 main.py
```
Add worker to master server:
```
```sh
curl -X POST http://master-server-ip:5000/add-worker?worker=worker-name&ip=worker-server-ip -H "key: api-key"
```
## Discord bot install
Docker install
```
```sh
docker run -d -e MASTER_IP=<MASTER SERVER IP> -e DISCORD_TOKEN=<YOUR-BOT-TOKEN> -e LICENCE_KEY=your-api-key -e WORKER_KEY=your-api-key --name hnshosting-bot git.woodburn.au/nathanwoodburn/hnshosting-bot:latest
```

View File

@ -1,49 +1,5 @@
#!/bin/bash
# Initial install for all prerequisites for the project.
# Update the system
sudo apt update && sudo apt upgrade -y
# Install python prerequisites
python3 -m pip install -r requirements.txt
# Create a service to run the python web server
# Flask app directory and file
APP_DIR=$(pwd)
APP_FILE=main.py
# Name for your systemd service
SERVICE_NAME=HNSHosting-Main
# Create a user and group to run the service
SERVICE_USER=hnshosting
SERVICE_GROUP=hnshosting
sudo groupadd $SERVICE_GROUP
sudo useradd -g $SERVICE_GROUP $SERVICE_USER
# Create a systemd service unit file
echo "[Unit]
Description=HNSHosting Main Service
After=network.target
[Service]
User=$SERVICE_USER
Group=$SERVICE_GROUP
WorkingDirectory=$APP_DIR
ExecStart=/usr/bin/python3 $APP_DIR/$APP_FILE
Restart=always
[Install]
WantedBy=multi-user.target" | sudo tee /etc/systemd/system/$SERVICE_NAME.service
# Reload systemd to pick up the new unit file
sudo systemctl daemon-reload
# Enable and start the service
sudo systemctl enable $SERVICE_NAME
sudo systemctl start $SERVICE_NAME
echo "Service created and started."