{"type":"doc","content":[{"type":"table","attrs":{"layout":"full-width","localId":"665a285a-f3d4-4e56-8556-cfae6413713d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Тип статьи","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"text":"Полезные знания","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Компетенции","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"text":"Администратор","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Необходимые права","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"text":"root","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Версия платформы","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"text":"2.24","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Статус","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"yellow","style":"bold","text":"Бета","localId":"de5ea2e7-df3e-440f-bc1d-9f544ec0386f"}}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Сложность ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#abf5d1","rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph","content":[{"text":"легко","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[353.0]},"content":[{"type":"paragraph","content":[{"text":"Дополнительные сведения","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1039.0]},"content":[{"type":"paragraph"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"1. Логин в Яндекс Регистре с помощью iam токена","type":"text"}]},{"type":"rule"},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"docker login \\\n --username iam \\\n --password \\\n cr.yandex","type":"text"}]},{"type":"paragraph","content":[{"text":"Вместо ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" подставляем свой токен вида ","type":"text"}]},{"type":"paragraph","content":[{"text":"tgoih3j4tug390gj34ghj390o85ytug30pough5jio3eg5034u9ty053p4wujgh45ophjg0459oyuhgj45hg04589ugjeoipwjgk590gjw4959u999t99jw4ejg5904wguj","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Команду вполне возможно придется вводить с sudo, особенно, если run.sh запускает тоже с sudo. Иначе run.sh покажет ошибку авторизации, как будто не видит факта успешного логина.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"2. Healthchecks","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"У трех докер контейнеров есть хелсчеки, это ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"portal","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"export-service","type":"text","marks":[{"type":"strong"}]},{"text":". В некоторых ситуациях, например, при чрезмерной загрузке ресурсов сервера, healthchecks могут вызывать перезапуски этих контейнеров. Ниже пример из platform.yml для увеличения интервалов и кол-ва попыток для принудительного предотвращения перезапуска контейнеров.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Пример из YML","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"admin:\n image: ${DOCKER_REPO_PREFIX}${ADMIN_TAG}\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:80/health\"]\n interval: 30s\n timeout: 960s\n retries: 50\n start_period: 40s\n depends_on:\n - proxy\n - mongodb\n volumes:\n - /etc/localtime:/etc/localtime:ro\n - database-backups:/visiology/database_backups\n - hardwareid:/visiology/admin/app/license/keys/hardwareid\n - /docker-volume/admin/portalImages:/visiology/admin/portalImages\n - /docker-volume/admin/useFiscalCalendar:/visiology/admin/useFiscalCalendar\n environment:\n - VPROXY_URL=${PLATFORM_URL:-proxy}\n - POLICY=${POLICY}\n labels:\n component: \"admin\"\n secrets:\n - MONGO_AUTH_USER\n - MONGO_AUTH_PASSWORD\n << : *deploy_platform\n << : *logging_options\n portal:\n image: ${DOCKER_REPO_PREFIX}${PORTAL_TAG}\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:80/health\"]\n interval: 30s\n timeout: 960s\n retries: 50\n start_period: 40s\n depends_on:\n - dashboard-viewer\n volumes:\n - /etc/localtime:/etc/localtime:ro\n labels:\n component: \"portal\"\n << : *deploy_platform\n << : *logging_options","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"3. Скрипты, упрощающие работу","type":"text"}]},{"type":"rule"},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"89db1a99-2311-4936-8a1a-f00445ce1232","collection":"contentId-2982086","type":"file"}},{"type":"media","attrs":{"id":"8a8f3422-6ef0-44c4-bbcc-9049dda1430c","collection":"contentId-2982086","type":"file"}},{"type":"media","attrs":{"id":"967103b1-1136-4295-8b2c-f8c5f954dbac","collection":"contentId-2982086","type":"file"}}]},{"type":"paragraph","content":[{"text":"install-docker-ubuntu.sh","type":"text","marks":[{"type":"strong"}]},{"text":" | Установка последней версии Docker и Docker-Compose на Ubuntu. После выполнения установки нужно перезайти в терминал.","type":"text"},{"type":"hardBreak"},{"text":"remove_visiology.sh","type":"text","marks":[{"type":"strong"}]},{"text":" | Удаление Visiology (сервисы, подсети, тома, образы). Подходит только, если на Docker работает исключительно платформа, т. к. может удалить ваши дополнительные Docker ресурсы.","type":"text"},{"type":"hardBreak"},{"text":"mongorestore.sh ","type":"text","marks":[{"type":"strong"}]},{"text":"| Быстрое восстановление БД на основе имеющегося дампа. ВАЖНО: В переменной ","type":"text"},{"text":"BKP_PATH","type":"text","marks":[{"type":"code"}]},{"text":" задаём название директории с выбранным бэкапом из папки /var/lib/docker/volumes...","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"4. Долгий запуск докер сервисов в закрытом контуре","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Если сервер платформы не имеет выхода в интернет, то есть вероятность, что докер сервисы будут стартовать очень долго. Связано это с недоступностью DNS серверов.","type":"text"}]},{"type":"paragraph","content":[{"text":"Глубокого исследования в работе этого механизма не проводилось. Есть только некоторые заметки ниже.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Если мы явно заблокируем DNS сервера, например на прокси, то запуск будет быстрый. Связано это с тем, что пакеты моментально отклоняются правилами и никакого ожидания не происходит.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"В ином случае много зависит от инфраструктуры, через что запросы на DNS проходят (фаерволлы, маршрутизаторы). Здесь уже большая вероятность в необходимости ожидания таймаута. В разных средах запуск одного сервера может занимать от секунды до десятка секунд и выше. Если умножить на кол-во Docker сервисов, то такие такое время перезапуска платформы может быть не приемлемо.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"По всей видимости при создании сервисов Docker обращается по своим делам в реестр. В случае с платформой на момент написания этой заметки используется Яндекс регистр образов с адресом cr.yandex.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Выбор решения зависит от предпочтений администратора сервера. Универсальных быстрых решения два:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Прописать в /etc/hosts сервера с платформой следующую строчку:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"127.0.0.1 cr.yandex","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Добавить параметр к разворачиванию стека ","type":"text"},{"text":"--resolve-image never","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" в run.sh. Кусочек скрипта с добавленным флагом ниже:","type":"text"}]},{"type":"codeBlock","content":[{"text":"eval ${ENVIRONMENT_VARIABLES} docker stack deploy --resolve-image never ${composeFilesString} ${STACK_NAME}","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Если для сервера в будущем откроется выход в Интернет (хотя бы к cr.yandex) в том числе для выкачивания Docker образов напрямую из Яндекс регистра, эту запись в hosts естественно нужно убрать.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"5. Проверка SMTP","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://adminkit.net/smtp_diag_tool.aspx"}},{"text":" | Для случаев, если не удается настроить SMTP клиент в платформе, и нужно понять, какие параметры поддерживает почтовый сервер.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"6. Список всех опубликованных дашбордов","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Для просмотра списка всех опубликованных дашбордов, можно воспользоваться следующим запросом:","type":"text"},{"type":"hardBreak"},{"text":"GET http://адрес_платформы/admin/api/webAppDashboards","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"7. Favicon","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Чтобы поменять иконку, можно в nginx в каждом location, где своя иконка, прописать ","type":"text"}]},{"type":"codeBlock","content":[{"text":"sub_filter '/папка_модуля/favicon.ico' '/viewer/custom/favicon.ico'","type":"text"}]},{"type":"paragraph","content":[{"text":"А сам favicon.ico положить в customjs папку","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"8. Проблема с часовыми поясами в ViQube","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Бывает происходит такая ситуация, что при запросе данных в каком-то менеджере СУБД из SQL вы получаете одни данные, а при запросе тех же данных в загрузчике ViQube вы получаете другие данные (итоговое значение меньше).","type":"text"},{"type":"hardBreak"},{"text":"Как выяснилось это происходит из-за того, что ваш СУБД менеджер как правило работает под вашим локальным часовым поясом, а загрузчик ViQube работает в GMT поясе (Гринвич). Если быть конкретнее, то функции, которые используются в SQL запросе, например now() покажут разное время и в следствии чего запрос вернёт различные данные. Сам же сервер СУБД обычно работает в вашем же поясе, либо данные которые ему поступают идут с датой и временем из вашего пояса.","type":"text"}]},{"type":"paragraph","content":[{"text":"Например вы хотите вернуть суммарные значения за предыдущий час, ваш часовой пояс МСК, вы выполняете в менеджере:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"select sum(value) from \"testTimeZones\" ttz\nwhere date > now() - interval '1 hours'","type":"text"}]},{"type":"paragraph","content":[{"text":"В ответ получаете ожидаемое значение.","type":"text"},{"type":"hardBreak"},{"text":"Далее выполняете такой-же запрос в загрузчике и что происходит. JDBC драйвер в загрузчике выполняет функцию now() из под пояса GMT, т.е. он -3 с МСК. Запрос который отправится на сервер будет иной, т.к. now() будет -3 часа и собственно данные которые придут в ответ будут другие, значение будет меньше.","type":"text"}]},{"type":"paragraph","content":[{"text":"Чтобы этого избежать, можно прокинуть файл timezone в контейнер ViQube, т.к. Java машина ориентируется на него. После этого JDBC драйвер будет знать ваш часовой пояс и now() будет возвращать такую же дату как и в менеджере.","type":"text"},{"type":"hardBreak"},{"text":"Чтобы это сделать, необходимо открыть файл viqube.yml и в блок volumes в конец добавить строчку:","type":"text"}]},{"type":"codeBlock","content":[{"text":"- /etc/timezone:/etc/timezone:ro","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":484,"id":"cf452247-6d59-4b66-a8dc-36f7838ec7c0","collection":"contentId-2982086","type":"file","height":187}}]},{"type":"paragraph","content":[{"text":"Далее перезапускаем платформу и проверяем.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"9. Оффлайн карта для Leaflet","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"По умолчанию leaflet работает с онлайн ресурсами, по умолчанию используется такой адрес: https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png","type":"text"},{"type":"hardBreak"},{"text":"Но как быть если на сервере отсутствует выход в интернет? Для этого необходимо скачать карту, точнее её участок себе на внутренний ресурс либо в папку customjs.","type":"text"}]},{"type":"paragraph","content":[{"text":"Для этого нам понадобится следующее ПО - ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://wiki.openstreetmap.org/index.php/JTileDownloader"}},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Переходим по ссылке и скачиваем последнюю версию. Распаковываем и запускаем, тут надо учесть один нюанс, программа написана на Java и требует установленной явы машины.","type":"text"},{"type":"hardBreak"},{"text":"После запуска нас интересует несколько полей:","type":"text"}]},{"type":"paragraph","content":[{"text":"Paste URL","type":"text","marks":[{"type":"strong"}]},{"text":" - тут вводим ссылку нужного участка, ссылку можно взять с ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.openstreetmap.org/"}},{"text":" единственное, её придётся подредактировать. ","type":"text"},{"type":"hardBreak"},{"text":"Нам нужна ссылка такого вида - https://www.openstreetmap.org/?lat=54.127&lon=42.330&zoom=7&","type":"text"},{"type":"hardBreak"},{"text":"А опенстритмап отдаёт такой вариант - https://www.openstreetmap.org/#map=7/54.127/42.330","type":"text"},{"type":"hardBreak"},{"text":"Поэтому просто копируем, приводим к нужному виду и вставляем в поле.","type":"text"}]},{"type":"paragraph","content":[{"text":"Radius (km) ","type":"text","marks":[{"type":"strong"}]},{"text":"- радиус скачивания тайлов (участков карты).","type":"text"}]},{"type":"paragraph","content":[{"text":"Output zoom level ","type":"text","marks":[{"type":"strong"}]},{"text":"- уровень зума.","type":"text"}]},{"type":"paragraph","content":[{"text":"Output zoom levels ","type":"text","marks":[{"type":"strong"}]},{"text":"- дополнительные уровни зума.","type":"text"}]},{"type":"paragraph","content":[{"text":"Outputfolder ","type":"text","marks":[{"type":"strong"}]},{"text":"- каталог в который будут загруженны тайлы.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":298,"id":"f2718815-f73a-417e-b3e2-07ef863d1885","collection":"contentId-2982086","type":"file","height":433}}]},{"type":"paragraph","content":[{"text":"После настройки нажимаем на Download Tiles и ждём, если участок карты достаточно большой, скачивание займёт приличное время.","type":"text"}]},{"type":"paragraph","content":[{"text":"После скачивания мы получим структуру папок: уровень_зума/x/y.png","type":"text"}]},{"type":"paragraph","content":[{"text":"Данную структуру следует залить на ваш внутренний ресурс или в папку customjs на сервере. Далее в коде меняем url карты, если это customjs то урл будет примерно такой:","type":"text"},{"type":"hardBreak"},{"text":"https://example.visiology.su/viewer/custom/tiles/{z}/{x}/{y}.png","type":"text"}]},{"type":"paragraph","content":[{"text":"Готово! Теперь карта будет загружаться с вашего ресурса.","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"10. Запуск Dashboard Designer без прав администратора","type":"text"}]},{"type":"rule"},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Скачиваем DD: address_of_platform/admin/api/downloadDesigner.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Распаковываем, создаём ярлык exe файла.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Добавляем в target ярлыка(через пробел) “http(s)://address_of_platform/admin”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запускаем.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Таким образом можно запускать Дизайнер без установки лаунчера в Program Files и без доступа на запись в ProgramData. Но нужно не забывать соблюдать версионность: после обновления платформы нужно все шаги повторить, чтобы версии Дизайнера и платформы совпадали. В обычной установке за этим следит лаунчер, здесь нужно самостоятельно.","type":"text"}]}]}],"version":1}

Браузер не поддерживается