NATS 通知設定
此頁面記錄了將 NATS 服務設定為 儲存桶通知 目標的設定。請參閱將事件發佈到 NATS,以了解如何使用這些設定的教學。
您可以透過定義來建立或修改設定
在啟動或重新啟動 MinIO 伺服器之前,主機系統上的環境變數。請參閱您作業系統的文件,以了解如何定義環境變數。
使用
mc admin config set
使用組態設定。使用 MinIO 主控台 的 管理員 > 設定 頁面使用組態設定。
如果您同時定義環境變數和類似的組態設定,MinIO 會使用環境變數值。
某些設定只有環境變數或組態設定,但不是兩者都有。
重要
每個組態設定都控制著 MinIO 的基本行為和功能。MinIO 強烈建議 在套用至生產環境之前,先在較低的環境(例如 DEV 或 QA)中測試組態變更。
多個 NATS 目標
您可以透過在頂層金鑰上附加每個相關 NATS 設定集的唯一識別碼 _ID
來指定多個 NATS 服務端點。
範例
例如,以下指令會將兩個不同的 NATS 服務端點分別設定為 PRIMARY
和 SECONDARY
set MINIO_NOTIFY_NATS_ENABLE_PRIMARY="on"
set MINIO_NOTIFY_NATS_ADDRESS_PRIMARY="nats-endpoint.example.net:4222"
set MINIO_NOTIFY_NATS_ENABLE_SECONDARY="on"
set MINIO_NOTIFY_NATS_ADDRESS_SECONDARY="nats-endpoint.example.net:4222"
透過這些設定,MINIO_NOTIFY_NATS_ENABLE_PRIMARY
表示此環境變數與 ID 為 PRIMARY
的 NATS 服務端點相關聯。
mc admin config set notify_nats:primary \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT=VALUE ...]
mc admin config set notify_nats:secondary \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT=VALUE ...]
設定
啟用
必要
用於定義 NATS 服務端點以搭配 MinIO 儲存貯體通知 使用的頂層組態金鑰。
使用 mc admin config set
來設定或更新 NATS 服務端點。address
和 subject
引數對於每個目標都是必要的。將其他選用引數指定為以空格 (" "
) 分隔的清單。
mc admin config set notify_nats \
address="nats-endpoint.example.com:4222" \
subject="minioevents" \
[ARGUMENT="VALUE"] ... \
位址
必要
指定 MinIO 發佈儲存貯體事件的 NATS 服務端點。例如,nats-endpoint.example.com:4222
。
變更版本 RELEASE.2023-05-27T05-56-19Z:MinIO 會在新增目標之前檢查指定 URL 的健全狀況 (如果 URL 可解析且可連線)。如果現有目標離線,MinIO 不再阻止新增通知目標。
主旨
必要
指定 MinIO 將發佈到 NATS 端點的事件相關聯的訂閱。
使用者名稱
選用
指定連線到 NATS 服務端點的使用者名稱。
密碼
選用
指定連線到 NATS 服務端點的密碼。
變更版本 RELEASE.2023-06-23T20-26-00Z:當作為 mc admin config get
的一部分傳回時,MinIO 會編輯此值。
權杖
選用
指定連線到 NATS 服務端點的權杖。
變更版本 RELEASE.2023-06-23T20-26-00Z:當作為 mc admin config get
的一部分傳回時,MinIO 會編輯此值。
使用者認證檔案
選用
指定要用來連線到 NATS 服務端點的使用者認證檔案 <https://docs.nats.io/using-nats/developer/connecting/creds>。
TLS
選用
指定 on
以啟用與 NATS 服務端點的 TLS 連線。
TLS 略過驗證
選用
啟用或停用 NATS 服務端點 TLS 憑證的 TLS 驗證。
指定
on
以停用 TLS 驗證 (預設)。指定
off
以啟用 TLS 驗證。
Ping 間隔
選用
指定用戶端對 NATS 伺服器執行 ping 的時間間隔。MinIO 支援以下時間單位
s
- 秒,"60s"
m
- 分鐘,"5m"
h
- 小時,"1h"
d
- 天,"1d"
Jetstream
選用
指定 on
以啟用 JetStream 支援,將事件串流到 NATS JetStream 服務端點。
串流
已棄用
選用
指定 on
以啟用將事件非同步發佈到 NATS 服務端點。
非同步串流
已棄用
選用
指定 on
以啟用將事件非同步發佈到 NATS 服務端點。
執行中的最大 ACK 回應數
已棄用
選用
指定在未等待來自 NATS 服務端點的 ACK 回應的情況下要發佈的訊息數。
串流叢集 ID
已棄用
選用
指定 NATS 串流叢集的唯一 ID。
用戶端憑證
選用
指定用於執行 NATS 服務端點 mTLS 驗證的用戶端憑證路徑。
客戶端金鑰
選用
指定用於執行與 NATS 服務端點的 mTLS 身份驗證的客戶端私鑰路徑。
佇列目錄
選用
指定目錄路徑以啟用 MinIO 對未傳遞訊息的持久性事件儲存,例如 /opt/minio/events
。
當 NATS 伺服器/代理離線時,MinIO 會將未傳遞的事件儲存在指定的儲存空間中,並在連線恢復時重播儲存的事件。
佇列限制
選用
指定未傳遞訊息的最大限制。預設為 100000
。
註解
選用
指定與 NATS 設定相關聯的註解。