操作流程

1. 步驟一：環境準備

   部署自建Elasticsearch集群、創建OSS Bucket、創建阿里云Elasticsearch集群。

2. 步驟二：安裝elasticsearch-repository-oss插件

   在自建Elasticsearch集群各節點中安裝elasticsearch-repository-oss插件，插件安裝后才可在自建Elasticsearch中創建OSS倉庫。

3. 步驟三：在自建Elasticsearch集群中創建倉庫

   使用snapshot API在自建Elasticsearch集群中創建快照備份倉庫。

4. 步驟四：為指定索引創建快照

   為需要遷移的索引創建快照，并將快照備份到已創建的倉庫中。

5. 步驟五：在阿里云Elasticsearch上創建相同倉庫

   在阿里云Elasticsearch的Kibana控制臺中，使用snapshot API創建一個與自建Elasticsearch集群相同的快照備份倉庫。

6. 步驟六：在阿里云Elasticsearch上恢復快照

   將倉庫中已備份的自建Elasticsearch集群的快照恢復到阿里云Elasticsearch集群中，完成數據遷移。

7. 步驟七：查看快照恢復結果

   快照恢復后，查看恢復的索引和索引數據。

步驟一：環境準備

1. 準備自建Elasticsearch集群。

   如果您還沒有自建Elasticsearch集群，建議您使用阿里云ECS進行搭建，具體操作步驟請參見安裝并運行Elasticsearch。

   說明

   建議您使用同VPC下的阿里云ECS搭建自建Elasticsearch集群，通過自建服務器搭建集群可能存在網絡不通的問題。

   本文以單節點集群為例進行演示，版本為6.7.0。實際生產中您可以購買多個相同專有網絡VPC（Virtual Private Cloud）的ECS實例搭建多節點Elasticsearch集群，購買ECS的具體步驟請參見自定義購買實例。

2. 開通OSS服務，并創建與部署自建Elasticsearch集群的ECS實例相同地域的Bucket。

   具體操作步驟請參見開通OSS服務和創建存儲空間。

   重要

   請創建標準存儲類型的OSS Bucket，不支持歸檔存儲類型。

3. 創建目標阿里云Elasticsearch實例，所選地域與您創建的Bucket相同。

   具體操作步驟請參見創建阿里云Elasticsearch實例。

步驟二：安裝elasticsearch-repository-oss插件

1. 連接自建Elasticsearch集群所在的ECS。

   具體操作請參見通過密碼或密鑰認證登錄Linux實例。

   說明

   本文檔以普通用戶權限為例。

2. 下載elasticsearch-repository-oss插件。

   本文使用6.7.0版本的插件，要求JDK為11.0及以上版本。

   wget https://github.com/aliyun/elasticsearch-repository-oss/releases/download/v6.7.0/elasticsearch-repository-oss-6.7.0.zip

   說明

   如需獲取其他版本的elasticsearch-repository-oss插件，可參見常見問題。

3. 將安裝包解壓到自建Elasticsearch各節點安裝路徑的plugins目錄下。

   sudo unzip -d /usr/local/elasticsearch-6.7.0/plugins/elasticsearch-repository-oss elasticsearch-repository-oss-6.7.0.zip

   您也可以使用命令方式安裝插件。

   sudo ./bin/elasticsearch-plugin install file:///usr/local/elasticsearch-repository-oss-6.7.0.zip

4. 啟動自建Elasticsearch集群各節點。

   cd /usr/local/elasticsearch-6.7.0
   ./bin/elasticsearch -d

步驟三：在自建Elasticsearch集群中創建倉庫

連接自建Elasticsearch集群所在的ECS，執行如下命令創建倉庫。

sudo curl -H "Content-Type: application/json" -XPUT localhost:9200/_snapshot/<yourBackupName> -d' {"type": "oss", "settings": { "endpoint": "http://oss-cn-hangzhou-internal.aliyuncs.com",  "access_key_id": "<yourAccesskeyId>",  "secret_access_key":"<yourAccesskeySecret>", "bucket": "<yourBucketName>", "compress": true }}'

創建成功后，預期返回"acknowledge":true。

步驟四：為指定索引創建快照

curl -H "Content-Type: application/json" -XPUT localhost:9200/_snapshot/<yourBackupName>/snapshot_1?pretty -d'
{
"indices": "index1,index2"
}'

<yourBackupName>為您在步驟三：在自建Elasticsearch集群中創建倉庫中創建的倉庫名稱；index1和index2為您需要備份的索引名稱。快照創建成功后，預期返回"accepted" : true 。

快照創建過程中，您可以通過GET /_snapshot/<yourBackupName>/<yourSnapshotName>/_status命令查看指定快照的詳細信息。當返回結果中的state為SUCCESS時，表示快照已完成。

步驟五：在阿里云Elasticsearch上創建相同倉庫

1. 登錄目標阿里云Elasticsearch實例的Kibana控制臺，根據頁面提示進入Kibana主頁。
   登錄Kibana控制臺的具體操作，請參見登錄Kibana控制臺。

   說明 本文以阿里云Elasticsearch 6.7.0版本為例，其他版本操作可能略有差別，請以實際界面為準。
2. 在左側導航欄，單擊Dev Tools。

3. 在Console中執行以下命令，創建與自建Elasticsearch相同的倉庫。

   PUT _snapshot/<yourBackupName>
   {
       "type": "oss",
       "settings": {
           "endpoint": "oss-cn-hangzhou-internal.aliyuncs.com",
           "access_key_id": "<yourAccesskeyId>",
           "secret_access_key": "<yourAccesskeySecret>",
           "bucket": "<yourBucketName>",
           "compress": true
       }
   }

   <yourBackupName>和<yourBucketName>需要與步驟三：在自建Elasticsearch集群中創建倉庫中保持一致。

步驟六：在阿里云Elasticsearch上恢復快照

POST _snapshot/es_backup/snapshot_1/_restore
{"indices":"*,-.monitoring*,-.security_audit*","ignore_unavailable":"true"}

命令執行成功，預期返回"accepted" : true。

POST _snapshot/es_backup/snapshot_1/_restore
{
  "indices":"index1",
  "rename_pattern": "index(.+)",
  "rename_replacement": "restored_index_$1"
}

步驟七：查看快照恢復結果

常見問題

Q：如何獲取其他版本的elasticsearch-repository-oss插件？