103 lines
2.7 KiB
Markdown
103 lines
2.7 KiB
Markdown
# Account.exs
|
|
|
|
Simple script to create an account for AzerothCore
|
|
|
|
This script allows a server admin to create a user automatically when after the `dbimport` tool runs, without needed to open up the `worldserver` console.
|
|
|
|
## How To Use
|
|
|
|
### Pre-requisites
|
|
|
|
- MySQL is running
|
|
- The authserver database (`acore_auth`, typically) has a table named `account`
|
|
|
|
### Running
|
|
|
|
```bash
|
|
$ elixir account.exs
|
|
```
|
|
|
|
### Configuration
|
|
|
|
This script reads from environment variables in order to control which account it creates and the MySQL server it's communicating with
|
|
|
|
|
|
- `ACORE_USERNAME` Username for account, default "admin"
|
|
- `ACORE_PASSWORD` Password for account, default "admin"
|
|
- `ACORE_GM_LEVEL` GM Level for account, default 3
|
|
- `MYSQL_DATABASE` Database name, default "acore_auth"
|
|
- `MYSQL_USERNAME` MySQL username, default "root"
|
|
- `MYSQL_PASSWORD` MySQL password, default "password"
|
|
- `MYSQL_PORT` MySQL Port, default 3306
|
|
- `MYSQL_HOST` MySQL Host, default "localhost"
|
|
|
|
To use these environment variables, execute the script like so:
|
|
|
|
```bash
|
|
$ MYSQL_HOST=mysql \
|
|
MYSQL_PASSWORD="fourthehoard" \
|
|
ACORE_USERNAME=drekthar \
|
|
ACORE_PASSWORD=securepass22 \
|
|
elixir account.exs
|
|
```
|
|
|
|
This can also be used in a loop. Consider this csv file:
|
|
|
|
```csv
|
|
user,pass,gm_level
|
|
admin,adminpass,2
|
|
soapuser,soappass,3
|
|
mainuser,userpass,0
|
|
```
|
|
|
|
You can then loop over this csv file, and manage users like so:
|
|
|
|
```bash
|
|
$ while IFS=, read -r user pass gm; do
|
|
ACORE_USERNAME=$user \
|
|
ACORE_PASSWORD=$pass \
|
|
GM_LEVEL=$gm \
|
|
elixir account.exs
|
|
done <<< $(tail -n '+2' users.csv)
|
|
```
|
|
|
|
### Docker
|
|
|
|
Running and building with docker is simple:
|
|
|
|
```bash
|
|
$ docker build -t acore/account-create .
|
|
$ docker run \
|
|
-e MYSQL_HOST=mysql \
|
|
-v mix_cache:/root/.cache/mix/installs \
|
|
acore/account-create
|
|
```
|
|
|
|
Note that the `MYSQL_HOST` is required to be set with the docker container, as the default setting targets `localhost`.
|
|
|
|
### docker-compose
|
|
|
|
A simple way to integrate this into a docker-compose file.
|
|
|
|
This is why I wrote this script - an automatic way to have an admin account idempotently created on startup of the server.
|
|
|
|
```yaml
|
|
services:
|
|
account-create:
|
|
image: acore/account-create:${DOCKER_IMAGE_TAG:-master}
|
|
build:
|
|
context: apps/account-create/
|
|
dockerfile: apps/account-create/Dockerfile
|
|
environment:
|
|
MYSQL_HOST: ac-database
|
|
MYSQL_PASSWORD: ${DOCKER_DB_ROOT_PASSWORD:-password}
|
|
ACORE_USERNAME: ${ACORE_ROOT_ADMIN_ACCOUNT:-admin}
|
|
ACORE_PASSWORD: ${ACORE_ROOT_ADMIN_PASSWORD:-password}
|
|
volumes:
|
|
- mix_cache:/root/.cache/mix/installs
|
|
profiles: [local, app, db-import-local]
|
|
depends_on:
|
|
ac-db-import:
|
|
condition: service_completed_successfully
|
|
```
|