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

Reviewed-on: #14

.github/workflows/pipeline.yml

@@ -46,6 +46,7 @@ jobs:
           images: liamsgit.dev/LiamPietralla/code-snippets
           tags: |
             type=raw,value=latest
+            type=sha,value=${{ github.sha }}
 
     - name: Login to Registry
       uses: docker/login-action@v3
@@ -98,5 +99,16 @@ jobs:
         ansible-playbook infra/ansible/deploy-playbook.yml --private-key private.key --inventory hosts.ini
       env: 
         APP_HOST: ${{ secrets.APP_HOST }}
-        REGISTRY_USERNAME: ${{ secrets.REGISTRY_USERNAME }}
-        REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
+        REGISTRY_USERNAME: ${{ secrets.DOCKER_USERNAME }}
+        REGISTRY_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
+
+    # - name: Setup Nomad
+    #   uses: hashicorp/setup-nomad@main
+    #   with:
+    #     nomad_version: '1.10.5'
+
+    # - name: Deploy Job to Nomad
+    #   run: |
+    #     nomad job run -var="version=${{ github.sha }}" infra/nomad/code-snippets.nomad.hcl
+    #   env: 
+    #     NOMAD_ADDR: ${{ vars.NOMAD_ADDR }}

.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/

infra/nomad/code-snippets.nomad.hcl

@@ -0,0 +1,46 @@
+variable "version" {
+type    = string
+default = "latest"
+}
+
+job "code-snippets" {
+  datacenters = ["dc1"]
+  type        = "service"
+
+  group "code-snippets" {
+    count = 1
+
+    network {
+      port "http" {
+        to = 80
+      }
+    }
+
+    task "code-snippets" {
+      driver = "docker"
+
+      config {
+        image      = "liamsgit.dev/LiamPietralla/code-snippets:${var.version}"
+        force_pull = true
+        ports      = ["http"]
+      }
+
+      service {
+        name = "code-snippets"
+        port = "http"
+        tags = [
+          "traefik.enable=true",
+          "traefik.http.routers.code-snippets.rule=PathPrefix(`/`)",
+          "traefik.http.routers.code-snippets.entrypoints=p5003"
+        ]
+
+        check {
+          type     = "http"
+          path     = "/"
+          interval = "10s"
+          timeout  = "2s"
+        }
+      }
+    }
+  }
+}