文件

NSQ 通知設定

此頁面記錄了將 NSQ 服務設定為 儲存桶通知 目標的設定。請參閱 將事件發佈到 NSQ,以取得使用這些設定的教學課程。

您可以透過定義以下方式建立或修改設定

  • 在啟動或重新啟動 MinIO 伺服器之前,在主機系統上定義環境變數。請參閱您作業系統的文件,了解如何定義環境變數。

  • 使用 mc admin config set 使用組態設定

  • 使用 MinIO 主控台管理員 > 設定 頁面使用組態設定

如果您同時定義環境變數和類似的組態設定,MinIO 會使用環境變數值。

某些設定只有環境變數或組態設定,但兩者皆無。

重要

每個組態設定都控制著 MinIO 的基本行為和功能。MinIO 強烈建議在將組態變更應用於生產環境之前,先在較低的環境 (例如開發或 QA) 中進行測試。

多個 NSQ 目標

您可以透過將唯一識別碼 _ID 附加到每個相關 NSQ 設定集的頂層金鑰末尾,來指定多個 NSQ 服務端點。例如,以下命令會分別將兩個不同的 NSQ 服務端點設定為 PRIMARYSECONDARY

set MINIO_NOTIFY_NSQ_ENABLE_PRIMARY="on"
set MINIO_NOTIFY_NSQ_NSQD_ADDRESS_PRIMARY="https://user:password@nsq-endpoint.example.net:9200"
set MINIO_NOTIFY_NSQ_TOPIC_PRIMARY="bucketevents"

set MINIO_NOTIFY_NSQ_ENABLE_SECONDARY="on"
set MINIO_NOTIFY_NSQ_NSQD_ADDRESS_SECONDARY="https://user:password@nsq-endpoint.example.net:9200"
set MINIO_NOTIFY_NSQ_TOPIC_SECONDARY="bucketevents"
mc admin config set notify_nsq:primary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

mc admin config set notify_nsq:secondary \
   nsqd_address="ENDPOINT" \
   topic="<string>" \
   [ARGUMENT="VALUE"] ... \

設定

啟用

必要

MINIO_NOTIFY_NSQ_ENABLE

指定 on 以啟用將儲存桶通知發佈到 NSQ 端點。

notify_nsq

用於定義 NSQ 伺服器/代理端點的頂層組態鍵,以用於 MinIO 儲存桶通知

使用 mc admin config set 來設定或更新 NSQ 伺服器/代理端點。每個端點都必須包含以下引數

將其他選用引數指定為以空白字元(" ")分隔的清單。

mc admin config set notify_nsq                          \
   nsqd_address="https://nsq-endpoint.example.net:4150" \
   topic="<string>"                                     \
   [ARGUMENT="VALUE"] ...

NSQ 精靈伺服器位址

必要

MINIO_NOTIFY_NSQ_NSQD_ADDRESS
notify_nsq nsqd_address

指定執行 NSQ 精靈的 NSQ 伺服器位址。例如

https://nsq-endpoint.example.net:4150

在版本 RELEASE.2023-05-27T05-56-19Z 中變更:MinIO 會在新增目標之前檢查指定的 URL 是否正常運作(如果可以解析並且可以連線)。如果現有的目標離線,MinIO 不再會阻止新增新的通知目標。

主題

必要

MINIO_NOTIFY_NSQ_TOPIC
notify_nsq topic

指定當 MinIO 將事件發佈到代理時所使用的 NSQ 主題名稱。

TLS

選用

MINIO_NOTIFY_NSQ_TLS
notify_nsq tls

指定 on 以啟用與 NSQ 服務代理的 TLS 連線。

TLS 略過驗證

選用

MINIO_NOTIFY_NSQ_TLS_SKIP_VERIFY
notify_nsq tls_skip_verify

啟用或停用 NSQ 服務代理 TLS 憑證的 TLS 驗證。

  • 指定 on 以停用 TLS 驗證(預設)。

  • 指定 off 以啟用 TLS 驗證。

佇列目錄

選用

MINIO_NOTIFY_NSQ_QUEUE_DIR
notify_nsq queue_dir

指定目錄路徑以啟用 MinIO 持久性事件儲存區,用於儲存未傳遞的訊息,例如 /opt/minio/events

當 NSQ 伺服器/代理離線時,MinIO 會將未傳遞的事件儲存在指定的儲存區中,並在連線恢復時重播儲存的事件。

佇列限制

選用

MINIO_NOTIFY_NSQ_QUEUE_LIMIT
notify_nsq queue_limit

指定未傳遞訊息的最大限制。預設值為 100000

註解

選用

MINIO_NOTIFY_NSQ_COMMENT
notify_nsq comment

指定與 NSQ 組態相關聯的註解。