From 9ff38891ad7c4ea5b7c6ee67d064837bb05ecff4 Mon Sep 17 00:00:00 2001 From: writinwaters <93570324+writinwaters@users.noreply.github.com> Date: Sun, 31 Mar 2024 17:51:14 +0800 Subject: [PATCH] 0331 configurations (#177) * Updated configurations * Update README.md --- README.md | 51 +++++++++++++++++++++++++++++++-------------------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index fc3af1e..bbc9e75 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,8 @@ - CPU >= 2 cores - RAM >= 8 GB -- Docker: If you have not installed Docker on your local machine (Windows, Mac, or Linux), see [Install Docker Engine](https://docs.docker.com/engine/install/). +- Docker + > If you have not installed Docker on your local machine (Windows, Mac, or Linux), see [Install Docker Engine](https://docs.docker.com/engine/install/). ### Start up the server @@ -102,35 +103,45 @@ ``` *The following output confirms a successful launch of the system:* -```bash - ____ ______ __ - / __ \ ____ _ ____ _ / ____// /____ _ __ - / /_/ // __ `// __ `// /_ / // __ \| | /| / / - / _, _// /_/ // /_/ // __/ / // /_/ /| |/ |/ / -/_/ |_| \__,_/ \__, //_/ /_/ \____/ |__/|__/ - /____/ - - * Running on all addresses (0.0.0.0) - * Running on http://127.0.0.1:9380 - * Running on http://172.22.0.5:9380 -INFO:werkzeug:Press CTRL+C to quit -``` + ```bash + ____ ______ __ + / __ \ ____ _ ____ _ / ____// /____ _ __ + / /_/ // __ `// __ `// /_ / // __ \| | /| / / + / _, _// /_/ // /_/ // __/ / // /_/ /| |/ |/ / + /_/ |_| \__,_/ \__, //_/ /_/ \____/ |__/|__/ + /____/ + + * Running on all addresses (0.0.0.0) + * Running on http://127.0.0.1:9380 + * Running on http://172.22.0.5:9380 + INFO:werkzeug:Press CTRL+C to quit + ``` 5. In your web browser, enter the IP address of your server as prompted. + *The show is on!* ## 🔧 Configurations -> The default serving port is 80, if you want to change that, refer to the [docker-compose.yml](./docker-compose.yaml) and change the left part of `80:80`, say `66:80`. +When it comes to system configurations, you will need to manage the following files: + +- [.env](./docker/.env): Keeps the fundamental setups for the system, such as `SVR_HTTP_PORT`, `MYSQL_PASSWORD`, and `MINIO_PASSWORD`. +- [service_conf.yaml](./docker/service_conf.yaml): Configures the back-end services. +- [docker-compose.yml](./docker-compose.yaml): The system relies on [docker-compose.yml](./docker-compose.yaml) to start up. + + +You must ensure that changes in [.env](./docker/.env) are in line with what are in the [service_conf.yaml](./docker/service_conf.yaml) file. -If you need to change the default setting of the system when you deploy it. There several ways to configure it. -Please refer to this [README](./docker/README.md) to manually update the configuration. -Updates to system configurations require a system reboot to take effect *docker-compose up -d* again. +> The [./docker/README](./docker/README.md) file provides a detailed description of the environment settings and service configurations, and it is IMPORTANT to ensure that all environment settings listed in the [./docker/README](./docker/README.md) file should be aligned with the corresponding settings in the [service_conf.yaml](./docker/service_conf.yaml) file. -> If you want to change the basic setups, like port, password .etc., please refer to [.env](./docker/.env) before starting up the system. +To change the default serving port (80), go to [docker-compose.yml](./docker-compose.yaml) and change `80:80` to `<YOUR_SERVING_PORT>:80`. -> If you change anything in [.env](./docker/.env), please check [service_conf.yaml](./docker/service_conf.yaml) which is a configuration of the back-end service and should be consistent with [.env](./docker/.env). +> Updates to all system configurations require a system reboot to take effect: +> +> ```bash +> $ docker-compose up -d +> ``` ## 🛠️ Build from source -- GitLab