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

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

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

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

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

1. Заполните форму на dev.2gis.ru.
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.

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

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

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

3. Проверьте корректность установки Helm и репозитория, выполнив команду:

   helm search repo 2gis-on-premise

   Если вывод команды содержит непустой список чартов, то всё настроено корректно.

Что дальше?

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