mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-29 18:03:32 -04:00
b7e3a1e14b
* delete asciidoc files
* add migrated files
* fix errors
* Disable docs tests
* Clarify release notes page titles
* Revert "Clarify release notes page titles"
This reverts commit 8be688648d.
* Comment out edternal URI images
* Clean up query languages landing pages, link to conceptual docs
* Add .md to url
* Fixes inference processor nesting.
---------
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Liam Thompson <leemthompo@gmail.com>
Co-authored-by: Martijn Laarman <Mpdreamz@gmail.com>
Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>
128 lines
3 KiB
Markdown
128 lines
3 KiB
Markdown
---
|
||
mapped_pages:
|
||
- https://www.elastic.co/guide/en/elasticsearch/plugins/current/discovery-gce-usage-long.html
|
||
---
|
||
|
||
# Setting up GCE Discovery [discovery-gce-usage-long]
|
||
|
||
## Prerequisites [discovery-gce-usage-long-prerequisites]
|
||
|
||
Before starting, you need:
|
||
|
||
* Your project ID, e.g. `es-cloud`. Get it from [Google API Console](https://code.google.com/apis/console/).
|
||
* To install [Google Cloud SDK](https://developers.google.com/cloud/sdk/)
|
||
|
||
If you did not set it yet, you can define your default project you will work on:
|
||
|
||
```sh
|
||
gcloud config set project es-cloud
|
||
```
|
||
|
||
|
||
## Login to Google Cloud [discovery-gce-usage-long-login]
|
||
|
||
If you haven’t already, login to Google Cloud
|
||
|
||
```sh
|
||
gcloud auth login
|
||
```
|
||
|
||
This will open your browser. You will be asked to sign-in to a Google account and authorize access to the Google Cloud SDK.
|
||
|
||
|
||
## Creating your first instance [discovery-gce-usage-long-first-instance]
|
||
|
||
```sh
|
||
gcloud compute instances create myesnode1 \
|
||
--zone <your-zone> \
|
||
--scopes compute-rw
|
||
```
|
||
|
||
When done, a report like this one should appears:
|
||
|
||
```text
|
||
Created [https://www.googleapis.com/compute/v1/projects/es-cloud-1070/zones/us-central1-f/instances/myesnode1].
|
||
NAME ZONE MACHINE_TYPE PREEMPTIBLE INTERNAL_IP EXTERNAL_IP STATUS
|
||
myesnode1 us-central1-f n1-standard-1 10.240.133.54 104.197.94.25 RUNNING
|
||
```
|
||
|
||
You can now connect to your instance:
|
||
|
||
```sh
|
||
# Connect using google cloud SDK
|
||
gcloud compute ssh myesnode1 --zone europe-west1-a
|
||
|
||
# Or using SSH with external IP address
|
||
ssh -i ~/.ssh/google_compute_engine 192.158.29.199
|
||
```
|
||
|
||
::::{admonition} Service Account Permissions
|
||
:class: important
|
||
|
||
It’s important when creating an instance that the correct permissions are set. At a minimum, you must ensure you have:
|
||
|
||
```text
|
||
scopes=compute-rw
|
||
```
|
||
|
||
Failing to set this will result in unauthorized messages when starting Elasticsearch. See [Machine Permissions](/reference/elasticsearch-plugins/discovery-gce-usage-tips.md#discovery-gce-usage-tips-permissions).
|
||
|
||
::::
|
||
|
||
|
||
Once connected, [install {{es}}](docs-content://deploy-manage/deploy/self-managed/installing-elasticsearch.md).
|
||
|
||
|
||
## Install Elasticsearch discovery gce plugin [discovery-gce-usage-long-install-plugin]
|
||
|
||
Install the plugin:
|
||
|
||
```sh
|
||
# Use Plugin Manager to install it
|
||
sudo bin/elasticsearch-plugin install discovery-gce
|
||
```
|
||
|
||
Open the `elasticsearch.yml` file:
|
||
|
||
```sh
|
||
sudo vi /etc/elasticsearch/elasticsearch.yml
|
||
```
|
||
|
||
And add the following lines:
|
||
|
||
```yaml
|
||
cloud:
|
||
gce:
|
||
project_id: es-cloud
|
||
zone: europe-west1-a
|
||
discovery:
|
||
seed_providers: gce
|
||
```
|
||
|
||
Start Elasticsearch:
|
||
|
||
```sh
|
||
sudo systemctl start elasticsearch
|
||
```
|
||
|
||
If anything goes wrong, you should check logs:
|
||
|
||
```sh
|
||
tail -f /var/log/elasticsearch/elasticsearch.log
|
||
```
|
||
|
||
If needed, you can change log level to `trace` by opening `log4j2.properties`:
|
||
|
||
```sh
|
||
sudo vi /etc/elasticsearch/log4j2.properties
|
||
```
|
||
|
||
and adding the following line:
|
||
|
||
```yaml
|
||
# discovery
|
||
logger.discovery_gce.name = discovery.gce
|
||
logger.discovery_gce.level = trace
|
||
```
|
||
|
||
|