You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This document provides instructions on how to use Tilt to start a local Kubernetes (k8s) cluster for APM Server development that communicates with a local Kibana instance. This is useful when you want to test recent changes in APM Server, as the bundled or published package might not be available yet.
4
+
5
+
## Prerequisites
6
+
7
+
- Docker must be installed and running on your local system.
8
+
- You should have the APM Server repo checked out which contains the Tiltfile.
9
+
10
+
## Setup
11
+
12
+
There are two methods to start your Kubernetes cluster using Tilt:
13
+
14
+
- With a Kibana Docker container started as part of the Kubernetes cluster.
15
+
- Connecting to a locally running Kibana instance.
16
+
17
+
### Starting Kibana as a Docker container
18
+
19
+
By default, when running `tilt up` without any additional configuration, Tilt will start a Kibana Docker container as part of the Kubernetes cluster:
20
+
21
+
`$ tilt up`
22
+
23
+
### Connecting to a locally running Kibana instance
24
+
25
+
If you want to run Kibana locally and connect it with the Kubernetes cluster, follow these steps:
26
+
27
+
- Start your local Kibana instance (`yarn start`)
28
+
- Navigate to the APM Server Repo and start Tilt with the '--local-kibana' flag: `$ tilt up -- --local-kibana`
29
+
30
+
**Note**: You should start the local Kibana instance before or immediately after running the Tilt command.
31
+
32
+
As part of the Tilt setup, a `kibana_system_user` is created with the password `changeme`. You can use this user and password for your `kibana.yml` file:
33
+
34
+
```
35
+
elasticsearch.username: kibana_system_user
36
+
elasticsearch.password: changeme
37
+
```
38
+
39
+
### Building and Uploading APM Server Package
40
+
41
+
When you start Tilt, the APM Server package is built from the source and uploaded to Kibana automatically. This allows you to test recent changes in your APM Server.
0 commit comments