Docs on 筆記

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Log 循環紀錄部署（TAMS + HMI）#

TAMS：每小時更新當天 log；每日 00:10 完整匯出前一天。
HMI：每日 09:00 從 172.18.35.29:3100 完整匯出前一天。
兩者皆保留 90 天。
輸出格式為 JSONL。
Log 儲存根目錄為 /Data/Log/。
使用 loki-readers 群組控管讀取權限。

目錄結構：

/Data/Log/
├── tams/
│ ├── 2026-08-04.jsonl
│ └── 2026-08-05.jsonl
├── hmi/
│ └── 2026-08-04.jsonl
├── loki-export-cron.log
└── loki-export-hmi-cron.log

1. 安裝 LogCLI#

已安裝者可跳過。

LogCLI 建議與 Loki 使用相同版本。以下以 Loki v2.9.2、Linux amd64 為例：

sudo apt-get update
sudo apt-get install -y curl unzip util-linux

tmp_dir="$(mktemp -d)"

curl -fL \
 https://github.com/grafana/loki/releases/download/v2.9.2/logcli-linux-amd64.zip \
 -o "$tmp_dir/logcli.zip"

unzip "$tmp_dir/logcli.zip" -d "$tmp_dir"

sudo install \
 -m 0755 \
 "$tmp_dir/logcli-linux-amd64" \
 /usr/local/bin/logcli

rm -rf "$tmp_dir"

sudo /usr/local/bin/logcli --version

2. 建立群組授權#

建議使用群組授權，不要直接開放所有帳號讀取 backend log。

Mon, 01 Jan 0001 00:00:00 +0000

離線部署 docker image#

以下是 frontend + backend 的離線部署流程。假設建置機有外網、部署機為一般 Linux x86_64。

1. 有外網的建置機：建立 image#

在專案根目錄執行（版本號可自行替換）：

export RELEASE_TAG=20260804

Frontend：

cd tams-frontend

docker buildx build \
 --platform linux/amd64 \
 --load \
 -t tams-frontend:${RELEASE_TAG} \
 -t tams-frontend:latest \
 --build-arg VITE_WS_URL=same-origin \
 --build-arg VITE_API_URL=/api/v1 \
 --build-arg VITE_LIDAR_MODE=real \
 --build-arg VITE_LIDAR_TEST_ROBOT=true \
 --build-arg VITE_HOSPITAL_INITIAL_RELEASE=true \
 --build-arg VITE_LOW_BATTERY_THRESHOLD_MIN=20 \
 .

Backend：

cd ../tams-backend-service

docker buildx build \
 --platform linux/amd64 \
 --target production \
 --load \
 -t tams-backend:${RELEASE_TAG} \
 -t tams-backend:production \
 .

VITE_API_URL=/api/v1 會編譯進 frontend bundle，因此瀏覽器會對前端同源 /api/v1/... 發請求，再由 Nginx 轉送至 backend。