Elasticsearch 通知設定
此頁面說明設定 Elasticsearch 服務作為 儲存貯體通知 目標的設定。有關如何使用這些設定的教學,請參閱 發佈事件至 Elasticsearch。
您可以透過定義來建立或修改設定
在啟動或重新啟動 MinIO 伺服器之前,在主機系統上定義一個環境變數。有關如何定義環境變數,請參閱您的作業系統文件。
使用
mc admin config set
來定義一個組態設定。使用 MinIO 主控台 的 管理員 > 設定 頁面來定義一個組態設定。
如果您同時定義環境變數和類似的組態設定,MinIO 將使用環境變數的值。
某些設定僅具有環境變數或組態設定,但並非兩者都有。
重要事項
每個組態設定都控制著 MinIO 的基本行為和功能。MinIO 強烈建議在套用到生產環境之前,先在較低的環境(例如 DEV 或 QA)中測試組態變更。
多個 Elasticsearch 目標
您可以為每組相關設定附加一個唯一的識別碼 _ID
,以指定多個 Elasticsearch 服務端點。例如,以下命令將兩個不同的 Elasticsearch 服務端點分別設定為 PRIMARY
和 SECONDARY
:
範例
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
,而不是每個單獨的引數。
設定
啟用
必要
指定 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 發布儲存桶事件的 Elasticsearch 服務端點。例如,https://elasticsearch.example.com:9200
。
MinIO 支援使用 URL 參數傳遞驗證資訊,格式為 PROTOCOL://USERNAME:PASSWORD@HOSTNAME:PORT
。
在版本 RELEASE.2023-05-27T05-56-19Z 中變更:MinIO 會在新增目標之前檢查指定的 URL 是否正常運作 (是否可解析且可連線)。如果現有的目標離線,MinIO 不再阻止新增新的通知目標。
索引
必要
指定用來儲存或更新 MinIO 儲存桶事件的 Elasticsearch 索引名稱。如果索引不存在,Elasticsearch 會自動建立。
格式
必要
指定寫入 Elasticsearch 索引的事件資料格式。MinIO 支援以下值
namespace
針對每個儲存桶事件,MinIO 會建立一個 JSON 文件,其中儲存桶和物件名稱為文件 ID,而實際事件則為文件主體的一部分。對該物件的其他更新會修改該物件的現有索引項目。同樣地,刪除物件也會刪除對應的索引項目。
access
針對每個儲存桶事件,MinIO 會建立一個包含事件詳細資訊的 JSON 文件,並使用 Elasticsearch 產生的隨機 ID 將其附加到索引中。對物件的其他更新會導致新的索引項目,而現有的項目則保持不變。
使用者名稱
選用
用於連線到強制執行驗證的 Elasticsearch 服務端點的使用者名稱。
密碼
選用
用於連線到強制執行驗證的 Elasticsearch 服務端點的密碼。
在版本 RELEASE.2023-06-23T20-26-00Z 中變更:當作為 mc admin config get
的一部分傳回時,MinIO 會遮蓋此值。
佇列目錄
選用
指定目錄路徑以啟用 MinIO 的持續事件儲存,以便儲存未傳送的訊息,例如 /opt/minio/events
。
當 Elasticsearch 服務離線時,MinIO 會將未傳送的事件儲存在指定的儲存中,並在連線恢復時重新播放儲存的事件。
佇列限制
選用
指定未傳送訊息的最大限制。預設值為 100000
。
註解
選用
指定要與 Elasticsearch 組態關聯的註解。