Docker-based playground

Docker-based 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
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
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
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