Перейти к содержанию

Установка веб-клиента

Внимание!

  • Веб-клиент устанавливается на сервер после установки docker-ce и docker-compose.

  • Веб-клиент устанавливается только совместно с ETS-сервером!

Для установки веб-клиента:

  1. Запустите командную строку.
  2. Подключитесь к репозиторию разработчика в Docker для скачивания контейнеров.

    Примечание

    В качестве логина и пароля используются Login и Password, которые выдаются разработчиком.

    docker login -u Login -p Password registry.public.express
    
  3. Создайте рабочий каталог веб-клиента.

    mkdir -p /opt/web_client
    cd /opt/web_client
    dpl --init web 
    

    После выполнения команды dpl --init web создается файл settings.yaml.

  4. Установите цепочки сертификатов и ключа SSL.

    • при использовании собственного сертификата создайте директорию для сертификатов.

      Внимание!

      Имя файла сертификата и имя ключа должны соответствовать примеру ниже.

      mkdir -p nginx/certs
      cp /somewhere/my-certificate-chain.crt nginx/certs/nginx.crt
      cp /somewhere/my-unencrypted-key.key nginx/certs/nginx.key
      
      Конструкции /somewhere/my-certificate-chain.crt и /somewhere/my-unencrypted-key.key индивидуальны для каждого конкретного случая.

      Конструкции nginx/certs/nginx.crt и nginx/certs/nginx.key являются обязательными.

      Требования к сертификатам см. в инструкции "Требования к сертификату".

    • при использовании сертификата от Let's Encrypt в файл settings.yaml добавьте параметр le_email: admin@company-mail.ru

      Проверка подключения сертификатов после инсталляции описана в инструкции "Проверка сертификатов".

  5. Сгенерируйте файл dhparam с помощью команды:

    openssl dhparam -out /opt/express/web_client/certs/dhparam.pem 2048
    
  6. Созданный по умолчанию файл конфигурации имеет следующий вид и требует редактирования:

    ccs_host: somehost.somedomain.sometld
    web_client_config: ''
    

    Пример заполнения конфигурации:

    ccs_host: example.com
    le_email: test@example.com
    web_client_enabled: true
    web_client_config:
    regions:
        ru:
        host: rts1dev.ccsteam.ru
        prefix: 7
        ae:
        host: rts2dev.ccsteam.ru
        prefix: 971
    sentryDSN: https://sentryToken@sentry.ccsteam.ru/58
    ccsHost: corp.express
    ctsWeb: false
    locales: ["en","ru","de","fr","es"]
    platformPackageId: ru.unlimitedtech.express
    gcmSenderId: senderId
    landingUrl: https://express.ms/mobile-corp-express
    allowCtsLogin: true
    allowDebugInfo: true
    gmapsApiKey: apiKeyapiKeyapiKey
    environment: dev
    actionTaskFeature: true
    changelogUrl: https://dl.express.ms/changelog/changelog-{}.md
    images:
    web_client: registry.public.express/web_client:develop 
    
  7. В каталоге /opt/express/web_client выполните команду:

    dpl -d