Установка Platform Manager

1. Перед установкой

Ознакомьтесь с основной информацией:
Выполните предварительные шаги:

Соберите необходимые данные, заданные или полученные на предыдущих шагах:

Объект	Пример значения	Как получить значение
Эндпоинт зеркала реестра Docker	`docker.storage.example.local:5000`	См. Получение артефактов установки
Эндпоинт MapGL JS API	`http://mapgl-js-api`	См. Установка API для работы с картами
Эндпоинт Catalog APIs	`http://catalog-api`	См. Установка API для работы с поиском
Эндпоинт Navigation API	`http://navi-front`	См. Установка API для работы с навигацией
API-ключи	`MAPGL_KEY` `CATALOG_KEY` `NAVI_KEY`	См. Установка сервиса ключей

Убедитесь, что удовлетворены требования к ресурсам, приведенные в Helm-чартe.

Подробнее о том, как это сделать, смотрите в документе Системные требования.

Примечание

Содержание Helm-чарта, описанное в данном разделе, актуально для последней версии On-Premise (см. Релизы). Чтобы изучить параметры для более ранних версий, откройте values.yaml в GitHub и введите номер нужной версии комплекса (например, 1.18.0) в переключателе тегов слева.
Определите доменное имя для сервиса Platform Manager. Например, platform.example.com.

2. Установите Platform Manager

Создайте конфигурационный файл для Helm. Подробное описание доступных параметров см. здесь.

Пример файла уже заполнен всеми необходимыми данными, собранными на предыдущих этапах.
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
```
Где:
- dgctlDockerRegistry: эндпоинт вашего реестра Docker, в котором находятся образы сервисов On-Premise. Пример: HOST:PORT.
- ui: базовые настройки приложения.
  - brand: брендирование внутри приложения. Возможные значения: 2gis, urbi.
  - defaultLocale: язык приложения по умолчанию. Возможные значения: en.
  - pages: список доступных страниц в приложении. Возможные значения: status, playground. Значения записываются одной строкой через запятую, например, 'status, playground'. Первое значение в списке — страница по умолчанию.
  - status: перечень статусов для сервисов On-Premise.
    
    Значение — строка, содержащая пары из названия сервиса и URL до его healthcheck. Пары записываются через запятую. Значения внутри пары соединяются символом "=". Например, mapgl: 'MapGL JS=https://example.com/healthcheck'. URL должен быть абсолютным. Можно указать только URL, например, mapgl: 'https://example.com/healthcheck'.
    - mapgl: статус сервиса MapGL JS API.
    - search: статус сервисов Поиска.
    - navi: статус сервисов Навигации.
    - pro: статус сервисов 2ГИС Про.
    - gisPlatform: статус сервиса GIS-платформа.
    - keys: статус Сервиса ключей.
  - mapgl: настройки доступа к сервису MapGL JS API:
    - url: хост сервиса в формате HTTP(S)://HOST.
    - key: API-ключ для сервиса.
    - initCenter: координаты карты по умолчанию. Состоят из двух чисел в массиве: [lng, lat]. Например: [55.27, 25.2] для Дубая, [37.64, 55.74] для Москвы.
    - scriptPath: путь до скрипта инициализации сервиса. Путь строится относительно ui.mapgl.url. Возможные значения: /api.js.
  - catalog: настройки доступа к сервису Catalog APIs:
    - url: хост сервиса в формате HTTP(S)://HOST.
    - key: API-ключ для сервиса.
  - navi: настройки доступа к сервису Navigation API:
    - url: хост сервиса в формате HTTP(S)://HOST.
    - key: API-ключ для сервиса.
  - resources: настройки вычислительных ресурсов для сервиса. Актуальная информация о том, как узнать рекомендуемые ресурсы, представлена в документе Системные требования.
Разверните сервис с помощью Helm, используя подготовленный конфигурационный файл values-platform.yaml:
```
helm upgrade --install --version=1.21.0 --atomic --values ./values-platform.yaml platform 2gis-on-premise/platform
```

4. Проверьте работоспособность установленного сервиса

Перейдите по адресу https://platform.example.com в браузере. Вы должны успешно войти в веб-интерфейс. Далее вы можете проверить статус работы установленных сервисов на странице Мониторинг и протестировать работу ключевых API на странице Песочницы.

Что дальше?

Узнайте, как обновить сервис:

Обновление Platform Manager