開始使用 Databases for Elasticsearch
本教學將引導您完成透過設定實例、設定管理員密碼並連接到該實例來快速開始使用IBM Cloud® Databases for Elasticsearch部署的步驟。
請依照以下步驟完成本教學:
請依照以下步驟完成本教學:
請依照以下步驟完成本教學:
請依照以下步驟完成本教學:
開始之前
- 您需要一個 IBM Cloud帳戶。
第 1 步:選擇您的計劃
Databases for Elasticsearch提供兩種不同的方案:
-
Databases for Elasticsearch Enterprise 部署Elasticsearch的基本版本。
-
Databases for Elasticsearch Platinum 部署Elasticsearch的 Platinum 版本。
這兩個計劃都為您提供完全託管且可擴展的Elasticsearch服務,讓您能夠專注於應用程式和數據,而不是底層基礎設施。
使用API
使用 Cloud Databases API來處理您的Databases for MongoDB實例。 資源控制器 API 用於 配置實例。
您將需要 API 金鑰才能透過 API 執行操作。 請依照 下列步驟建立IBM Cloud API 金鑰,使您能夠使用 API 將基礎架構配置到您的帳戶中。 您可以建立最多 20 個 API 金鑰。
基於安全理由,只可在建立時複製或下載 API 金鑰。 如果 API 金鑰遺失,必須建立新的 API 金鑰。
步驟 2:透過控制台配置
-
登入 IBM Cloud 主控台。
-
點選目錄中的 Databases for Elasticsearch服務。
-
請依照 下列步驟 配置Databases for Elasticsearch實例。
-
配置實例後,按一下實例名稱以查看更多資訊。
第 2 步:透過 CLI 進行配置
您可以使用 CLI 來設定Databases for Elasticsearch實例。 如果您還沒有,則需要安裝 IBM Cloud CLI。
您可以依照 下列步驟 設定Databases for Elasticsearch實例。
步驟 2:透過資源控制器 API 進行配置
請依照 下列步驟 使用資源控制器 API 配置Databases for Elasticsearch實例。
第 2 步:透過 Terraform 進行配置
您需要 API 金鑰才能透過 Terraform 執行操作。 請依照 下列步驟建立IBM Cloud API 金鑰,使 Terraform 能夠將基礎架構配置到您的帳戶中。 您可以建立最多 20 個 API 金鑰。
基於安全理由,只可在建立時複製或下載 API 金鑰。 如果 API 金鑰遺失,必須建立新的 API 金鑰。
取得 API 金鑰後,請依照 下列步驟 使用 Terraform 配置Databases for Elasticsearch實例。
第三步:設定管理員密碼
管理員用戶
當您設定Databases for Elasticsearch部署時,會自動建立 admin
使用者。
在使用它進行連接之前設定管理員密碼。
透過UI設定管理員密碼
從 IBM Cloud資源清單中選擇您的實例,透過 UI 設定管理員密碼。 然後,選擇 “設定”。 接下來,選擇更改資料庫管理員密碼。
透過 CLI 設定管理員密碼
使用IBM Cloud CLI Cloud Databases外掛程式中的 cdb user-password
指令設定管理員密碼。
例如,要為您的部署設定管理員密碼,請使用下列命令:
ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>
透過API設定管理員密碼
您可以使用上述步驟 2 的回應中取得的 id
參數和 設定指定使用者的密碼端點來設定管理員密碼。
curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
-H 'Content-Type: application/json' \
-d '{"password":"newrootpasswordsupersecure21"}' \
"https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"
這 id
參數需要進行 URL 編碼才能使上述 API 呼叫正常運作。
透過 Terraform 設定管理員密碼
管理員密碼作為 Terraform 腳本中的資料庫資源參數之一傳入。 無需採取任何進一步行動。
步驟 4:連線到您的Databases for Elasticsearch實例
使用 Kibana連接到您的部署,Kibana 是一種開源工具,可為您的Elasticsearch資料庫新增視覺化功能。 本教學使用Docker映像儲存庫中的 Kibana 映像在Docker容器中執行 Kibana。
開始之前
- 安裝 Docker,以便您可以取回 Kibana 容器映像檔,以連接至 Databases for Elasticsearch。
- 如果您偏好避免在本端執行 Kibana 並安裝 Docker,則也可以使用 IBM Cloud® Code Engine來部署 Kibana。 如需相關資訊,請參閱 使用 Code Engine,並連接至 Databases for Elasticsearch 實例。
要進行連接,Kibana 需要 Elasticsearch 部署的使用者名稱、密碼、URL 和連接埠。 它還需要 Elasticsearch TLS 憑證才能存取資料庫。 若要取得此信息,請從您建立的 Elasticsearch 實例的_概述_頁面上的_端點_部分複製憑證資訊。 然後,將憑證下載至本端資料夾。 您可以使用下載中提供的名稱,或您自己的檔名。
請記住您在檔案系統上儲存憑證的位置。 如果您在本端執行 Kibana,而不是在 Docker中執行,則憑證會進入 $KIBANA_HOME/config/<filename>
。
設定 Kibana
在執行包含 Kibana 的 Docker 儲存器之前,請使用從步驟 1 下載的 Elasticsearch 憑證,在相同資料夾中建立配置檔。 配置檔將包含一些基本 Kibana 設定,如下所示。
建立名為 kibana.yml
的 YAML 檔案。 在檔案內,您需要下列 Kibana 配置設定:
elasticsearch.ssl.certificateAuthorities: "/usr/share/kibana/config/cacert"
elasticsearch.username: "admin"
elasticsearch.password: "<password>"
elasticsearch.hosts: ["https://<hostname:port>"]
server.name: "kibana"
server.host: "0.0.0.0"
第一個設定 elasticsearch.ssl.certificateAuthorities
是 Docker 將儲存 Elasticsearch 憑證的位置。 當您第一次執行 Docker時,它會放在這個位置。 您可以將它變更為您選擇的位置,但範例路徑是 Kibana 的配置目錄。 確保 kibana.yml
內的憑證名稱 (在我們的範例 "cert" 中) 與步驟 1 中儲存的憑證名稱檔案具有相同的名稱。
接下來是 elasticsearch.username
和 elasticsearch.password
。 使用部署的管理者使用者名稱和密碼。 在嘗試連接之前,請確定您已設定管理者密碼。 對於 elasticsearch.hosts
,請輸入部署的主機名稱及埠,以 :
區隔。
最後,server.name
是 Kibana 實例的機器可讀名稱,server.hosts
是可在 Web 瀏覽器中連接至 Kibana 的後端伺服器主機。
這些設定只是入門的簡化範例。 如需相關資訊,請參閱 配置 Kibana。
如果您在本端執行 Kibana,而不是在 Docker中執行,則 YAML 檔案會進入 $KIBANA_HOME/config/kibana.yml
,其中 Kibana 會讀取其配置。
執行 Kibana 儲存器
既然已設定 kibana.yml
檔案,請使用 Docker 將 YAML 檔案及憑證檔案附加至 Docker 儲存器,同時從 Docker 映像檔儲存庫取回 <kibana_version>
映像檔。
將映像檔與 Kibana 版本搭配使用,該版本與部署正在執行的 Elasticsearch 版本相容。 使用您偏好的 HTTP 用戶端,從 https_endpoint
API 端點擷取 Elasticsearch 版本。 如需相關資訊,請參閱 Elasticsearch 相容性矩陣。
以下是 curl 的範例。 如果您沒有已安裝的憑證,請使用 --insecure
旗標來停用同層級驗證。 可以在實例的 端點 使用者介面中找到 <http_endpoint>
:
curl --cacert <path-to-cert> <https_endpoint>
接下來,在終端機中執行 Docker 指令,以啟動 Kibana 容器。
docker container run -it --name kibana \
-v <path_to_config_folder_created_in_step_1>:/usr/share/kibana/config \
-p 5601:5601 docker.elastic.co/kibana/kibana:<kibana_version>
Docker 指令有一個以 -v
旗標連接的磁區。 這些會裝載至 Kibana 儲存器的路徑 /usr/share/kibana/config/
,這是 Kibana 在其中尋找配置檔的配置目錄。
-p
指定從容器公開的埠,以及您用來存取 Kibana 的埠。- Kibana 版本應該對應於您使用的 Elasticsearch 版本。
當您從終端機執行指令時,它會下載 Kibana Docker 映像檔並執行 Kibana。 Kibana 連接至 Databases for Elasticsearch 部署並順利執行之後,您會在終端機中看到輸出。
log [01:19:31.839] [info][status][plugin:<kibana_version>] Status changed from uninitialized to green - Ready
log [01:19:31.925] [info][status][plugin:elasticsearch@<kibana_version>] Status changed from uninitialized to yellow - Waiting for Elasticsearch
log [01:19:32.120] [info][status][plugin:timelion@<kibana_version>] Status changed from uninitialized to green - Ready
log [01:19:32.134] [info][status][plugin:console@<kibana_version>] Status changed from uninitialized to green - Ready
log [01:19:32.147] [info][status][plugin:metrics@<kibana_version>] Status changed from uninitialized to green - Ready
log [01:19:33.132] [info][status][plugin:elasticsearch@<kibana_version>] Status changed from yellow to green - Ready
log [01:19:33.378] [info][listening] Server running at http://0.0.0.0:5601
如果您不想在終端機中看到 Kibana 的輸出,請使用 -d
旗標來分離容器。
請造訪瀏覽器中的 http://0.0.0.0:5601
,以查看 Kibana。0.0.0.0
是 kibana.yml
中的 server.host
,而 5601
是從容器公開的埠。 造訪 URL 後,會出現一個彈出窗口,提示您輸入使用者名稱和密碼。 使用管理認證或您所建立的任何其他認證來存取部署。 認證不必與您在 kibana.yml
檔案中提供的使用者名稱和密碼相同。
下一步
如需相關資訊,請參閱 Elasticsearch 說明文件。
尋找更多管理資料庫和資料的工具? 您可以使用 IBM Cloud CLI、Cloud Databases CLI 外掛程式 或 Cloud Databases API 來連接至部署。
如果您計劃將 Databases for Elasticsearch 用於應用程式,請參閱 連接外部應用程式 及 連接 IBM Cloud 應用程式。