Установка сервиса лицензий
1. Перед установкой
-
Ознакомьтесь с основной информацией:
-
Убедитесь, что выполнены необходимые предварительные шаги:
-
Соберите необходимые данные, заданные или полученные на предыдущих шагах:
Объект Значение Как получить значение Ключ лицензии на программный комплекс 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ГИС:
Узнайте, как обновить сервисы: