This repository has been archived on 2023-05-27. You can view files and clone it, but cannot push or open issues or pull requests.
BirdsiteLIVE/BSLManager.md
2021-05-28 23:31:02 -04:00

2.1 KiB

BSLManager

A CLI is provided in the Docker image so that admins can manage their instance.

Access to the CLI

Since the CLI is packaged into the docker image, you'll have to open a shell from the container. To do so, list first your running containers:

docker ps

This should display you something equivalent to this:

CONTAINER ID   IMAGE                               COMMAND                  CREATED       STATUS       PORTS                           NAMES
3734c41af5a7   postgres:9.6                        "docker-entrypoint.s…"   2 weeks ago   Up 2 weeks   5432/tcp                        db_1
be6870fe103e   nicolasconstant/birdsitelive:latest "dotnet BirdsiteLive…"   6 weeks ago   Up 2 weeks   443/tcp, 0.0.0.0:5000->80/tcp   birdsitelive

Find the BSL container and keep the ID, here it's be6870fe103e. And you only need the three first char to identify it, so we'll be using be6.

Then open a shell inside the container (change be6 with your own id):

docker exec -it be6 /bin/bash

And you should now be inside the container, and all you have to do is calling the CLI:

./BSLManager

Setting up the CLI

The manager will ask you to provide information about the database and the instance. Those must be same than the ones in the docker-compose.yml file. Provide the information, review it and validate it. Then the CLI UI should shows up.

Using the CLI

You can navigate between the sections with the arrows and tab keys.

The filter permits to filter the list of users with a pattern.

All users have their followings count provided next to them. You can select any user by using the up/down arrow keys and hitting the Enter key, this will display more information about the user. You can also remove a user and all their followings by hitting the Del key. You will be prompted by a confirmation message, and you'll be able to remove this user.

Deleting users having a lots of followings can take some time: after the prompt has closed the process is still running and will update the list after that. Let the software do its thing and it will go through.