Skip to content

setup_googlecloud.md

Latest commit

 

History

History
80 lines (61 loc) · 2.46 KB

setup_googlecloud.md

File metadata and controls

80 lines (61 loc) · 2.46 KB
Raw
layout page
title Setup
permalink /docs/demo-setup_googlecloud.html
redirect_from /docs/demo/setup/
category Demo
order 1

Before you begin

Install the Google Cloud SDK.

Setting up the Control Plane

The Amalgam8 Control Plane consists of two components: the service registry and the route controller. In addition to these two components, for the purposes of this demo, a stock ELK stack is also included as part of the control plane deployment scripts, to collect logs from the microservices in the application.

The Amalgam8 Control Plane contains an ELK stack. Elasticsearch 5.0 requires increasing the max map count for certain linux environments such as Vagrant VMs, Docker Toolbox and Minikube. If you are running any of these tools, run the following command on those VMs:

bash
sudo sysctl -w vm.max_map_count=262144

Deploy the control plane by running the following command:

bash
kubectl create -f examples/k8s-controlplane.yaml

Setting up the Amalgam8 CLI

The a8ctl command line utility provides a convenient way to setup and manage routes across microservices as well as inspect the state of the system. The CLI can be installed via the pip tool (available as part of standard Python installation) directly from Python's package repository or from a8ctl github repository.

  1. Run the folowing command to install the a8ctl into your home directory:
bash
pip install --user a8ctl
  1. Add the location of the a8ctl command to the PATH environment variable. On OS X, run
bash
export PATH=$PATH:${HOME}/Library/Python/2.7/bin

On Linux, run

bash
export PATH=$PATH:${HOME}/.local/bin

To use the Amalgam8 CLI (a8ctl) for the demo walkthroughs we need to setup two environment variables: A8_CONTROLLER_URL and A8_REGISTRY_URL. These variables should point to the publicly accessible REST endpoints exposed by the Amalgam8 controller and registry respectively. The value of these variables depends on the environment where you deployed the control plane.

  1. On Google Cloud, assign a public IP to the Node that is running the controller and the registry, and set the environment variables respectively.

Now that you've configured Amalgam8 for Google Cloud, let's move onto running the demo.