feat(hugo): install docs site

.github/workflows/hugo.yml

@@ -0,0 +1,63 @@
+name: Hugo
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      SOURCE_DIR: docs
+      HUGO_VERSION: 0.138.0
+    steps:
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-go@v5
+        with:
+          go-version: 'stable'
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Hugo
+        env:
+          HUGO_ENVIRONMENT: production
+        run: |
+          hugo \
+            --minify \
+            --source "${SOURCE_DIR}"
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./${SOURCE_DIR}/public"
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,25 +1,10 @@
-# Trash
-.DS_Store
-Thumbs.db
-# k8s
-kubeconfig
-.decrypted~*.yaml
-.config.env
 *.agekey
-*.pub
 *.key
-# Private
+*.pub
+.config.env
+.idea
 .private
-.bin
-# Ansible
 .venv*
-# Taskfile
-.task
-# Brew
-Brewfile.lock.json
-# intellij
-.idea
-# wiki
-wiki
-# Bootstrap
 /config.yaml
+/docs/.hugo_build.lock
+kubeconfig

docs/archetypes/default.md

@@ -0,0 +1,5 @@
++++
+date = '{{ .Date }}'
+draft = true
+title = '{{ replace .File.ContentBaseName "-" " " | title }}'
++++

docs/content/_index.md

@@ -0,0 +1,39 @@
++++
+date = '2024-11-07T18:54:11+01:00'
+draft = false
+title = 'Homelab'
++++
+
+# Willian's Homelab
+
+## Hardware
+
+For more information about Turing Pi Cluster Board, please visit the [main](turingpi) article.
+### Servers
+
+| Host      | OS                 | Hardware                                                                                   |
+|-----------|--------------------|--------------------------------------------------------------------------------------------|
+| logos     | Ubuntu 24.04.1 LTS | [Raspberry Pi 4 Model B 8GB](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) |
+| mjolnir   | Ubuntu 24.04.1 LTS | [Raspberry Pi 4 Model B 8GB](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) |
+| mnemosyne | Ubuntu 24.04.1 LTS | [Raspberry Pi 4 Model B 8GB](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) |
+| vishnu    | Ubuntu 24.04.1 LTS | [Raspberry Pi 4 Model B 8GB](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) |
+| vigilant  | Debian 11 bullseye | [Raspberry Pi 3 Model B 1GB](https://www.raspberrypi.com/products/raspberry-pi-3-model-b/) |
+| tank      | Debian 12 bookworm | ThinkCentre M710 Tiny                                                                      |
+| dozer     | Debian 12 bookworm | ThinkCentre M710 Tiny                                                                      |
+| turingpi  | BMC firmware 2.0.5 | [Turing Pi Cluster Board](https://turingpi.com/product/turing-pi-2-5/)                     |
+| cotijuba  | Ubuntu 22.04.5 LTS | [Turing RK1 16GB](https://turingpi.com/product/turing-rk1/?attribute_ram=16+GB)            |
+| marajo    | Ubuntu 22.04.5 LTS | [Turing RK1 16GB](https://turingpi.com/product/turing-rk1/?attribute_ram=16+GB)            |
+| outeiro   | Ubuntu 22.04.5 LTS | [Turing RK1 16GB](https://turingpi.com/product/turing-rk1/?attribute_ram=16+GB)            |
+| tapajos   | Ubuntu 22.04.5 LTS | [Turing RK1 16GB](https://turingpi.com/product/turing-rk1/?attribute_ram=16+GB)            |
+
+## Software
+
+### Services
+
+| Service                                 | Description              |
+|-----------------------------------------|--------------------------|
+| [Kubernetes](https://kubernetes.io/)    | Container Orchestration  |
+| [Prometheus](https://prometheus.io/)    | Monitoring               |
+| [Grafana](https://grafana.com/grafana/) | Visualization            |
+| [Pi-hole](https://pi-hole.net/)         | Network-wide Ad Blocking |
+| [WireGuard](https://www.wireguard.com/) | VPN                      |

docs/content/turingpi.md

@@ -0,0 +1,7 @@
++++
+date = '2024-11-08T11:55:00+01:00'
+draft = true
+title = 'Turing Pi Cluster Board'
++++
+# Turing Pi Cluster Board
+![Turing Pi 2](../images/turingpi-1.jpg)

docs/go.mod

@@ -0,0 +1,5 @@
+module github.com/willianpaixao/homelab
+
+go 1.23.2
+
+require github.com/alex-shpak/hugo-book v0.0.0-20241009212754-7c78a39c531a // indirect

docs/go.sum

@@ -0,0 +1,2 @@
+github.com/alex-shpak/hugo-book v0.0.0-20241009212754-7c78a39c531a h1:GiRJQYc9Bt8H59/e0w/97i46Ql39CUIdDQjHikd9scA=
+github.com/alex-shpak/hugo-book v0.0.0-20241009212754-7c78a39c531a/go.mod h1:L4NMyzbn15fpLIpmmtDg9ZFFyTZzw87/lk7M2bMQ7ds=

docs/hugo.toml

@@ -0,0 +1,13 @@
+baseURL = 'https://willianpaixao.github.io/homelab'
+languageCode = 'en-us'
+title = 'Homelab'
+
+enableGitInfo = true
+
+[params]
+BookFavicon = 'favicon.svg'
+BookRepo = 'https://github.com/willianpaixao/homelab'
+
+[module]
+[[module.imports]]
+path = 'github.com/alex-shpak/hugo-book'