Using self-hosted map servers
출처: 문서
본문
자체 호스트 맵 서버 사용하기
OpenSearch Dashboards용 자체 호스트 맵 서버는 폐쇄망 환경에서 기본 맵 서비스에 접근할 수 있게 해줘요. OpenSearch 호환 맵 URL에는 맵 타일과 벡터가 포함된 맵 매니페스트, 맵 타일, 맵 벡터가 포함돼요.
다음 섹션에서는 OpenSearch Dashboards와 함께 자체 호스트 맵 서버를 설정하고 사용하는 단계를 설명해요.
maps-server 이미지는 공식 OpenSearch Docker Hub 저장소에서 받을 수 있어요.
{: .note}
Docker 이미지 가져오기
터미널을 열고 다음 명령어를 실행해요:
docker pull opensearchproject/opensearch-maps-server:1.0.0
서버 설정하기
서버를 실행하기 전에 맵 타일을 설정해야 해요. 두 가지 설정 옵션이 있어요: OpenSearch에서 제공하는 맵 서비스 타일 세트를 사용하거나, 래스터 타일 세트를 생성하는 거예요.
옵션 1: OpenSearch에서 제공하는 맵 서비스 타일 세트 사용
타일 세트를 저장할 Docker 볼륨을 생성해요:
docker volume create tiles-data
OpenSearch 맵 서비스에서 타일 세트를 다운로드해요. 원하는 확대/축소 레벨에 따라 두 가지 행성 타일 세트를 사용할 수 있어요:
- Zoom level 8 (https://maps.opensearch.org/offline/planet-osm-default-z0-z8.tar.gz)
- Zoom level 10 (https://maps.opensearch.org/offline/planet-osm-default-z0-z10.tar.gz)
확대/축소 레벨 10용 행성 타일 세트(압축 2GB/압축 해제 6.8GB)는 확대/축소 레벨 8용 세트(압축 225MB/압축 해제 519MB)보다 약 10배 더 커요. {: .note}
docker run \
-e DOWNLOAD_TILES=https://maps.opensearch.org/offline/planet-osm-default-z0-z8.tar.gz \
-v tiles-data:/usr/src/app/public/tiles/data/ \
opensearch/opensearch-maps-server \
import
옵션 2: 래스터 타일 세트 생성
래스터 타일 세트를 생성하려면 래스터 타일 생성 파이프라인을 사용하고, 그런 다음 타일 세트 절대 경로를 사용하여 볼륨을 생성하여 서버를 시작해요.
서버 시작하기
다음 명령어를 사용하여 Docker 볼륨 tiles-data로 서버를 시작해요. 다음 명령어는 호스트 URL "localhost"와 포트 "8080"을 사용하는 예시예요:
docker run \
-v tiles-data:/usr/src/app/public/tiles/data/ \
-e HOST_URL='http://localhost' \
-p 8080:8080 \
opensearch/opensearch-maps-server \
run
또는 래스터 타일 세트를 생성한 경우 해당 타일 세트를 사용하여 서버를 실행해요:
docker run \
-v /absolute/path/to/tiles/:/usr/src/app/dist/public/tiles/data/ \
-p 8080:8080 \
opensearch/opensearch-maps-server \
run
서버가 실행 중인지 확인하려면 호스트의 브라우저에서 다음 링크를 각각 열거나 curl 명령어(예: curl http://localhost:8080/manifest.json)를 사용해요.
- Map manifest URL:
http://localhost:8080/manifest.json - Map tiles URL:
http://localhost:8080/tiles/data/{z}/{x}/{y}.png - Map tiles demo URL:
http://localhost:8080/
OpenSearch Dashboards와 함께 자체 호스트 맵 서버 사용하기
OpenSearch Dashboards와 함께 자체 호스트 맵 서버를 사용하려면 opensearch_dashboards.yml에 매개변수를 추가하거나 OpenSearch Dashboards에서 기본 WMS 속성을 구성하면 돼요.
옵션 1: opensearch_dashboards.yml 구성
opensearch_dashboards.yml에서 매니페스트 URL을 구성해요:
map.opensearchManifestServiceUrl: "http://localhost:8080/manifest.json"
옵션 2: OpenSearch Dashboards에서 기본 WMS 속성 구성
- OpenSearch Dashboards 콘솔에서 Dashboards Management > Advanced Settings를 선택해요.
- Default WMS properties에서
visualization:tileMap:WMSdefaults를 찾아요. "enabled": false를"enabled": true로 변경하고 유효한 맵 서버의 URL을 추가해요.
라이선스
타일은 Natural Earth 벡터 맵 데이터 이용 약관 및 OpenStreetMap 저작권 및 라이선스에 따라 생성돼요.