差異處

這裏顯示兩個版本的差異處。

--- tech:k3s:librenms [2025/11/27 17:34] – 改用 helm 方式部署 jonathan
+++ tech:k3s:librenms [2025/12/13 17:38] (目前版本) – 3. 列出目前所有的 librenms helm chart 版本 jonathan
@@ 行 1: / 行 1: @@
 ====== 在 K3s 環境透過 Rancher 建立 LibreNMS ======
   * 採用 K3s 環境已經定義好的
-    * ingress + tls -> librenms.k3s.ichiayi.com
+    * ingress + tls Exp. [[https://www.ichiayi.com/tech/k3s#%E5%A6%82%E4%BD%95%E5%BB%BA%E7%AB%8B%E7%B5%A6%E5%85%B6%E4%BB%96%E6%9C%8D%E5%8B%99%E9%80%9A%E7%94%A8%E7%9A%84_ssl_%E6%86%91%E8%AD%89|nms.k3s.ichiayi.com]]
-    * nfs storage
+    * nfs storage Exp. [[https://www.ichiayi.com/tech/k3s#storage_%E8%A8%AD%E5%AE%9A|nfs-client]]
-  * 使用官方提供的 helm chart 進行安裝配置
+  * 使用[[https://github.com/librenms/helm-charts|官方提供的 helm chart]] 進行安裝配置
 ===== 安裝程序 =====
@@ 行 10: / 行 10: @@
 helm repo update
 </cli>
-  - 設定配置檔 librenms-value.yaml <code yaml>
+  - 產生 namespace 與所需要的帳號密碼, 可下載這 script 執行後自動產生 {{repo>https://raw.githubusercontent.com/tryweb/k3s/refs/heads/main/charts/librenms/scripts/create-secrets.sh}}
-librenms:
+  - 設定配置檔, 可下載這 values-custom.yaml 來修改成自己需要的內容 {{repo>https://raw.githubusercontent.com/tryweb/k3s/refs/heads/main/charts/librenms/values-custom.yaml}}
-  appkey: "base64:PUT_YOUR_APP_KEY_HERE"
+  - 執行安裝 <cli>
-  timezone: "Asia/Taipei"
+helm install librenms -f values-custom.yaml librenms/librenms -n librenms
+</cli>
+    * 如果安裝後要調整參數(修改 values-custom.yaml), 需要修改後執行 helm upgrade<cli>
+helm upgrade librenms -f values-custom.yaml librenms/librenms -n librenms
+</cli>
+  - 進入 Librenms 網頁 Exp. https://nms.k3s.ichiayi.com
+    * 第一次進入網頁會轉到 install 設定頁面, 建立管理者帳號與密碼
-  configuration: |-
+===== FAQ =====
-    <?php
+==== 1. 如果無法使用預設帳號密碼登入 ====
-    $config['distributed_poller'] = true;
+  - 找到 frontend 的 pod（或任意一個 librenms pod 都可以）
-    $config['distributed_poller_group'] = 0;
+  - 在容器內部執行建立帳號指令 <cli>
+php /opt/librenms/artisan user:add admin \
+  --password=librenms \
+  --email=[email protected] \
+  --role=admin
+</cli>
+  * {{:tech:k3s:螢幕擷取畫面_2025-11-27_182245.png|}}
-  image:
+==== 2. 啟用 Auto Discovery 功能出現 Error: lnms must not run as root. 狀況 ====
-    repository: librenms/librenms
+<note>已經在 [[https://github.com/librenms/helm-charts/releases/tag/librenms-6.1.0|heml chart librenms-6.1.0 版]]解決這問題</note>
-    tag: "24.5.0"
+  * 透過修改 librenms-values.yaml 內加入 <code yaml>
+librenms:
-  frontend:
+:
-    replicas: 1
+  snmp_scanner:
+    enabled: true              # 啟用此項
+    cron: "*/15 * * * *"      # 每 15 分鐘執行
     resources:
       requests:
         cpu: 200m
-        memory: 512Mi
+        memory: 256Mi
-      limits:
+    securityContext:
-        cpu: 500m
+      runAsUser: 1000
-        memory: 1Gi
+      runAsGroup: 1000
+      fsGroup: 1000
+:
+</code>執行 helm upgrade 讓修改生效<cli>
+helm upgrade librenms -f values-custom.yaml librenms/librenms -n librenms
+</cli>
-  poller:
+==== 3. 列出目前所有的 librenms helm chart 版本 ====
-    replicas: 3
+  * <cli>helm search repo librenms/librenms -l</cli>
-    resources:
+  * ++看目前列出結果|<cli>
-      requests:
+jonathan@k3s-master-171:~$ helm search repo librenms/librenms -l
-        cpu: 500m
+NAME                    CHART VERSION   APP VERSION     DESCRIPTION
-        memory: 1Gi
+librenms/librenms       7.0.1           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
-      limits:
+librenms/librenms       7.0.0           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
-        cpu: 1
+librenms/librenms       6.1.0           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
-        memory: 2Gi
+librenms/librenms       6.0.1           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       6.0.0           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.2.0           25.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.1.1           25.9.1          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.1.0           25.9.1          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.13          25.9.1          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.12          25.9.1          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.11          25.8.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.10          25.8.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.9           25.7.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.8           25.7.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.7           25.7.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.6           25.7.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.5           25.6.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.4           25.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.3           25.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.2           25.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.1           25.4.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       5.0.0           25.4.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       4.0.3           25.4.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       4.0.2           25.3.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       4.0.1           25.3.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       4.0.0           25.3.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.19.0          25.2.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.18.0          24.12.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.17.0          24.11.0         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.16.0          24.10.1         LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.15.0          24.8.1          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.14.0          24.6.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.13.1          24.6.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.12.0          24.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.11.1          24.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.10.0          24.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.9.0           24.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+librenms/librenms       3.8.0           24.5.0          LibreNMS is an autodiscovering PHP/MySQL-based ...
+</cli>++
-  # ----------------------------------------------
+===== 參考網址 =====
-  # RRDcached（需要大量持續寫入 — 強烈建議使用 PVC）
+  * https://github.com/tryweb/k3s/blob/main/charts/librenms/README.md
-  # ----------------------------------------------
-  rrdcached:
-    enabled: true
-    persistence:
-      enabled: true
-      # RRD journal（小，主要寫快取）
-      journal:
-        enabled: true
-        size: 1Gi
-        storageClass: nfs-client
-        accessMode: ReadWriteMany
-      # RRD raw data（大，所有 LibreNMS graph 都存這裡）
-      rrdcached:
-        enabled: true
-        size: 10Gi
-        storageClass: nfs-client
-        accessMode: ReadWriteMany
-    envs:
-      - name: TZ
-        value: "Asia/Taipei"
-# ----------------------------------------------
-# MySQL（採用 Bitnami 內建，可用 NFS 做為 PVC）
-# ----------------------------------------------
-mysql:
-  enabled: true
-  architecture: standalone
-  auth:
-    rootPassword: "change_me_root"
-    password: "change_me_librenms"
-    database: "librenms"
-    username: "librenms"
-  primary:
-    persistence:
-      enabled: true
-      size: 10Gi
-      storageClass: nfs-client
-      accessModes:
-        - ReadWriteOnce   # MySQL 建議 RWO（安全）
-    resources:
-      requests:
-        cpu: 200m
-        memory: 512Mi
-# ----------------------------------------------
-# Redis（建議用 NFS PVC, 但也可用 emptyDir）
-# ----------------------------------------------
-redis:
-  enabled: true
-  architecture: standalone
-  master:
-    persistence:
-      enabled: true
-      size: 2Gi
-      storageClass: nfs-client
-      accessModes:
-        - ReadWriteOnce
-    resources:
-      requests:
-        cpu: 100m
-        memory: 256Mi
-# ----------------------------------------------
-# Ingress
-# ----------------------------------------------
-ingress:
-  enabled: true
-  className: nginx
-  annotations:
-    kubernetes.io/ingress.class: "nginx"
-    nginx.ingress.kubernetes.io/proxy-body-size: "64m"
-    nginx.ingress.kubernetes.io/ssl-redirect: "false"
-  hosts:
-    - host: librenms.k3s.ichiayi.com
-      paths:
-        - path: /
-          pathType: Prefix
-  tls:
-    - secretName: wildcard-k3s-ichiayi-com-tls
-      hosts:
-        - librenms.k3s.ichiayi.com
-</code>
-  - 執行安裝 <cli>
-helm install librenms -f librenms-values.yaml librenms/librenms
-</cli>
 {{tag>librenms k3s}}