Introduction

AccountManager is a .net core 8 web application designed to run on docker for portability. It allows users to go to a web site and create accounts that can be used to log into an AnyMMO network server.

Project Organization

The project has 2 main parts: a dockerfile, and a folder that contains the .net core 8 web app,

Requirements

1. A MySQL database. The schema must already be created and the user account created with appropriate permissions assigned to the schema.

2. Docker. Ensure the docker daemon or service is running.

Application Setup

To install or run the application, the database must be configured. Running the entity framework migration tool as described below will create and configure the database tables.

Add database connection string to appsettings

Copy appsettings.json to appsettings.Development.json and add a connection string, using the proper values for your database.

Note: do not use localhost for the database server hostname. If you do, the docker based web site will assume the database is running in the same container and fail to connect.

"ConnectionStrings": {
    "Db": "server=mysql.yourdomain.com;database=your_database_name;user=your_database_user_name;password=your_database_password"
  },

Update database tables

In Visual Studio, right click the solution name in the solution explorer and choose Open In Terminal

dotnet tool install --global dotnet-ef --version 8.*

Replace the word Initial with a database commit message

dotnet ef migrations add Initial

Look at the new file in the Migrations folder in visual studio and check the code that will be run. If it looks good, then run the update.

dotnet ef database update

Docker Setup

Build the image

docker build -t anymmo-webserver .

Run the container

docker run -p 8080:8080 anymmo-webserver

Or as a daemon

docker run -d -p 8080:8080 anymmo-webserver

Nginx Setup

If you are running the service locally, you will need to run the nginx container with the self signed certificate, as Unity will not allow insecure (http) connections by default.

Build the image

docker build -t anymmo-nginx anymmo-nginx

Run both the webserver and the nginx containers at the same time

docker-compose up

or as a daemon

docker-compose up -d