Подготовка к установке

Перед началом получения артефактов установки необходимо:

получить лицензию на программный комплекс 2ГИС,
подготовить сетевую инфраструктуру,
добавить Helm-репозиторий.

Получение лицензии на программный комплекс 2ГИС

Для доступа к репозиторию с артефактами установки необходима лицензия на программный комплекс 2ГИС (см. Ключи и токены).

Заполните форму на сайте 2ГИС.
Получив лицензионный ключ, укажите его в конфигурационном файле 2GIS CLI.

Подготовка сетевой инфраструктуры

Рекомендуемая инфраструктура для работы сервисов программного комплекса 2ГИС состоит из публичной и приватной сетей. В таблице ниже описан пример такой инфраструктуры с доменами example.com и example.local. Все компоненты должны быть развёрнуты в одном кластере Kubernetes, управляемом с хоста example.com.

Компонент инфраструктуры	Кто должен иметь доступ	Тип сети	Домены, используемые в документации
Инфраструктура доставки артефактов	Администратор инфраструктуры	Публичная	`example.com`
Реестр Docker для хранения образов сервисов	Утилита 2GIS CLI с хоста `example.com`	Публичная	`docker.example.com`
Хранилище артефактов установки	Утилита 2GIS CLI с хоста `example.com`	Публичная	`artifacts.example.com`
Фронтенды сервисов	Приложения и конечные пользователи в приватной сети	Приватная	`*.example.com`
Бэкенды сервисов	Другие сервисы и хранилища из всех подов кластера Kubernetes	Приватная	`*.example.local`
Хранилища данных	Другие сервисы и хранилища из всех подов кластера Kubernetes	Приватная	`*.storage.example.local`

Примечание

Если для развёртывания продукта используется Managed Kubernetes (Kubernetes as a Service), убедитесь, что доступ к реестру Docker настроен с использованием протокола HTTPS и сертификата, подписанного доверенным центром сертификации (например, Let’s Encrypt).

Добавление Helm-репозитория

Для установки каждого конкретного продукта 2ГИС используется Helm-чарт из репозитория программного комплекса 2ГИС. Необходимо добавить этот репозиторий на хосте, с которого будет выполняться установка продуктов. В примере, описанном выше, это хост example.com.

Установите в кластер менеджер пакетов Helm. Для этого воспользуйтесь официальными инструкциями по установке.

Добавьте репозиторий с Helm-чартами 2ГИС:

helm repo add 2gis-on-premise https://2gis.github.io/on-premise-helm-charts
helm repo update

Проверьте корректность установки Helm и репозитория, выполнив команду:
```
helm search repo 2gis-on-premise
```
Если вывод команды содержит непустой список чартов, то всё настроено корректно.

Что дальше?

Получите артефакты установки