筆記

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

PolyMedX Production 部署精簡版（執行用）#

正式環境：MongoDB Server（獨立） + Application Server（polymed-system）

這裏假設:

Application Server：10.10.0.10 MongoDB Server： 10.10.0.20

0. 首次取得原始碼（Application Server）#

sudo mkdir -p /opt/polymedx
sudo chown "$USER" /opt/polymedx
cd /opt/polymedx

repo init \
 -u git@ssh.dev.azure.com:v3/pixsee/PolyMedX/polymedx-manifest \
 -b main \
 -m default.xml

repo sync -c -j8

1. MongoDB Server#

# 1. 設定目錄
sudo mkdir -p /opt/polymedx
sudo chown "$USER" /opt/polymedx
cd /opt/polymedx

# 2. 複製檔案
# 將其中的 Application Server 中的 workspace-config/mongodb-deployment 整個目錄複製到 MongoDB Server 的 /opt/polymedx/

# 3. 確認目錄（從 Application Server 複製過來）
# /opt/polymedx/mongodb-deployment/
# ├── docker-compose.yml
# ├── production.mongodb.env.example
# └── mongo-init/

cd /opt/polymedx/mongodb-deployment

# 4. 設定
cp production.mongodb.env.example production.mongodb.env
chmod 600 production.mongodb.env
# 編輯 production.mongodb.env（IP、帳密、INIT_CLIENT_*）

production.mongodb.env 關鍵項目：

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。