chore(dblab): engine commands and quick notes

This commit is contained in:
Michele Cereda
2024-09-09 18:40:42 +02:00
parent e1bbc259e2
commit 7b598d5b59
3 changed files with 28 additions and 1 deletions

View File

@@ -6,10 +6,29 @@ Use cases of the clones are to test database migrations, optimize SQL, or deploy
The website <https://Postgres.ai/> hosts the SaaS version of the Database Lab Engine. The website <https://Postgres.ai/> hosts the SaaS version of the Database Lab Engine.
Configuration file examples are available at <https://gitlab.com/postgres-ai/database-lab/-/tree/v3.0.0/configs>.
1. [Engine](#engine)
1. [Clones](#clones) 1. [Clones](#clones)
1. [Further readings](#further-readings) 1. [Further readings](#further-readings)
1. [Sources](#sources) 1. [Sources](#sources)
## Engine
Config file in YAML format, at `~/.dblab/engine/configs/server.yml` by default.
Metadata files at `~/.dblab/engine/meta` by default. The metadata folder **must be writable**.
```sh
# Reload the configuration without downtime.
docker exec -it 'dblab_server' kill -SIGHUP 1
# Follow logs.
docker logs --since '1m' -f 'dblab_server'
docker logs --since '2024-05-01' -f 'dblab_server'
docker logs --since '2024-08-01T23:11:35' -f 'dblab_server'
```
## Clones ## Clones
Database clones comes in two flavours: Database clones comes in two flavours:
@@ -45,6 +64,8 @@ Database clones comes in two flavours:
### Sources ### Sources
- [Database Lab Engine configuration reference]
<!-- <!--
Reference Reference
═╬═Time══ ═╬═Time══
@@ -56,6 +77,7 @@ Database clones comes in two flavours:
<!-- Files --> <!-- Files -->
<!-- Upstream --> <!-- Upstream -->
[database lab engine configuration reference]: https://postgres.ai/docs/reference-guides/database-lab-engine-configuration-reference
[documentation]: https://postgres.ai/docs/ [documentation]: https://postgres.ai/docs/
[main repository]: https://gitlab.com/postgres-ai/database-lab [main repository]: https://gitlab.com/postgres-ai/database-lab
[website]: https://postgres.ai/ [website]: https://postgres.ai/

View File

@@ -104,7 +104,10 @@ docker exec 'app_web_1' tail 'logs/development.log'
docker exec -ti 'alpine-test' 'sh' docker exec -ti 'alpine-test' 'sh'
# Show containers' output. # Show containers' output.
docker log 'alpine-test' docker logs -f 'alpine-test'
docker logs --since '1m' 'dblab_server' --details
docker logs --since '2024-05-01' -n '100' 'mariadb'
docker logs --since '2024-08-01T23:11:35' --until '2024-08-05T20:43:35' 'gitlab'
# List processes running inside containers. # List processes running inside containers.
docker top 'alpine-test' docker top 'alpine-test'

View File

@@ -10,6 +10,8 @@ sudo vim '/var/lib/docker/volumes/website/_data/index.html'
docker run -d --name 'some-nginx' -v '/some/content:/usr/share/nginx/html:ro' 'nginx' docker run -d --name 'some-nginx' -v '/some/content:/usr/share/nginx/html:ro' 'nginx'
docker logs --since '5m' -f 'dblab_server' docker logs --since '5m' -f 'dblab_server'
docker logs --since '2024-09-07' 'dblab_server'
docker logs --since '2024-09-09T09:05:00' --until '2024-09-09T10:05:00' 'dblab_server'
docker login docker login
docker login -u 'whatever' -p 'glpat-ABC012def345GhI678jKl' 'gitlab.example.org:5050' docker login -u 'whatever' -p 'glpat-ABC012def345GhI678jKl' 'gitlab.example.org:5050'