文件

Elasticsearch 通知設定

此頁面說明設定 Elasticsearch 服務作為 儲存貯體通知 目標的設定。有關如何使用這些設定的教學,請參閱 發佈事件至 Elasticsearch

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

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

  • 使用 mc admin config set 來定義一個組態設定

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

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

某些設定僅具有環境變數或組態設定,但並非兩者都有。

重要事項

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

多個 Elasticsearch 目標

您可以為每組相關設定附加一個唯一的識別碼 _ID,以指定多個 Elasticsearch 服務端點。例如,以下命令將兩個不同的 Elasticsearch 服務端點分別設定為 PRIMARYSECONDARY

範例

set MINIO_NOTIFY_ELASTICSEARCH_ENABLE_PRIMARY="on"
set MINIO_NOTIFY_ELASTICSEARCH_URL_PRIMARY="https://user:password@elasticsearch-endpoint.example.net:9200"
set MINIO_NOTIFY_ELASTICSEARCH_INDEX_PRIMARY="bucketevents"
set MINIO_NOTIFY_ELASTICSEARCH_FORMAT_PRIMARY="namespace"

set MINIO_NOTIFY_ELASTICSEARCH_ENABLE_SECONDARY="on"
set MINIO_NOTIFY_ELASTICSEARCH_URL_SECONDARY="https://user:password@elasticsearch-endpoint.example.net:9200"
set MINIO_NOTIFY_ELASTICSEARCH_INDEX_SECONDARY="bucketevents"
set MINIO_NOTIFY_ELASTICSEARCH_FORMAT_SECONDARY="namespace"
mc admin config set notify_elasticsearch:primary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

mc admin config set notify_elasticsearch:secondary \
   url="user:password@https://elasticsearch-endpoint.example.net:9200" \
   index="bucketevents" \
   format="namespace" \
   [ARGUMENT=VALUE ...]

請注意,對於組態設定,唯一的識別碼僅附加到 notify_elasticsearch,而不是每個單獨的引數。

設定

啟用

必要

MINIO_NOTIFY_ELASTICSEARCH_ENABLE

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

預設值為 off

如果設定為 on,則需要指定以下其他環境變數

notify_elasticsearch

用於定義 Elasticsearch 服務端點的頂層組態鍵,以搭配MinIO 儲存桶通知使用。

使用 mc admin config set 來設定或更新 Elasticsearch 服務端點。以下引數為每個目標的必要引數

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

mc admin config set notify_elasticsearch \
  url="https://user:password@elasticsearch.example.com:9200" \
  [ARGUMENT="VALUE"] ... \

URL

必要

MINIO_NOTIFY_ELASTICSEARCH_URL
notify_elasticsearch url

指定 MinIO 發布儲存桶事件的 Elasticsearch 服務端點。例如,https://elasticsearch.example.com:9200

MinIO 支援使用 URL 參數傳遞驗證資訊,格式為 PROTOCOL://USERNAME:PASSWORD@HOSTNAME:PORT

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

索引

必要

MINIO_NOTIFY_ELASTICSEARCH_INDEX
notify_elasticsearch index

指定用來儲存或更新 MinIO 儲存桶事件的 Elasticsearch 索引名稱。如果索引不存在,Elasticsearch 會自動建立。

格式

必要

MINIO_NOTIFY_ELASTICSEARCH_FORMAT
notify_elasticsearch format

指定寫入 Elasticsearch 索引的事件資料格式。MinIO 支援以下值

namespace

針對每個儲存桶事件,MinIO 會建立一個 JSON 文件,其中儲存桶和物件名稱為文件 ID,而實際事件則為文件主體的一部分。對該物件的其他更新會修改該物件的現有索引項目。同樣地,刪除物件也會刪除對應的索引項目。

access

針對每個儲存桶事件,MinIO 會建立一個包含事件詳細資訊的 JSON 文件,並使用 Elasticsearch 產生的隨機 ID 將其附加到索引中。對物件的其他更新會導致新的索引項目,而現有的項目則保持不變。

使用者名稱

選用

MINIO_NOTIFY_ELASTICSEARCH_USERNAME
notify_elasticsearch username

用於連線到強制執行驗證的 Elasticsearch 服務端點的使用者名稱。

密碼

選用

MINIO_NOTIFY_ELASTICSEARCH_PASSWORD
notify_elasticsearch password

用於連線到強制執行驗證的 Elasticsearch 服務端點的密碼。

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

佇列目錄

選用

MINIO_NOTIFY_ELASTICSEARCH_QUEUE_DIR
notify_elasticsearch queue_dir

指定目錄路徑以啟用 MinIO 的持續事件儲存,以便儲存未傳送的訊息,例如 /opt/minio/events

當 Elasticsearch 服務離線時,MinIO 會將未傳送的事件儲存在指定的儲存中,並在連線恢復時重新播放儲存的事件。

佇列限制

選用

MINIO_NOTIFY_ELASTICSEARCH_QUEUE_LIMIT
notify_elasticsearch queue_limit

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

註解

選用

MINIO_NOTIFY_ELASTICSEARCH_COMMENT
notify_elasticsearch comment

指定要與 Elasticsearch 組態關聯的註解。