# Quickstart in Universal Mode
Congratulations! After installing Kuma, you can get up and running with a few easy steps.
Kuma can run in both Kubernetes (Containers) and Universal mode (for VMs and Bare Metal). You are now looking at the quickstart for Universal mode, but you can also check out the Kubernetes one.
In order to simulate a real-world scenario, we have built a simple demo application that resembles a marketplace. In this tutorial we will:
- 1. Run the Marketplace application
- 2. Enable Mutual TLS and Traffic Permissions
- 3. Visualize Traffic Metrics
You can also access the Kuma marketplace demo repository on Github (opens new window) to try more features and policies in addition to the ones described in this quickstart.
Community Chat: If you need help, you can chat with the Community where you can ask questions, contribute back to Kuma and send feedback.
# 1. Run the Marketplace application
First, Vagrant (opens new window) must be installed on your machine.
You then need to clone the demo repository which contains all necessary files to deploy the application with Vagrant:
$ git clone https://github.com/kumahq/kuma-demo.git
Once cloned, you will find the contents of universal demo in the
kuma-demo/vagrant folder. Enter the
vagrant folder by running:
$ cd kuma-demo/vagrant
Next, to install the marketplace demo application you can run:
$ vagrant up
This will create virtual machines for each services required to run the application, in this case:
frontend: the entry-point service that serves the web application.
backend: the underlying backend component that powers the
postgres: the database that stores the marketplace items.
redis: the backend storage for items reviews.
You can then access the application by navigating to 192.168.33.70:8000 (opens new window).
You can visualize the sidecars proxies that have connected to Kuma by running:
# 2. Enable Mutual TLS and Traffic Permissions
By default the network is unsecure and not encrypted. We can change this with Kuma by enabling the Mutual TLS policy to provision a dynamic Certificate Authority (CA) on the
default Mesh resource that will automatically assign TLS certificates to our services (more specifically to the injected dataplane proxies running alongside the services).
We can enable Mutual TLS with a
builtin CA backend by executing:
$ cat <<EOF | kumactl apply -f - type: Mesh name: default mtls: enabledBackend: ca-1 backends: - name: ca-1 type: builtin EOF
Once Mutual TLS has been enabled, Kuma will not allow traffic to flow freely across our services unless we explicitly create a Traffic Permission policy that describes what services can be consumed by other services. You can try to make requests to the demo application at
192.168.33.70:8000/ (opens new window) and you will notice that they will not work.
In a live environment we suggest to setup the Traffic Permission policies prior to enabling Mutual TLS in order to avoid unexpected interruptions of the service-to-service traffic.
We can setup a very permissive policy that allows all traffic to flow in our application in an encrypted way with the following command:
$ cat <<EOF | kumactl apply -f - type: TrafficPermission name: permission-all mesh: default sources: - match: kuma.io/service: '*' destinations: - match: kuma.io/service: '*' EOF
By doing so every request we now make on our demo application at
192.168.33.70:8000/ (opens new window) is not only working again, but it is automatically encrypted and secure.
As usual, you can visualize the Mutual TLS configuration and the Traffic Permission policies we have just applied via the GUI, the HTTP API or
# 3. Visualize Traffic Metrics
With Traffic Metrics we can leverage Prometheus and Grafana to visualize powerful dashboards that show the overall traffic activity of our application and the status of the Service Mesh.
$ cat <<EOF | kumactl apply -f - type: Mesh name: default mtls: enabledBackend: ca-1 backends: - name: ca-1 type: builtin metrics: enabledBackend: prometheus-1 backends: - name: prometheus-1 type: prometheus conf: skipMTLS: true EOF
This will enable the
prometheus metrics backend on the
default Mesh and automatically collect metrics for all of our traffic.
Now let's go ahead and generate some traffic - to populate our charts - by using the demo application!
You can also generate some artificial traffic with the following command to save some clicks:
while [ true ]; do curl http://192.168.33.70:8000/items?q=; curl http://192.168.33.70:8000/items/1/reviews; done
And then access the Grafana dashboard at 192.168.33.80:3000 (opens new window) with default credentials for both the username (
admin) and the password (
Kuma automatically installs three dashboard that are ready to use:
Kuma Mesh: to visualize the status of the overall Mesh.
Kuma Dataplane: to visualize metrics for a single individual dataplane.
Kuma Service to Service: to visualize traffic metrics for our services.
You can now explore the dashboards and see the metrics being populated over time.
# Next steps
#kumamesh on Twitter to chat about Kuma.
Congratulations! You have completed the quickstart for Universal mode, but there is so much more that you can do with Kuma: