From 7b598d5b5956aaa8d4a7744471dad84543779a2f Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Mon, 9 Sep 2024 18:40:42 +0200
Subject: [PATCH] chore(dblab): engine commands and quick notes

---
 knowledge base/database lab.md | 22 ++++++++++++++++++++++
 knowledge base/docker.md       |  5 ++++-
 snippets/docker.sh             |  2 ++
 3 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/knowledge base/database lab.md b/knowledge base/database lab.md
index af3c5df..a06d1e4 100644
--- a/knowledge base/database lab.md	
+++ b/knowledge base/database lab.md	
@@ -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/
diff --git a/knowledge base/docker.md b/knowledge base/docker.md
index f32ba14..51b51e3 100644
--- a/knowledge base/docker.md	
+++ b/knowledge base/docker.md	
@@ -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'
diff --git a/snippets/docker.sh b/snippets/docker.sh
index 0f66d9d..9ed2477 100644
--- a/snippets/docker.sh
+++ b/snippets/docker.sh
@@ -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'