Skip to content

Commit

Permalink
[8.10] [DOCS] Add Docker instructions for Kibana (#99112) (#99236)
Browse files Browse the repository at this point in the history
  • Loading branch information
jrodewig authored Sep 6, 2023
1 parent 836dcd8 commit 213fdd6
Show file tree
Hide file tree
Showing 2 changed files with 80 additions and 3 deletions.
6 changes: 4 additions & 2 deletions docs/Versions.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,10 @@ include::{docs-root}/shared/versions/stack/{source_branch}.asciidoc[]
:jdk_major: 11
:build_type: tar

:docker-repo: docker.elastic.co/elasticsearch/elasticsearch
:docker-image: {docker-repo}:{version}
:docker-repo: docker.elastic.co/elasticsearch/elasticsearch
:docker-image: {docker-repo}:{version}
:kib-docker-repo: docker.elastic.co/kibana/kibana
:kib-docker-image: {kib-docker-repo}:{version}
:plugin_url: https://artifacts.elastic.co/downloads/elasticsearch-plugins

///////
Expand Down
77 changes: 76 additions & 1 deletion docs/reference/setup/install/docker.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ The following checks were performed on each of these signatures:

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

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

[[run-kibana-docker]]
===== Run {kib}

. Pull the {kib} Docker image.
+
ifeval::["{release-state}"=="unreleased"]
WARNING: Version {version} of {kib} has not yet been released, so no
Docker image is currently available for this version.
endif::[]
+
[source,sh,subs="attributes"]
----
docker pull {kib-docker-image}
----

. Optional: Verify the {kib} image's signature.
+
ifeval::["{release-state}"=="unreleased"]
WARNING: Version {version} of {kib} has not yet been released, so no
Docker image signature is currently available for this version.
endif::[]
+
[source,sh,subs="attributes"]
----
wget https://artifacts.elastic.co/cosign.pub
cosign verify --key cosign.pub {kib-docker-image}
----

. Start a {kib} container.
+
[source,sh,subs="attributes"]
----
docker run --name kib01 --net elastic -p 5601:5601 {kib-docker-image}
----

. When {kib} starts, it outputs a unique generated link to the terminal. To
access {kib}, open this link in a web browser.

. In your browser, enter the enrollment token that was generated when you started {es}.
+
To regenerate the token, run:
+
[source,sh]
----
docker exec -it es01 /usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s kibana
----

. Log in to {kib} as the `elastic` user with the password that was generated
when you started {es}.
+
To regenerate the password, run:
+
[source,sh]
----
docker exec -it es01 /usr/share/elasticsearch/bin/elasticsearch-reset-password
----

[[remove-containers-docker]]
===== Remove containers

To remove the containers and their network, run:

[source,sh,subs="attributes"]
----
# Remove the Elastic network
docker network rm elastic
# Remove {es} containers
docker rm es01
docker rm es02
# Remove the {kib} container
docker rm kib01
----

===== Next steps

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

0 comments on commit 213fdd6

Please sign in to comment.