chore: minor configuration updates

ferrarimarco · Jan 1, 2025 · 451e9a4 · 451e9a4
1 parent 4cf0563
commit 451e9a4
Show file tree

Hide file tree

Showing 27 changed files with 627 additions and 480 deletions.
diff --git a/.github/renovate.json b/.github/renovate.json
@@ -11,6 +11,10 @@
   "extends": ["config:best-practices", ":semanticCommits"],
   "forkProcessing": "enabled",
   "gitAuthor": "github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>",
+  "gitIgnoredAuthors": [
+    "41898282+github-actions[bot]@users.noreply.github.com",
+    "github-actions[bot]@users.noreply.github.com"
+  ],
   "labels": ["dependencies"],
   "packageRules": [
     {

diff --git a/config/ansible/playbooks/proxmox-vms.yaml b/config/ansible/playbooks/proxmox-vms.yaml
@@ -15,7 +15,7 @@
 # Resize: qm disk resize 100 scsi0 8G
 # Set boot order: qm set 100 --boot order=scsi0
 
-# Attach and configure a second disk from the rpool-sata pool: qm set 100 -scsi1 rpool-sata:vm-100-disk-0,discard=on,iothread=1,size=100G,ssd=1,aio=io_uring
+# Attach and configure a second disk from the rpool-sata pool: qm set 100 -scsi1 rpool-sata:vm-100-disk-0,discard=on,iothread=1,size=113G,ssd=1,aio=io_uring
 
 # Enable UEFI and create a UEFI disk volume: qm set 100 --bios ovmf
 

diff --git a/docs-src/architecture/references.md b/docs-src/architecture/references.md
@@ -8,3 +8,8 @@
 
 - [NixOS flakes tutorial](https://www.tweag.io/blog/2020-07-31-nixos-flakes/)
 - [Integration testing with NixOS in GitHub Actions](https://jnsgr.uk/2024/02/nixos-vms-in-github-actions/)
+
+## ZFS
+
+- [ZFS: You should use mirror vdevs, not RAIDZ](https://jrs-s.net/2015/02/06/zfs-you-should-use-mirror-vdevs-not-raidz/)
+- [Choosing the right ZFS pool layout](https://klarasystems.com/articles/choosing-the-right-zfs-pool-layout/)
diff --git a/docs-src/architecture/storage-configuration.md b/docs-src/architecture/storage-configuration.md
@@ -0,0 +1,14 @@
+# Storage configuration
+
+## Storage planning
+
+## ZFS topology
+
+ZFS pool of mirrored vdevs.
+
+## Storage access
+
+For containers: bind mount ZFS datasets to LXC containers that need them.
+
+For VMs: bind mount ZFS datasets to a LXC container running NFS and Samba
+servers, then mount shares in VMs that need them.
diff --git a/docs-src/guides/expand-partition-debian.md b/docs-src/guides/expand-partition-debian.md
diff --git a/docs-src/guides/useful-proxmox-commands.md b/docs-src/guides/useful-proxmox-commands.md
@@ -18,4 +18,34 @@ Notes:
 
 ## Expand disk, filesystem, and partition
 
-See: <https://pve.proxmox.com/wiki/Resize_disks>.
+On the Proxmox host:
+
+1. Resize the partition using the GUI (VM -> Hardware -> Select disk -> Disk
+   action -> Resize disk). To get the max capacity, see the corresponding storage
+   pool page in the Proxmox admin GUI.
+
+On the VM:
+
+1. Get the device ID: `sudo dmesg | grep capacity`
+
+1. Resize the partition:
+
+   ```shell
+   sudo parted /dev/<DEVICE_ID>
+
+   # Get the partition ID
+   print
+
+   # Resize the partition
+   resizepart <PARTITION_ID> 100%
+
+   quit
+   ```
+
+1. Grow the filesystem:
+
+   ```shell
+   sudo resize2fs /dev/<DEVICE_ID><PARTITION_ID>
+   ```
+
+For more information, see <https://pve.proxmox.com/wiki/Resize_disks>.
diff --git a/docs/404.html b/docs/404.html
@@ -317,6 +317,27 @@
 
 
 
+
+
+
+
+
+
+    <li class="md-nav__item">
+      <a href="/home-lab/architecture/storage-configuration/" class="md-nav__link">
+
+
+  <span class="md-ellipsis">
+    Storage configuration
+  </span>
+
+
+      </a>
+    </li>
+
+
+
+
           </ul>
         </nav>
 
@@ -491,27 +512,6 @@
 
 
 
-    <li class="md-nav__item">
-      <a href="/home-lab/guides/expand-partition-debian/" class="md-nav__link">
-
-
-  <span class="md-ellipsis">
-    Expand a partition and a filesystem on Debian
-  </span>
-
-
-      </a>
-    </li>
-
-
-
-
-
-
-
-
-
-
     <li class="md-nav__item">
       <a href="/home-lab/guides/linux-disk-setup/" class="md-nav__link">
 

diff --git a/docs/architecture/index.html b/docs/architecture/index.html
@@ -379,6 +379,27 @@
 
 
 
+
+
+
+
+
+
+    <li class="md-nav__item">
+      <a href="storage-configuration/" class="md-nav__link">
+
+
+  <span class="md-ellipsis">
+    Storage configuration
+  </span>
+
+
+      </a>
+    </li>
+
+
+
+
           </ul>
         </nav>
 
@@ -553,27 +574,6 @@
 
 
 
-    <li class="md-nav__item">
-      <a href="../guides/expand-partition-debian/" class="md-nav__link">
-
-
-  <span class="md-ellipsis">
-    Expand a partition and a filesystem on Debian
-  </span>
-
-
-      </a>
-    </li>
-
-
-
-
-
-
-
-
-
-
     <li class="md-nav__item">
       <a href="../guides/linux-disk-setup/" class="md-nav__link">
 

diff --git a/docs/architecture/network-configuration/index.html b/docs/architecture/network-configuration/index.html
@@ -430,6 +430,27 @@
 
 
 
+
+
+
+
+
+
+    <li class="md-nav__item">
+      <a href="../storage-configuration/" class="md-nav__link">
+
+
+  <span class="md-ellipsis">
+    Storage configuration
+  </span>
+
+
+      </a>
+    </li>
+
+
+
+
           </ul>
         </nav>
 
@@ -604,27 +625,6 @@
 
 
 
-    <li class="md-nav__item">
-      <a href="../../guides/expand-partition-debian/" class="md-nav__link">
-
-
-  <span class="md-ellipsis">
-    Expand a partition and a filesystem on Debian
-  </span>
-
-
-      </a>
-    </li>
-
-
-
-
-
-
-
-
-
-
     <li class="md-nav__item">
       <a href="../../guides/linux-disk-setup/" class="md-nav__link">
 

diff --git a/docs/architecture/references/index.html b/docs/architecture/references/index.html
@@ -14,7 +14,7 @@
         <link rel="prev" href="../network-configuration/">
 
 
-        <link rel="next" href="../../guides/capture-proxmox-vm-network-traffic/">
+        <link rel="next" href="../storage-configuration/">
 
 
       <link rel="icon" href="../../assets/images/favicon.png">
@@ -377,6 +377,15 @@
     </span>
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#zfs" class="md-nav__link">
+    <span class="md-ellipsis">
+      ZFS
+    </span>
+  </a>
+
 </li>
 
     </ul>
@@ -388,6 +397,27 @@
 
 
 
+
+
+
+
+
+
+    <li class="md-nav__item">
+      <a href="../storage-configuration/" class="md-nav__link">
+
+
+  <span class="md-ellipsis">
+    Storage configuration
+  </span>
+
+
+      </a>
+    </li>
+
+
+
+
           </ul>
         </nav>
 
@@ -562,27 +592,6 @@
 
 
 
-    <li class="md-nav__item">
-      <a href="../../guides/expand-partition-debian/" class="md-nav__link">
-
-
-  <span class="md-ellipsis">
-    Expand a partition and a filesystem on Debian
-  </span>
-
-
-      </a>
-    </li>
-
-
-
-
-
-
-
-
-
-
     <li class="md-nav__item">
       <a href="../../guides/linux-disk-setup/" class="md-nav__link">
 
@@ -816,6 +825,15 @@
     </span>
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#zfs" class="md-nav__link">
+    <span class="md-ellipsis">
+      ZFS
+    </span>
+  </a>
+
 </li>
 
     </ul>
@@ -846,6 +864,11 @@ <h2 id="nixos">NixOS</h2>
 <li><a href="https://www.tweag.io/blog/2020-07-31-nixos-flakes/">NixOS flakes tutorial</a></li>
 <li><a href="https://jnsgr.uk/2024/02/nixos-vms-in-github-actions/">Integration testing with NixOS in GitHub Actions</a></li>
 </ul>
+<h2 id="zfs">ZFS</h2>
+<ul>
+<li><a href="https://jrs-s.net/2015/02/06/zfs-you-should-use-mirror-vdevs-not-raidz/">ZFS: You should use mirror vdevs, not RAIDZ</a></li>
+<li><a href="https://klarasystems.com/articles/choosing-the-right-zfs-pool-layout/">Choosing the right ZFS pool layout</a></li>
+</ul>