Skip to content

Latest commit

 

History

History
93 lines (54 loc) · 4.32 KB

playgroud.md

File metadata and controls

93 lines (54 loc) · 4.32 KB
Raw
description
Docker-based playground

Docker-based local ROR cluster and remote Elastic Cloud cluster PLAYGROUND

This document is a step-by-step guide on how to bootstrap a playground with a local ROR cluster in docker (one Elasticsearch node and one Kibana node) and connecting it to a real Elastic Cloud deployment using the "Trusted deployment" feature in Elastic Cloud.

This guide requires minimal knowledge because most of the process is automated. This interactive script will help you to do it quickly. As a result of the script, you will have a working local ROR cluster connected to the remote Elastic Cloud cluster.

Before you start

  1. Linux or Mac OS machine (Windows is untested)
  2. Account in https://cloud.elastic.co/ and valid deployment (a free trial is OK)
  3. Docker and docker-compose and Git installed

Running interactive script

  1. Clone ror-sandbox repository:

    git clone [email protected]:beshu-tech/ror-sandbox.git
cd ror-sandbox/ror-cluster-elastic-cloud-demo/

  2. Run the interactive script:

    ./run.sh

    Intro

  3. After hitting enter, you will be asked to download the CA file with trusted Elastic Cloud deployment certificates:

    Elastic Cloud CA Cert

    Expand it to know how to find it in the Elastic Cloud console

    Elastic Cloud home page

    Elastic Cloud security tab

    Elastic Cloud download CA

  4. Let's assume the CA file was downloaded and saved in /tmp folder. Let's enter the location of the file and hit enter:

    Elastic Cloud CA Cert location

    The interactive script will use the CA file and generate certificates of the local cluster and its CA too. Let's hit enter to continue ...

    ROR cluster certs generation

    As we can see CA file ca.crt of the ROR cluster was created in /tmp/ror-sandbox/ror-cluster-elastic-cloud-demi/certs/ca folder.

  5. Now, the ROR cluster CA file will be used to add a trusted deployment in Elastic Cloud:

    Adding trust deployment instructions

    Expand it to know how to find it in the Elastic Cloud console

    Adding trust deployment in Elastic Console 1

    Adding trust deployment in Elastic Console 2

    Adding trust deployment in Elastic Console 3

    Adding trust deployment in Elastic Console 4

  6. The next step is to configure the Elastic Cloud remote cluster settings. Our script will ask you to provide "Proxy address" and "Server Name". Both can be found in the Elastic Cloud console.

    Remote cluster settings

    Expand it to know how to find it in the Elastic Cloud console

    Copying proxy address and server name

  7. This is all we need to do in the Elastic Cloud console. Now, we can pick Elasticsearch, Kibana and ROR versions:

    Picking versions

  8. Now, the script will create the docker-compose environment with one node of Elasticsearch with ROR installed and connected to the remote Elastic Cloud cluster. Moreover, one node of Kibana with ROR too will be visible http://localhost:15601. It's time to test it now :)

    Summary