Google Cloud Platform (GCP)

edit

The following steps walk you through creating an instance group with virtual machines on Google Compute Engine in preparation for installing Elastic Cloud Enterprise.

To learn more about the concepts used in this section, see Google Cloud Platform Documentation.

To set up your GCP instance group with virtual machines:

  1. Log into the Google Cloud Platform console.
  2. Create an instance template:

    1. Under Instance Templates, click CREATE INSTANCE TEMPLATE and name your template.
    2. Select a machine type, one of the supported Linux distributions as the boot disk and specify enough storage. Make sure that the template meets the prerequisites for Elastic Cloud Enterprise.
    3. Set the Firewall to allow both HTTP and HTTPS access.
    4. On the Networking tab, set IP forwarding to on.
    5. On the SSH keys tab, add your public SSH key.
    6. Click Create:

      Creating an instance template
  3. Add a firewall rule:

    1. Under Instance Templates, select the name of the new template and under Network, click default.
    2. Click Add firewall rule and select Allow from any source (0.0.0.0/0). Enter the following allowed protocols and ports:

      tcp:7000; tcp:12375; tcp:12400; tcp:12443; tcp:22191-22195; tcp:12191-12301; tcp:12898-12908; tcp:13898-13908; tcp:2112; tcp:18000-20000; tcp:9200; tcp:9243; tcp:9300; tcp:9343;
    3. Click Create:

      Creating an firewall rule
    4. NOTE: While these firewall rules make it easy for you to get started with your deployment, we recommend locking down your production infrastructure. Firewall rules need to be adapted to your environment. While all of the above ports need to be open for internal communication, only ports 12443 (ECE Cloud UI) and 9243 (Elasticsearch) need to be exposed to the outside world.
  4. Create an instance group:

    1. Return to the Compute Engine panel through the Products & services menu.
    2. Select the Instance groups panel, click Create instance group, and name your group.
    3. Under Location, select Multi-zone and select a region.
    4. Click Specify port name mapping and add port 9243, which is the port used by Kibana and Elasticsearch for HTTPS access.

      If you are using a load balancer or firewall, consider adding port 443. To add a port, click Add item. On each host in the Elastic Cloud Enterprise cluster, run sudo iptables -A PREROUTING -t nat -p tcp --dport 443 -j REDIRECT --to-ports 9243.

    5. Select the instance template you created earlier.
    6. Specify the number of instances to create. For high availability, select at least three instances. These instances are placed into separate zones. See our deployment recommendations for how many instances you might need to bring up a production Elastic Cloud Enterprise installation.
    7. Click Create:

      Creating an firewall rule

      Creating the instance group can take a few minutes. After the instances have been created, they appear under VM instances.

  5. Add a disk to use with XFS to each instance:

    We recommend that you add disks with a minimum of 100GB of storage each to avoid performance bottlenecks due to GCP IOPS provisioning. To learn more about how increasing your persistent disk size on GCP also increases IOPS and throughput, see Optimizing Persistent Disk and Local SSD Performance.

    If you use XFS, you must use XFS on all allocators.

    1. Under VM instances, select one of the instances and click EDIT.
    2. Under Additional disk, select to add an item and then select the Name dropdown to create a new disk.
    3. Name your disk. If you plan to use the configuration script in a subsequent step, make sure that the additional disks are named esdata-1, esdata-2, and so forth.
    4. Specify the storage type you need for your type of workload.
    5. Create a blank disk by selecting None (blank disk) for the source type.
    6. Click Create to create the new disks.
    7. Click Save to add the new disk to your instance.

      Don’t forget to save your updated instance after adding the disk to make sure it is available for use. You will set up XFS when you configure the instances.

    8. Repeat these steps until you have added disks to all instances.
  6. Configure the new instances with a user ID that has sudo permission.

Next steps: When your Google Compute Engine virtual machines are up and running, you can connect to them and install Elastic Cloud Enterprise. Afterwards, add your load balancer. To learn more about load balancing that is available with GCP, see Google Cloud Load Balancing.