Установка сервиса лицензий

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

Ознакомьтесь с основной информацией:
- Архитектура программного комплекса 2ГИС
- Системные требования
Убедитесь, что выполнены необходимые предварительные шаги:
1. Подготовка к установке
2. Получение артефактов установки

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

Объект	Значение	Как получить значение
Ключ лицензии на программный комплекс 2ГИС	`DEMO-KEY-DGCTL-AAAAAA-BBBBBB`	См. Подготовка к установке
Эндпоинт S3-совместимого хранилища артефактов установки	`artifacts.storage.local`	См. Получение артефактов установки
Имя бакета для хранения артефактов	`dgctl-store`	См. Получение артефактов установки
Идентификатор ключа для доступа к артефактам установки	`AKIAIOSFODNN7EXAMPLE`	См. Получение артефактов установки
Секрет ключа для доступа к артефактам установки	`wJalrXUtnFEMIK7MDENGbPxRfiCYEXAMPLEKEY`	См. Получение артефактов установки
Реестр Docker для хранения образов сервисов	`http://docker.registry.local:5000`	См. Получение артефактов установки
Имя пользователя для реестра Docker	`registry`	См. Получение артефактов установки
Пароль для реестра Docker	`DOCKERregistryP@ssW0rd`	См. Получение артефактов установки

2. Получите лицензию

В качестве хранилища для лицензии могут быть использованы S3-совместимое или обычное файловое хранилище.

Выполните следующие действия в зависимости от выбранного типа хранилища.

Для операций с лицензиями используется конфигурационный файл утилиты 2GIS CLI. Описание всех параметров представлено в Конфигурационном файле 2GIS CLI.

Запись лицензии в S3-совместимое хранилище

Создайте конфигурационный файл dgctl-config.yaml:

dgctl-config.yaml

key: DEMO-KEY-DGCTL-AAAAAA-BBBBBB
log-format: json

storage:
    type: s3
    host: artifacts.storage.local
    bucket: dgctl-store
    access-key: AKIAIOSFODNN7EXAMPLE
    secret-key: wJalrXUtnFEMIK7MDENGbPxRfiCYEXAMPLEKEY

docker:
    registry:
        username: registry
        password: DOCKERregistryP@ssW0rd
        server-address: http://docker.registry.local:5000
        image-prefix: /

Запустите утилиту 2GIS CLI:

docker run --rm \
    -v $(pwd)/dgctl-config.yaml:/dgctl-config.yaml \
    -v /mnt/dgctl-source:/dgctl-source \
    2gis/dgctl:latest \
    license --config=/dgctl-config.yaml

Запись лицензии в файловое хранилище

Создайте конфигурационный файл dgctl-config.yaml:

dgctl-config.yaml

key: DEMO-KEY-DGCTL-AAAAAA-BBBBBB
log-format: json

storage:
    type: fs
    directory: /directory

docker:
    registry:
        username: registry
        password: DOCKERregistryP@ssW0rd
        server-address: http://docker.registry.local:5000
        image-prefix: /

Запустите утилиту 2GIS CLI:

docker run --rm \
    -v $(pwd)/dgctl-config.yaml:/dgctl-config.yaml \
    -v /mnt/dgctl-source:/dgctl-source \
    2gis/dgctl:latest \
    license --config=/dgctl-config.yaml

Копирование лицензии из файлового хранилища в S3-совместимое хранилище

Создайте конфигурационный файл dgctl-config.yaml:

dgctl-config.yaml

key: DEMO-KEY-DGCTL-AAAAAA-BBBBBB
log-format: json

storage:
    type: s3
    host: artifacts.storage.local
    bucket: dgctl-store
    access-key: AKIAIOSFODNN7EXAMPLE
    secret-key: wJalrXUtnFEMIK7MDENGbPxRfiCYEXAMPLEKEY

docker:
    registry:
        username: registry
        password: DOCKERregistryP@ssW0rd
        server-address: http://docker.registry.local:5000
        image-prefix: /

Запустите утилиту 2GIS CLI:

docker run --rm \
    -v $(pwd)/dgctl-config.yaml:/dgctl-config.yaml \
    -v /mnt/dgctl-source:/dgctl-source \
    2gis/dgctl:latest \
    license --config=/dgctl-config.yaml --from-file=/directory/license

3. Установите сервис лицензий

Для установки сервиса лицензий используется Helm-чарт. Описание всех параметров представлено в values.yaml.

Чтобы установить сервис лицензий:

Создайте конфигурационный файл values-license.yaml:
values-license.yaml
```
dgctlDockerRegistry: ''
license:
    updatePeriod: 1h
    retryPeriod: 30s
    softBlockPeriod: 2w
```
Где:
- dgctlDockerRegistry: эндпоинт вашего реестра Docker, в котором находятся образы сервисов программного комплекса 2ГИС. Пример: HOST:PORT.
- license: настройки сервиса лицензий.
  - updatePeriod: как часто проверять наличие лицензии. Значение в формате 'time.ParseDuration'.
  - retryPeriod: через какой период времени повторить проверку лицензии, если предыдущая проверка не удалась.
  - softBlockPeriod: за какой период времени появляется уведомление об истечении срока лицензии. Поддерживаются дополнительные единицы измерения времени: d для дней и w для недель.
Установите сервис с помощью Helm, используя подготовленный конфигурационный файл values-license.yaml:
```
helm upgrade --install --version=1.4.5 --atomic --values ./values-license.yaml license 2gis-on-premise/license
```

Что дальше?

Установите другие продукты программного комплекса 2ГИС:

Сервис API-ключей.

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

Обновление сервиса лицензий