Skip to content

Commit 213fdd6

Browse files
authored
[8.10] [DOCS] Add Docker instructions for Kibana (#99112) (#99236)
1 parent 836dcd8 commit 213fdd6

File tree

2 files changed

+80
-3
lines changed

2 files changed

+80
-3
lines changed

docs/Versions.asciidoc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,10 @@ include::{docs-root}/shared/versions/stack/{source_branch}.asciidoc[]
77
:jdk_major: 11
88
:build_type: tar
99

10-
:docker-repo: docker.elastic.co/elasticsearch/elasticsearch
11-
:docker-image: {docker-repo}:{version}
10+
:docker-repo: docker.elastic.co/elasticsearch/elasticsearch
11+
:docker-image: {docker-repo}:{version}
12+
:kib-docker-repo: docker.elastic.co/kibana/kibana
13+
:kib-docker-image: {kib-docker-repo}:{version}
1214
:plugin_url: https://artifacts.elastic.co/downloads/elasticsearch-plugins
1315

1416
///////

docs/reference/setup/install/docker.asciidoc

Lines changed: 76 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ The following checks were performed on each of these signatures:
8383

8484
Use Docker commands to start a single-node {es} cluster for development or
8585
testing. You can then run additional Docker commands to add nodes to the test
86-
cluster.
86+
cluster or run {kib}.
8787

8888
TIP: This setup doesn't run multiple {es} nodes or {kib} by default. To create a
8989
multi-node cluster with {kib}, use Docker Compose instead. See
@@ -197,6 +197,81 @@ curl --cacert http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200/_c
197197
----
198198
// NOTCONSOLE
199199

200+
[[run-kibana-docker]]
201+
===== Run {kib}
202+
203+
. Pull the {kib} Docker image.
204+
+
205+
ifeval::["{release-state}"=="unreleased"]
206+
WARNING: Version {version} of {kib} has not yet been released, so no
207+
Docker image is currently available for this version.
208+
endif::[]
209+
+
210+
[source,sh,subs="attributes"]
211+
----
212+
docker pull {kib-docker-image}
213+
----
214+
215+
. Optional: Verify the {kib} image's signature.
216+
+
217+
ifeval::["{release-state}"=="unreleased"]
218+
WARNING: Version {version} of {kib} has not yet been released, so no
219+
Docker image signature is currently available for this version.
220+
endif::[]
221+
+
222+
[source,sh,subs="attributes"]
223+
----
224+
wget https://artifacts.elastic.co/cosign.pub
225+
cosign verify --key cosign.pub {kib-docker-image}
226+
----
227+
228+
. Start a {kib} container.
229+
+
230+
[source,sh,subs="attributes"]
231+
----
232+
docker run --name kib01 --net elastic -p 5601:5601 {kib-docker-image}
233+
----
234+
235+
. When {kib} starts, it outputs a unique generated link to the terminal. To
236+
access {kib}, open this link in a web browser.
237+
238+
. In your browser, enter the enrollment token that was generated when you started {es}.
239+
+
240+
To regenerate the token, run:
241+
+
242+
[source,sh]
243+
----
244+
docker exec -it es01 /usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s kibana
245+
----
246+
247+
. Log in to {kib} as the `elastic` user with the password that was generated
248+
when you started {es}.
249+
+
250+
To regenerate the password, run:
251+
+
252+
[source,sh]
253+
----
254+
docker exec -it es01 /usr/share/elasticsearch/bin/elasticsearch-reset-password
255+
----
256+
257+
[[remove-containers-docker]]
258+
===== Remove containers
259+
260+
To remove the containers and their network, run:
261+
262+
[source,sh,subs="attributes"]
263+
----
264+
# Remove the Elastic network
265+
docker network rm elastic
266+
267+
# Remove {es} containers
268+
docker rm es01
269+
docker rm es02
270+
271+
# Remove the {kib} container
272+
docker rm kib01
273+
----
274+
200275
===== Next steps
201276

202277
You now have a test {es} environment set up. Before you start

0 commit comments

Comments
 (0)