Как скачать и обновлять Суперапп

Пользователи могут скачать клиентские приложения следующими способами:

1. С сайта https://workspace.vk.ru/download/

2. Из Snapcraft — https://snapcraft.io/vkworkspace

3. Со страницы https://dl.<сайт_компании>, которая доступна после установки Мессенджера.

   Например, если сайт вашей компании — mycompany.com, то скачать Суперапп можно со страницы https://dl.mycompany.com.

Обратите внимание на варианты работы с приложением VK WorkSpace на iOS и macOS, если оно временно недоступно в официальном магазине App Store:

• Ранее установленные приложения продолжают работать, однако перестали приходить push-уведомления.

  Предупредите ваших сотрудников, чтобы они не удаляли и не переустанавливали мобильное приложение. Из-за отсутствия приложения в магазине App Store повторная установка на телефон будет невозможна.

  Чтобы возобновить получение push-уведомлений от Почты на телефонах, пользователи могут добавить ярлык сервиса на главный экран телефона. Как это сделать, описано в инструкции для пользователей.

• Если же приложение не было установлено ранее, следуйте рекомендациям ниже.

Ваши сотрудники могут:

• Пользоваться веб-версией Супераппа в браузере.

• Пользоваться десктопной версией, которую сотрудник может самостоятельно скачать (dmg-файл) и установить напрямую с официальной страницы workspace.vk.ru/download.

Если в вашей компании развертывание ПО автоматизировано или выполняется ИТ-отделом:

1. Скачайте дистрибутив с официальной страницы workspace.vk.ru/download.

2. Выполните проверку контрольной суммы (хэш-суммы) по алгоритму sha256. Для этого скачайте файл с контрольной суммой по ссылке.

3. Выполните команду для дистрибутива:

    
   shasum -a 256 <имя дистрибутива (файла dmg)>

   И сверьте с данными из файла с контрольной суммой.

4. Далее используйте альтернативные методы управления запуском на macOS:

   • Удаление флага карантина через Терминал:

     Обойти стандартные проверки безопасности macOS для конкретного приложения можно с помощью команды:

      
     xattr -d com.apple.quarantine VK\ WorkSpace.app

   • Использование корпоративного Self Service:

     Так как инструмент корпоративного управления Self Service обладает правами локального администратора на устройствах сотрудников, установка и первый запуск приложения через него проходят без вызова предупреждений от macOS.

Сотрудники могут пользоваться веб-версиями отдельных сервисов VK WorkSpace в мобильном браузере:

• Почтой.
• Календарем.
• Диском.
• Мессенджером с Задачами.

Чтобы получать push-уведомления от Почты, сотрудники могут добавить ярлык сервиса на главный экран телефона по инструкции.

Приложение VK WorkSpace недоступно в Google Play. Установленные приложения продолжат работать. Чтобы пуш-уведомления приходили корректно, настройте их отправку на сервере по инструкции.

Для того чтобы своевременно обновлять приложение VK WorkSpace, пользователям нужно установить магазин приложений RuStore.

Сводка по действиям администратора:

1. Настройте отправку пуш-уведомлений на сервере VK WorkSpace по инструкции.

2. После этого перешлите сотрудникам рекомендации по установке RuStore, чтобы они могли обновлять приложение до актуальной версии:

   2.1. Установить RuStore, если его еще нет на устройстве (инструкция, как установить RuStore).

   2.2. Открыть RuStore на смартфоне и авторизоваться в профиле. Войти можно любым удобным способом (инструкция по авторизации).

   2.3. Найти приложение VK WorkSpace в поиске RuStore и установить его. Если приложение VK WorkSpace уже установлено, обновить его до актуальной версии.

Ознакомьтесь с этим разделом, если в вашей компании ограничен доступ в интернет или если вы хотите размещать сборки клиентского приложения во внутреннем контуре.

Начиная с версии 26.2 сборки клиентского приложения не поставляются в составе дистрибутива Мессенджера. Чтобы пользователи смогли установить Суперапп из внутреннего контура:

1. Скачайте архивы сборок:

   • Windows — https://hb.bizmrg.com/vkteams-www/on-premise/win/x64/vkworkspace.tar.gz
   • Linux — https://hb.bizmrg.com/vkteams-www/on-premise/linux/x64/vkworkspace.tar.gz
   • macOS — https://hb.bizmrg.com/vkteams-www/on-premise/mac/x64/vkworkspace.tar.gz

2. Распакуйте подготовленные архивы во внутреннее хранилище.

3. Перейдите в конфигурационный файл /usr/local/nginx-im/html/myteam/myteam-config.json.

4. В секции apps в полях url укажите ссылки на внутреннее хранилище. Пример заполнения ссылок описан в шаге 5.

   В полях full_version укажите номер версии сборки, который видно после распаковки архива:

    
   {  "apps": {    "linux_x64": {      "full_version": "26.2.10.100481",      "url": "https://dl.<ваш домен>.ru/downloads/linux/x64/26.2.10.100481",    },    "mac_x64": {      "full_version": "26.2.10.100480",      "url": "https://dl.<ваш домен>.ru/downloads/mac/x64/26.2.10.100480",     },    "win_x64": {      "full_version": "26.2.10.100482",            "url": "https://dl.<ваш домен>.ru/downloads/win/x64/26.2.10.100482",    }  }}

