mirror of
https://github.com/elastic/kibana.git
synced 2025-04-24 01:38:56 -04:00
# Backport This will backport the following commits from `main` to `8.x`: - [[Docs][Maps] Update EMS Server instructions (#195419)](https://github.com/elastic/kibana/pull/195419) <!--- Backport version: 9.4.3 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sqren/backport) <!--BACKPORT [{"author":{"name":"Jorge Sanz","email":"jorge.sanz@elastic.co"},"sourceCommit":{"committedDate":"2024-10-10T19:02:23Z","message":"[Docs][Maps] Update EMS Server instructions (#195419)\n\n## Summary\n\nSmall improvements to the Elastic Maps Service documentation:\n\n* fixes the reference to the Docker image to pull\n* adds details about using `cosign` to verify the image pulled \n* updates the screenshot to a more recent UI.","sha":"ad8cec13b6ebb8270dd91fc4012ed8ff2b531353","branchLabelMapping":{"^v9.0.0$":"main","^v8.16.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Presentation","release_note:skip","v9.0.0","docs","backport:prev-minor","Feature:Maps"],"title":"[Docs][Maps] Update EMS Server instructions","number":195419,"url":"https://github.com/elastic/kibana/pull/195419","mergeCommit":{"message":"[Docs][Maps] Update EMS Server instructions (#195419)\n\n## Summary\n\nSmall improvements to the Elastic Maps Service documentation:\n\n* fixes the reference to the Docker image to pull\n* adds details about using `cosign` to verify the image pulled \n* updates the screenshot to a more recent UI.","sha":"ad8cec13b6ebb8270dd91fc4012ed8ff2b531353"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/195419","number":195419,"mergeCommit":{"message":"[Docs][Maps] Update EMS Server instructions (#195419)\n\n## Summary\n\nSmall improvements to the Elastic Maps Service documentation:\n\n* fixes the reference to the Docker image to pull\n* adds details about using `cosign` to verify the image pulled \n* updates the screenshot to a more recent UI.","sha":"ad8cec13b6ebb8270dd91fc4012ed8ff2b531353"}}]}] BACKPORT--> Co-authored-by: Jorge Sanz <jorge.sanz@elastic.co>
This commit is contained in:
parent
048bf1e3a4
commit
cb257378ce
2 changed files with 31 additions and 14 deletions
|
@ -1,6 +1,6 @@
|
|||
:ems: Elastic Maps Service
|
||||
:ems-docker-repo: docker.elastic.co/elastic-maps-service/elastic-maps-server
|
||||
:ems-docker-image: {ems-docker-repo}:{version}-amd64
|
||||
:ems-docker-image: {ems-docker-repo}:{version}
|
||||
:ems-headers-url: https://deployment-host
|
||||
|
||||
[[maps-connect-to-ems]]
|
||||
|
@ -81,34 +81,53 @@ If you cannot connect to {ems} from the {kib} server or browser clients, and you
|
|||
|
||||
{hosted-ems} is a self-managed version of {ems} offered as a Docker image that provides both the EMS basemaps and EMS boundaries. The image is bundled with basemaps up to zoom level 8. After connecting it to your {es} cluster for license validation, you have the option to download and configure a more detailed basemaps database.
|
||||
|
||||
You can use +docker pull+ to download the {hosted-ems} image from the Elastic Docker registry.
|
||||
|
||||
. Pull the {hosted-ems} Docker image.
|
||||
+
|
||||
ifeval::["{release-state}"=="unreleased"]
|
||||
Version {version} of {hosted-ems} has not yet been released, so no Docker image is currently available for this version.
|
||||
WARNING: Version {version} of {hosted-ems} has not yet been released.
|
||||
No Docker image is currently available for this version.
|
||||
endif::[]
|
||||
|
||||
ifeval::["{release-state}"!="unreleased"]
|
||||
|
||||
+
|
||||
["source","bash",subs="attributes"]
|
||||
----------------------------------
|
||||
docker pull {ems-docker-image}
|
||||
----------------------------------
|
||||
|
||||
Start {hosted-ems} and expose the default port `8080`:
|
||||
. Optional: Install
|
||||
https://docs.sigstore.dev/system_config/installation/[Cosign] for your
|
||||
environment. Then use Cosign to verify the {es} image's signature.
|
||||
+
|
||||
[source,sh,subs="attributes"]
|
||||
----
|
||||
wget https://artifacts.elastic.co/cosign.pub
|
||||
cosign verify --key cosign.pub {ems-docker-image}
|
||||
----
|
||||
+
|
||||
The `cosign` command prints the check results and the signature payload in JSON format:
|
||||
+
|
||||
[source,sh,subs="attributes"]
|
||||
--------------------------------------------
|
||||
Verification for {ems-docker-image} --
|
||||
The following checks were performed on each of these signatures:
|
||||
- The cosign claims were validated
|
||||
- Existence of the claims in the transparency log was verified offline
|
||||
- The signatures were verified against the specified public key
|
||||
--------------------------------------------
|
||||
|
||||
|
||||
. Start {hosted-ems} and expose the default port `8080`:
|
||||
+
|
||||
["source","bash",subs="attributes"]
|
||||
----------------------------------
|
||||
docker run --rm --init --publish 8080:8080 \
|
||||
{ems-docker-image}
|
||||
----------------------------------
|
||||
|
||||
+
|
||||
Once {hosted-ems} is running, follow instructions from the webpage at `localhost:8080` to define a configuration file and optionally download a more detailed basemaps database.
|
||||
|
||||
+
|
||||
[role="screenshot"]
|
||||
image::images/elastic-maps-server-instructions.png[Set-up instructions]
|
||||
|
||||
endif::[]
|
||||
|
||||
[float]
|
||||
[[elastic-maps-server-configuration]]
|
||||
==== Configuration
|
||||
|
@ -193,7 +212,6 @@ One way to configure {hosted-ems} is to provide `elastic-maps-server.yml` via bi
|
|||
|
||||
["source","yaml",subs="attributes"]
|
||||
--------------------------------------------
|
||||
version: '2'
|
||||
services:
|
||||
ems-server:
|
||||
image: {ems-docker-image}
|
||||
|
@ -212,7 +230,6 @@ These variables can be set with +docker-compose+ like this:
|
|||
|
||||
["source","yaml",subs="attributes"]
|
||||
----------------------------------------------------------
|
||||
version: '2'
|
||||
services:
|
||||
ems-server:
|
||||
image: {ems-docker-image}
|
||||
|
|
Binary file not shown.
Before Width: | Height: | Size: 48 KiB After Width: | Height: | Size: 105 KiB |
Loading…
Add table
Add a link
Reference in a new issue