Merge pull request 'docker swarm' (#14) from feat/add-docker into main

Reviewed-on: #14

.vitepress/config.mts

@@ -76,6 +76,10 @@ export default defineConfig({
           { text: 'Local DB (PostgreSQL)', link: '/docker/local-db-pg' },
         ]
       },
+      {
+        text: 'Docker Swarm',
+        link: '/docker-swarm/',
+      },
       {
         text: 'EF Core',
         link: '/ef-core/',

docs/docker-swarm/index.md

@@ -0,0 +1,27 @@
+# Docker Swarm Snippets and Musings
+
+## Updating Services
+
+View services:
+
+```bash
+docker service ls
+```
+
+To scale a service up or down:
+
+```bash
+docker service scale <service_name>=<number_of_replicas>
+```
+
+Sometimes services get stuck or need to be forcefully updated:
+
+```bash
+docker service update --force <service_name>
+```
+
+::: tip
+
+Sometimes if you need to force containers to restart use the update force (e.g. after restarting a node).
+
+:::

docs/index.md

@@ -26,6 +26,10 @@ hero:
       text: Docker
       link: /docker/
 
+    - theme: alt
+      text: Docker Swarm
+      link: /docker-swarm/
+
     - theme: alt
       text: EF Core
       link: /ef-core/

docs/postgres/dump-and-restore.md

@@ -2,20 +2,38 @@
 
 Handy commands for dumping and restoring Postgres databases.
 
-:::info
+::: info
 Most of these commands are run using Docker as then we don't need to have Postgres installed locally.
 
 If a different version of Postgres is needed, just change the version number in the Docker image tag.
 :::
 
+## Setup 
+
+Create a pgpass file in the current directory with the following content:
+
+```
+<server>:<port>:<database>:<username>:<password>
+```
+
+::: tip
+Use `*` as a wildcard for any of the fields except for the password.
+:::
+
 ## Dumping a Database
 
 ```bash
-docker run --network host --rm -v .:/tmp -e PGPASSWORD=mysecretpassword postgres:16 pg_dump -h localhost -U myuser -d mydb -f /tmp/dump.sql
+docker run --network host --rm -v .:/tmp -v ./pgpass:/root/.pgpass -e PGPASSFILE=/root/.pgpass postgres:16 bash -c "chmod 600 /root/.pgpass && pg_dump -h <server> -p <port> -U <username> <database> -f /tmp/$(date +%Y%m%d_%H%M%S)_<database>_dump.sql -c --if-exists"
 ```
 
-## Restoring a Database
+## Dumping a Cluster
 
 ```bash
-docker run --network host --rm -v .:/tmp -e PGPASSWORD=mysecretpassword postgres:16 psql -h localhost -U myuser -d mydb -f /tmp/dump.sql
+docker run --network host --rm -v .:/tmp -v ./pgpass:/root/.pgpass -e PGPASSFILE=/root/.pgpass postgres:16 bash -c "chmod 600 /root/.pgpass && pg_dumpall -h <server> -p <port> -U <username> -f /tmp/$(date +%Y%m%d_%H%M%S)_<server>_cluster_dump.sql -c --if-exists"
+```
+
+## Restoring from a SQL Dump
+
+```bash
+docker run --network host --rm -v .:/tmp -v ./pgpass:/root/.pgpass -e PGPASSFILE=/root/.pgpass postgres:16 bash -c "chmod 600 /root/.pgpass && psql -h <server> -p <port> -U <username> <database> -f /tmp/dump.sql -X"
 ```