5. Перейдите в конфигурационный файл /srv/myteam-onpremise-www/htdocs/dl-config.json и укажите там ссылки на внутреннее хранилище:

    
   {    "window-build-links": {        "msi": "<myteam-config.apps.win_x64.url>/vkworkspace.msi"    },    "linux-build-links": {        "tar": "<myteam-config.apps.linux_x64.url>/vkworkspace.tar.xz",        "rpm": "<myteam-config.apps.linux_x64.url>/vkworkspace.rpm",        "deb": "<myteam-config.apps.linux_x64.url>/vkworkspace.deb"    },    "macos-build-links": {        "dmg": "<myteam-config.apps.mac_x64.url>/vkworkspace.dmg"    }}

   где:

   • myteam-config.apps.win_x64.url — значение поля url из секции win_x64 в файле myteam-config.json.
   • myteam-config.apps.linux_x64.url — значение поля url из секции linux_x64 в файле myteam-config.json.
   • myteam-config.apps.mac_x64.url — значение поля url из секции mac_x64 в файле myteam-config.json.

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

   Вы скачали архивы со сборками и распаковали их во внутреннее хранилище, после распаковки архивов:

   • для Linux, появится каталог .../linux/x64/26.2.10.100480
   • для Windows — каталог .../win/x64/26.2.10.100482
   • для macOS — каталог .../x64/26.2.10.100481

   Все сборки уникальны, версии сборок не повторяются, для каждой операционной системы своя версия.

   Укажите в конфигурационных файлах ссылки на ваше внутреннее хранилище и номер версии из каталога. Если вы укажете для разных операционных систем одинаковые версии, пользователи не смогут скачать Суперапп на странице https://dl.<сайт_компании>.

6. Для инсталляции на одну виртуальную машину выполните команду:

    
   HELMWAVE_USE_LOCAL_REPO_CACHE=true hwup -t godmod

   Для кластерной инсталляции:

    
   HELMWAVE_USE_LOCAL_REPO_CACHE=true HELMWAVE_ENV_NAME=cluster hwup -t godmod

7. Перезапустите под в технологическое окно (может приводить к сбою в новых подключениях):

    
   kubectl delete pods -n vkteams -l app=myteam-admin

После этих настроек пользователи смогут получить Суперапп на странице https://dl.<сайт_компании>.

Суперапп постоянно обновляется на публичных ресурсах, поэтому версия Супераппа на ресурсах для скачивания может отличаться от вашей версии бэкенда. Поддерживается совместимость Супераппа с текущей и двумя предыдущими версиями бэкенда Мессенджера.

Вы можете управлять обновлением Супераппа для вашей инсталляции — обновляться до самой новой версии (настройки по умолчанию) или до конкретной версии.

По умолчанию в веб-интерфейсе установщика указаны ссылки на публичное облако, чтобы Суперапп обновлялся до самой последней версии. Чтобы настроить обновление до конкретной версии:

1. В веб-интерфейсе установщика Проекты → vkteams → apps укажите в полях url ссылки на конкретные версии в публичном облаке. Пример для операционной системы Windows: https://hb.bizmrg.com/vkteams-www/win/x64/26.2.0.87324

2. В полях full_version укажите конкретную версию, в нашем примере это «26.2.0.87324».

3. Нажмите на кнопку Сохранить настройки и запустите автоматическую установку.

Вы можете запретить пользователям использовать Суперапп, версия которого ниже минимально поддерживаемой (устанавливается администратором организации). Подробнее — в документации.

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

Обновление не будет работать, если:

• Указаны неверные ссылки в myteam-config.json или по ссылкам нет файлов.
• Файлы не доступны по HTTP(S) – например, из-за неверный настроек HTTP-сервера или у файлов нет доступа не чтение.
• По ссылками разложено не содержимое архива (отсутствует version.json), а сборки, скаченные по пользовательским ссылкам.
• При включенном ГОСТ-шифровании, ссылки на публичное облако https://hb.bizmrg.com/vkteams-www/ не внесены в исключение доменов.

В случае использования ГОСТ-шифрования все внешние адреса (все адреса вне mycompany.com) должны быть внесены в исключение в параметре gost-host-regexes в файле /usr/local/nginx-im/html/myteam/myteam-config.json:

 
"gost-host-regexes" : ".*" # по-умолчанию ходим по ГОСТ по всем адресам

Добавление исключений:

 
"gost-host-regexes" : ".*gost-(e|vkteams-calendar|cloud)\\.mycompany\\.com" # ходим по ГОСТ только по внутренним адресам mycompany.com. Внешние адреса без поддержки ГОСТ работают

Подробнее про ГОСТ-шифрование и параметр gost-host-regexes — в документации.

Технический писатель: Белова Ирина