[8.8] [DOCS] Add steps for Docker image verification (#158303) (#158331)

# Backport

This will backport the following commits from `main` to `8.8`:
- [[DOCS] Add steps for Docker image verification
(#158303)](https://github.com/elastic/kibana/pull/158303)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"David
Kilfoyle","email":"41695641+kilfoyle@users.noreply.github.com"},"sourceCommit":{"committedDate":"2023-05-23T21:19:29Z","message":"[DOCS]
Add steps for Docker image verification (#158303)\n\nThis adds steps to
the [Install Kibana
with\r\nDocker](https://www.elastic.co/guide/en/kibana/current/docker.html)
page\r\nfor verifying the downloaded Docker images. I split apart the
original\r\nversion which had all the commands in one block. Having them
separate\r\nallows us to add in the optional \"verify images\" step with
a link to the\r\nElasticsearch docs for additional info.\r\n\r\nRel:
https://github.com/elastic/dev/issues/2002\r\n\r\n**Preview**\r\n\r\n---\r\n![Screenshot
2023-05-23 at 1 56
32\r\nPM](7d35b9ad-d0f1-4c01-b26b-6ca469fdc644)\r\n\r\n---\r\n\r\n![Screenshot
2023-05-23 at 1 47
24\r\nPM](0ec110be-1560-4dcc-8949-792e09846ee9)\r\n\r\n---------\r\n\r\nCo-authored-by:
Tiago Costa
<tiago.costa@elastic.co>","sha":"fb9e3c9ec80e5ba22b6315b7963ad20caa84f439","branchLabelMapping":{"^v8.9.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v8.8.0","v8.9.0"],"number":158303,"url":"https://github.com/elastic/kibana/pull/158303","mergeCommit":{"message":"[DOCS]
Add steps for Docker image verification (#158303)\n\nThis adds steps to
the [Install Kibana
with\r\nDocker](https://www.elastic.co/guide/en/kibana/current/docker.html)
page\r\nfor verifying the downloaded Docker images. I split apart the
original\r\nversion which had all the commands in one block. Having them
separate\r\nallows us to add in the optional \"verify images\" step with
a link to the\r\nElasticsearch docs for additional info.\r\n\r\nRel:
https://github.com/elastic/dev/issues/2002\r\n\r\n**Preview**\r\n\r\n---\r\n![Screenshot
2023-05-23 at 1 56
32\r\nPM](7d35b9ad-d0f1-4c01-b26b-6ca469fdc644)\r\n\r\n---\r\n\r\n![Screenshot
2023-05-23 at 1 47
24\r\nPM](0ec110be-1560-4dcc-8949-792e09846ee9)\r\n\r\n---------\r\n\r\nCo-authored-by:
Tiago Costa
<tiago.costa@elastic.co>","sha":"fb9e3c9ec80e5ba22b6315b7963ad20caa84f439"}},"sourceBranch":"main","suggestedTargetBranches":["8.8"],"targetPullRequestStates":[{"branch":"8.8","label":"v8.8.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.9.0","labelRegex":"^v8.9.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/158303","number":158303,"mergeCommit":{"message":"[DOCS]
Add steps for Docker image verification (#158303)\n\nThis adds steps to
the [Install Kibana
with\r\nDocker](https://www.elastic.co/guide/en/kibana/current/docker.html)
page\r\nfor verifying the downloaded Docker images. I split apart the
original\r\nversion which had all the commands in one block. Having them
separate\r\nallows us to add in the optional \"verify images\" step with
a link to the\r\nElasticsearch docs for additional info.\r\n\r\nRel:
https://github.com/elastic/dev/issues/2002\r\n\r\n**Preview**\r\n\r\n---\r\n![Screenshot
2023-05-23 at 1 56
32\r\nPM](7d35b9ad-d0f1-4c01-b26b-6ca469fdc644)\r\n\r\n---\r\n\r\n![Screenshot
2023-05-23 at 1 47
24\r\nPM](0ec110be-1560-4dcc-8949-792e09846ee9)\r\n\r\n---------\r\n\r\nCo-authored-by:
Tiago Costa
<tiago.costa@elastic.co>","sha":"fb9e3c9ec80e5ba22b6315b7963ad20caa84f439"}}]}]
BACKPORT-->

Co-authored-by: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com>
This commit is contained in:
Kibana Machine 2023-05-23 17:43:08 -04:00 committed by GitHub
parent 96c6d15f00
commit 79f2cc6467
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -34,13 +34,39 @@ endif::[]
ifeval::["{release-state}"!="unreleased"]
.. Create a new Docker network for {es} and {kib}:
+
[source,sh,subs="attributes"]
----
docker network create elastic
----
.. Pull the {es} Docker image:
+
[source,sh,subs="attributes"]
----
docker pull {es-docker-image}
----
.. Optional: Verify the {es} Docker image signature::
+
[source,sh,subs="attributes"]
----
wget https://artifacts.elastic.co/cosign.pub
cosign verify --key cosign.pub {docker-repo}:{version}
----
+
For details about this step, refer to {ref}/docker.html#docker-verify-signature[Verify the {es} Docker image signature] in the {es} documentation.
.. Start {es} in Docker:
+
[source,sh,subs="attributes"]
----
docker run --name es-node01 --net elastic -p 9200:9200 -p 9300:9300 -t {es-docker-image}
----
endif::[]
--
@ -79,6 +105,34 @@ docker pull {docker-image}
docker run --name kib-01 --net elastic -p 5601:5601 {docker-image}
----
.. Pull the {kib} Docker image:
+
[source,sh,subs="attributes"]
----
docker pull {docker-image}
----
.. Optional: Verify the {kib} Docker image signature::
+
[source,sh,subs="attributes"]
----
wget https://artifacts.elastic.co/cosign.pub
cosign verify --key cosign.pub {docker-repo}:{version}
----
+
For details about this step, refer to {ref}/docker.html#docker-verify-signature[Verify the {es} Docker image signature] in the {es} documentation.
.. Start {kib} in Docker:
+
[source,sh,subs="attributes"]
----
docker run --name kib-01 --net elastic -p 5601:5601 {docker-image}
----
endif::[]
--
+