Installing Platform Manager
1. Before installing
-
Consider getting familiar with:
-
Make sure the necessary preparation steps are completed:
-
Collect the necessary information that was set or retrieved on previous steps:
Object Example value How to get value Docker Registry mirror endpoint docker.storage.example.local:5000
See Fetching installation artifacts MapGL JS API endpoint http://mapgl-js-api
See Installing maps API Catalog APIs endpoint http://catalog-api
See Installing search API Navigation API endpoint http://navi-front
See Installing navigation API API Keys MAPGL_KEY
CATALOG_KEY
NAVI_KEY
See Installing API Keys service -
Make sure that the resource requirements specified in the Helm chart are met.
For more information on how to do this, refer to the System requirements document.
Note
Contents of the Helm chart described in this chapter are relevant for the latest On-Premise version (see Release notes). To find parameters for earlier versions, open values.yaml on GitHub and enter the required version number (for example, 1.18.0) in the tag switcher on the left.
-
Choose the domain name for the service. For example,
platform.example.com
.
2. Install Platform Manager
-
Create a Helm configuration file. See here for more details on the available settings.
The example is prefilled with the necessary data collected on previous steps.
values-platform.yaml
dgctlDockerRegistry: '' ui: brand: '' defaultLocale: en pages: '' status: mapgl: '' search: '' navi: '' pro: '' gisPlatform: '' keys: '' mapgl: url: 'https://mapgl-js-api.example.com' scriptPath: /api.js key: 'MAPGL_KEY' initCenter: '' catalog: url: 'https://catalog.example.com' key: 'CATALOG_KEY' navi: url: 'https://navi.example.com' key: 'NAVI_KEY' resources: requests: cpu: 300m memory: 384M limits: cpu: 1100m memory: 512M ingress: enabled: true className: nginx hosts: - host: platform.example.com paths: - path: / pathType: Prefix tls: [] #- hosts: # - platform.example.com # secretName: secret.tls
Where:
-
dgctlDockerRegistry
: your Docker Registry endpoint where On-Premise services' images reside. Example:HOST:PORT
. -
ui
: common application settings:-
brand
: branding inside the application. Possible values:2gis
,urbi
. -
defaultLocale
: default application language. Possible values:en
. -
pages
: list of available pages in the application. Possible values:status
,playground
. Values are separated by commas and written in one string, for example:'status, playground'
. First value in the list is the default page. -
status
: list of statuses of On-Premise services.Each entry in a string containing pairs of the service name and its healthcheck URL. Pairs are separated by commas. Values inside a pair are joined by the "
=
" symbol. For example,mapgl: 'MapGL JS=https://example.com/healthcheck'
. URL must be absolute. You can specify only the URL, for example:mapgl: 'https://example.com/healthcheck'
.mapgl
: status of the MapGL JS API service.search
: statues of the Search services.navi
: status of the Navigation services.pro
: status of Urbi Pro.gisPlatform
: status of the GIS Platform.keys
: status of the API Keys service.
-
mapgl
: access settings for the MapGL JS API service:url
: address of the service host in theHTTP(S)://HOST
format.key
: access key for the service.initCenter
: default map coordinates presented as two numbers in an array:[lng, lat]
. For example:[55.27, 25.2]
for Dubai,[37.64, 55.74]
for Moscow.scriptPath
: path to the service initialization script. The path is built relatively toui.mapgl.url
. Possible values:/api.js
.
-
catalog
: access settings for the Catalog APIs service:url
: address of the service host in theHTTP(S)://HOST
format.key
: access key for the service.
-
navi
: access settings for the Navigation API service:url
: address of the service host in theHTTP(S)://HOST
format.key
: access key for the service.
-
resources
: limits for the application service. Relevant information on how to check recommended resources is provided in the System Requirements document.
-
-
-
Deploy the service with Helm using the created
values-platform.yaml
configuration file:helm upgrade --install --version=1.21.0 --atomic --values ./values-platform.yaml platform 2gis-on-premise/platform
4. Test deployment
Go to https://platform.example.com in a browser. You should enter the web-interface.
What's next?
Find out how to update the service: