Сервис лицензий | On-Premise | 2GIS Documentation
On-Premise

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

  1. Ознакомьтесь с основной информацией:

  2. Убедитесь, что выполнены необходимые предварительные шаги:

    1. Подготовка к установке
    2. Получение артефактов установки
  3. Соберите необходимые данные, заданные или полученные на предыдущих шагах:

    Объект Значение Как получить значение
    Ключ лицензии на программный комплекс 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 См. Получение артефактов установки

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

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

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

  1. Создайте конфигурационный файл 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: /
    
  2. Запустите утилиту 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
    
  1. Создайте конфигурационный файл 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: /
    
  2. Запустите утилиту 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
    
  1. Создайте конфигурационный файл 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: /
    
  2. Запустите утилиту 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
    

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

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

  1. Создайте конфигурационный файл 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 для недель.
  2. Установите сервис с помощью Helm, используя подготовленный конфигурационный файл values-license.yaml:

    helm upgrade --install --version=1.4.5 --atomic --values ./values-license.yaml license 2gis-on-premise/license
    

Что дальше?

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

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