IBM Cloud Docs
開始使用 Databases for Elasticsearch

開始使用 Databases for Elasticsearch

本教學將引導您完成透過設定實例、設定管理員密碼並連接到該實例來快速開始使用IBM Cloud® Databases for Elasticsearch部署的步驟。

請依照以下步驟完成本教學:

請依照以下步驟完成本教學:

請依照以下步驟完成本教學:

請依照以下步驟完成本教學:

開始之前

第 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:透過控制台配置

  1. 登入 IBM Cloud 主控台。

  2. 點選目錄中的 Databases for Elasticsearch服務

  3. 請依照 下列步驟 配置Databases for Elasticsearch實例。

  4. 配置實例後,按一下實例名稱以查看更多資訊。

第 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。

開始之前

要進行連接,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.usernameelasticsearch.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.0kibana.yml 中的 server.host,而 5601 是從容器公開的埠。 造訪 URL 後,會出現一個彈出窗口,提示您輸入使用者名稱和密碼。 使用管理認證或您所建立的任何其他認證來存取部署。 認證不必與您在 kibana.yml 檔案中提供的使用者名稱和密碼相同。

下一步

如需相關資訊,請參閱 Elasticsearch 說明文件

尋找更多管理資料庫和資料的工具? 您可以使用 IBM Cloud CLICloud Databases CLI 外掛程式Cloud Databases API 來連接至部署。

如果您計劃將 Databases for Elasticsearch 用於應用程式,請參閱 連接外部應用程式連接 IBM Cloud 應用程式

為了確保應用程式和資料庫的穩定性,請查看 高可用性效能