文件

NATS 通知設定

NATS 串流已棄用

NATS 串流已棄用。請改為遷移至 JetStream

相關的 MinIO 設定選項和環境變數已棄用。

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

您可以透過定義來建立或修改設定

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

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

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

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

某些設定只有環境變數或組態設定,但不是兩者都有。

重要

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

多個 NATS 目標

您可以透過在頂層金鑰上附加每個相關 NATS 設定集的唯一識別碼 _ID 來指定多個 NATS 服務端點。

範例

例如,以下指令會將兩個不同的 NATS 服務端點分別設定為 PRIMARYSECONDARY

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 ...]

設定

啟用

必要

MINIO_NOTIFY_NATS_ENABLE

指定 on 以啟用將儲存貯體通知發佈到 NATS 服務端點。

預設為 off

notify_nats

用於定義 NATS 服務端點以搭配 MinIO 儲存貯體通知 使用的頂層組態金鑰。

使用 mc admin config set 來設定或更新 NATS 服務端點。addresssubject 引數對於每個目標都是必要的。將其他選用引數指定為以空格 (" ") 分隔的清單。

mc admin config set notify_nats \
  address="nats-endpoint.example.com:4222" \
  subject="minioevents" \
  [ARGUMENT="VALUE"] ... \

位址

必要

MINIO_NOTIFY_NATS_ADDRESS
notify_nats address

指定 MinIO 發佈儲存貯體事件的 NATS 服務端點。例如,nats-endpoint.example.com:4222

變更版本 RELEASE.2023-05-27T05-56-19Z:MinIO 會在新增目標之前檢查指定 URL 的健全狀況 (如果 URL 可解析且可連線)。如果現有目標離線,MinIO 不再阻止新增通知目標。

主旨

必要

MINIO_NOTIFY_NATS_SUBJECT
notify_nats subject

指定 MinIO 將發佈到 NATS 端點的事件相關聯的訂閱。

使用者名稱

選用

MINIO_NOTIFY_NATS_USERNAME
notify_nats username

指定連線到 NATS 服務端點的使用者名稱。

密碼

選用

MINIO_NOTIFY_NATS_PASSWORD
notify_nats password

指定連線到 NATS 服務端點的密碼。

變更版本 RELEASE.2023-06-23T20-26-00Z:當作為 mc admin config get 的一部分傳回時,MinIO 會編輯此值。

權杖

選用

MINIO_NOTIFY_NATS_TOKEN
notify_nats token

指定連線到 NATS 服務端點的權杖。

變更版本 RELEASE.2023-06-23T20-26-00Z:當作為 mc admin config get 的一部分傳回時,MinIO 會編輯此值。

使用者認證檔案

選用

MINIO_NOTIFY_NATS_USER_CREDENTIALS
notify_nats user_credentials

指定要用來連線到 NATS 服務端點的使用者認證檔案 <https://docs.nats.io/using-nats/developer/connecting/creds>

TLS

選用

MINIO_NOTIFY_NATS_TLS
notify_nats tls

指定 on 以啟用與 NATS 服務端點的 TLS 連線。

TLS 略過驗證

選用

MINIO_NOTIFY_NATS_TLS_SKIP_VERIFY
notify_nats tls_skip_verify

啟用或停用 NATS 服務端點 TLS 憑證的 TLS 驗證。

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

  • 指定 off 以啟用 TLS 驗證。

Ping 間隔

選用

MINIO_NOTIFY_NATS_PING_INTERVAL
notify_nats ping_interval

指定用戶端對 NATS 伺服器執行 ping 的時間間隔。MinIO 支援以下時間單位

  • s - 秒,"60s"

  • m - 分鐘,"5m"

  • h - 小時,"1h"

  • d - 天,"1d"

Jetstream

選用

MINIO_NOTIFY_NATS_JETSTREAM
notify_nats jetstream

指定 on 以啟用 JetStream 支援,將事件串流到 NATS JetStream 服務端點。

串流

已棄用

選用

MINIO_NOTIFY_NATS_STREAMING
notify_nats streaming

指定 on 以啟用將事件非同步發佈到 NATS 服務端點。

非同步串流

已棄用

選用

MINIO_NOTIFY_NATS_STREAMING_ASYNC
notify_nats streaming_async

指定 on 以啟用將事件非同步發佈到 NATS 服務端點。

執行中的最大 ACK 回應數

已棄用

選用

MINIO_NOTIFY_NATS_STREAMING_MAX_PUB_ACKS_IN_FLIGHT
notify_nats streaming_max_pub_acks_in_flight

指定在未等待來自 NATS 服務端點的 ACK 回應的情況下要發佈的訊息數。

串流叢集 ID

已棄用

選用

MINIO_NOTIFY_NATS_STREAMING_CLUSTER_ID
notify_nats streaming_cluster_id

指定 NATS 串流叢集的唯一 ID。

憑證授權單位

選用

MINIO_NOTIFY_NATS_CERT_AUTHORITY
notify_nats cert_authority

指定用來簽署 NATS 服務端點 TLS 憑證的憑證授權單位鏈的路徑。

用戶端憑證

選用

MINIO_NOTIFY_NATS_CLIENT_CERT
notify_nats client_cert

指定用於執行 NATS 服務端點 mTLS 驗證的用戶端憑證路徑。

客戶端金鑰

選用

MINIO_NOTIFY_NATS_CLIENT_KEY
notify_nats client_key

指定用於執行與 NATS 服務端點的 mTLS 身份驗證的客戶端私鑰路徑。

佇列目錄

選用

MINIO_NOTIFY_NATS_QUEUE_DIR
notify_nats queue_dir

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

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

佇列限制

選用

MINIO_NOTIFY_NATS_QUEUE_LIMIT
notify_nats queue_limit

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

註解

選用

MINIO_NOTIFY_NATS_COMMENT
notify_nats comment

指定與 NATS 設定相關聯的註解。