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.
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. [Further readings](#further-readings)
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
Database clones comes in two flavours:
@@ -45,6 +64,8 @@ Database clones comes in two flavours:
### Sources
- [Database Lab Engine configuration reference]
<!--
Reference
═╬═Time══
@@ -56,6 +77,7 @@ Database clones comes in two flavours:
<!-- Files -->
<!-- Upstream -->
[database lab engine configuration reference]: https://postgres.ai/docs/reference-guides/database-lab-engine-configuration-reference
[documentation]: https://postgres.ai/docs/
[main repository]: https://gitlab.com/postgres-ai/database-lab
[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'
# 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.
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 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 -u 'whatever' -p 'glpat-ABC012def345GhI678jKl' 'gitlab.example.org:5050'