Административные настройки¶

Интерфейс администрирования проекта предоставляет инструменты для настройки проекта OpenBioMaps, управления его пользователями и структурами данных, а также мониторинга связанных с проектом сервисов. Страницы, доступные администратору, зависят от его разрешений, конфигурации проекта, установленных модулей и серверного окружения.

На этой странице представлен обзор административных настроек и инструментов. Некоторые настройки влияют на доступ к данным проекта или изменяют базовую структуру базы данных. Поэтому администраторам следует внимательно проверять изменения и тестировать их перед применением в рабочем проекте.

Обзор документации по администрированию проекта см. в разделе Администрирование проекта.

Административный доступ¶

Раздел Административный доступ позволяет администраторам проекта делегировать отдельные административные функции группам пользователей. Каждую функцию, доступную через интерфейс администрирования проекта, можно назначить одной или нескольким группам.

Это обеспечивает детальный контроль над тем, кто может выполнять административные задачи. Например, в проекте можно определить следующие группы:

Администраторы пользователей, имеющие доступ к управлению пользователями и группами;
Кураторы данных, имеющие доступ к названиям видов, вложениям и инструментам управления данными; и
Редакторы форм загрузки, имеющие доступ к управлению формами загрузки.

Предоставляйте каждой административной роли только необходимые разрешения. Функции, изменяющие структуры базы данных, выполняющие SQL, управляющие правилами доступа или редактирующие исполняемый код, должны быть доступны только доверенным администраторам.

Таблицы и столбцы базы данных¶

Раздел Таблицы и столбцы базы данных используется для создания таблиц, представлений и столбцов SQL, связанных с проектом, и управления ими. Объекты, зарегистрированные через этот интерфейс, добавляются в метаданные OpenBioMaps и поэтому могут быть доступны формам загрузки, запросам, модулям и другим интерфейсам OpenBioMaps.

Таблицы и столбцы, созданные непосредственно с помощью стандартного клиента SQL, не регистрируются автоматически. Их также необходимо добавить в соответствующие метаданные OpenBioMaps, прежде чем ими можно будет пользоваться через веб-приложение.

Именование таблиц и столбцов¶

Используйте для названий таблиц и столбцов строчные буквы, цифры и символы подчёркивания. Избегайте пробелов, букв с диакритическими знаками, идентификаторов в кавычках и других специальных символов. Названия должны быть описательными и оставаться неизменными после того, как формы, запросы или модули начнут их использовать.

При создании таблицы или столбца всегда следует добавлять описание. Эти описания являются частью метаданных проекта и помогают пользователям понять смысл и предполагаемое назначение данных.

Регистрация доступных столбцов¶

Администраторы могут выбирать, какие столбцы будут доступны при создании форм загрузки и интерфейсов запросов. Столбец, существующий в PostgreSQL, но не зарегистрированный как доступный, не появится в этих интерфейсах автоматически.

Столбцам также можно назначать семантические роли. Эти роли позволяют OpenBioMaps и его модулям определять важные поля, не полагаясь на характерное для конкретного проекта название столбца. В зависимости от проекта и установленных модулей роли могут обозначать поля, содержащие:

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

Типы столбцов¶

Интерфейс администрирования предоставляет следующие задокументированные типы столбцов или семантические роли:

Data: Столбец данных общего назначения.
Spatial Geometry: Столбец геометрии, используемый для карт и пространственных операций.
Scientific Species Name: Столбец научного названия, используемый функциями управления таксонами.
Alternative Names: Столбец альтернативного названия, используемый функциями управления таксонами.
Date: Столбец даты или даты и времени, используемый фильтрами по дате.
Number of Individuals: Числовой столбец, используемый функциями сводной статистики.
Latitude/Longitude: Столбец координат, используемый для создания пространственной геометрии.
Citing: Столбец, связанный с цитированием и используемый функциями сводной статистики.
Attachment: Столбец, ссылающийся на вложения загруженных файлов.
UTM Zone: Столбец зоны UTM, используемый при создании пространственной геометрии из координат.

Описания столбцов и команды¶

Поле Comment содержит описание содержимого столбца. Рекомендуется добавлять содержательное описание, поскольку оно становится частью метаданных проекта.

Поле Command можно использовать для выполнения определённых операций или назначения настроек столбцу. К задокументированным командам относятся:

SET srid:4326: Назначить SRID 4326 столбцу obm_geometry. Замените 4326 на идентификатор пространственной системы координат, требуемый проектом.
SET use_rules:1: Включить обработку правил доступа для столбца obm_id.
RENAME:new_name: Переименовать столбец в new_name.
DROP: Удалить столбец.

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

Консоль SQL¶

Консоль SQL также доступна системным администраторам. Консоль SQL можно использовать для изменения или удаления данных проекта и структур базы данных. По этой причине доступ к интерфейсу таблиц базы данных следует предоставлять только доверенным пользователям, имеющим достаточный опыт работы с PostgreSQL и системного администрирования OpenBioMaps.

Выполненные в консоли SQL запросы можно сохранять и запускать повторно.

Консоль отображает результаты запроса в динамической таблице. Результаты таблицы запроса можно экспортировать в файл CSV. Если результаты запроса содержат более 1 000 строк, таблица больше не отображается; вместо неё автоматически создаётся экспорт CSV.

Управление представлениями¶

Таблицу данных можно заменить представлением, чтобы обеспечить настраиваемое представление её данных или улучшить определённый рабочий процесс. В соответствии с задокументированной процедурой создаётся схема с тем же названием, что и исходная таблица, исходная таблица перемещается в эту схему, а на её прежнем месте создаётся представление. Соответствующие правила INSERT, UPDATE и DELETE обеспечивают операции записи там, где они настроены.

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

Доступ к данным¶

Раздел Доступ к данным содержит сводную информацию о конфигурации доступа проекта и текущем состоянии правил построчного доступа. Администраторы могут просматривать уровни чтения и изменения, применяемые к проекту и его управляемым таблицам данных.

Интерфейс содержит:

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

Задокументированы следующие уровни доступа:

everybody: Доступ не ограничен только аутентифицированными пользователями.
logged-in users: Для доступа требуется аутентификация.
specified group members: Доступ контролируется с помощью групп проекта и более точных правил.

На фактический доступ к записи могут влиять правила уровня проекта, строки и столбца. Подробный обзор см. в разделе Доступ к данным.

Интерфейс доступен через Профиль > Администрирование проекта > Доступ к данным. Некоторые базовые значения по умолчанию также могут быть определены в конфигурационном файле проекта local_vars.php.inc.

Группы¶

Раздел Группы позволяет администраторам создавать группы пользователей проекта и управлять ими. Группы используются для назначения доступа к данным, формам загрузки, модулям и административным функциям.

Администраторы могут:

создать группу;
добавить пользователей в группу или удалить их из неё;
добавлять группы в другие группы там, где поддерживаются вложенные группы; и
использовать созданные группы в других интерфейсах управления доступом.

Вложенные группы позволяют создать многократно используемую и масштабируемую структуру разрешений. Тем не менее она должна оставаться достаточно простой, чтобы администраторы могли определить фактические разрешения отдельного пользователя.

Формы загрузки¶

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

Подробные инструкции см. в разделе Управление формами загрузки.

Функции¶

Раздел Функции предоставляет инструменты для просмотра правил и триггеров SQL, связанных с таблицами и представлениями проекта. Он содержит отдельные списки правил и триггеров, зарегистрированных для каждой таблицы, а также шаблоны для выбранных функций триггеров.

Интерфейс позволяет создавать, редактировать, включать и отключать следующие задокументированные типы триггеров:

триггеры списка таксонов;
триггеры истории; и
триггеры правил доступа.

Кроме того, здесь можно создавать и настраивать пользовательские триггеры и правила.

Триггеры базы данных выполняются автоматически при изменении данных. Неправильный триггер может отклонить допустимые изменения, неожиданно изменить данные или ослабить контроль доступа. Тестируйте изменённые функции триггеров перед их включением в рабочем проекте.

Триггер списка таксонов¶

Триггер списка таксонов добавляет ранее неизвестные научные названия из настроенного поля названия вида в таблицу таксонов проекта. Это может помочь поддерживать проект, список видов которого расширяется по мере добавления наблюдений.

Добавленные в таблицу таксонов названия видов теперь можно поддерживать через интерфейс управления названиями таксонов.

Административные настройки: названия видов

Триггер истории¶

Триггер истории регистрирует изменения, внесённые в записи целевой таблицы. Полученную историю можно отобразить через интерфейс истории данных записи.

Триггер правил доступа¶

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

Например, если форма загрузки предоставляет доступ на чтение группам A и B, а доступ на запись — группе C, триггер может добавить эти назначения в запись таблицы правил, связанную с каждой записью, созданной через эту форму.

Этот триггер важен для проектов, использующих ограничения доступа на уровне групп или строк. Его конфигурация должна соответствовать общим настройкам доступа проекта и схеме таблицы правил.

Дополнительную информацию см. в разделе Доступ к данным.

Названия видов¶

Раздел Названия видов предназначен для управления таблицей таксонов проекта. Названия видов можно отнести к следующим задокументированным категориям:

принятое название;
синоним;
общеупотребительное название; и
название с ошибкой.

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

Переводы¶

OpenBioMaps использует глобальные и относящиеся к конкретному проекту переводы.

Глобальные переводы¶

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

Локальные переводы¶

Локальные переводы позволяют проекту задавать собственный текст интерфейса. Ключи переводов используют префикс str_, после которого следует описательный идентификатор на английском языке. Например, проект может определить str_observations и предоставить его перевод на каждом активном языке.

Общедоступный пример находится по адресу:

https://openbiomaps.org/projects/checkitout/upload/?form=426&type=web

Модули¶

Модули расширяют функциональные возможности, доступные в проекте OpenBioMaps. Их конфигурация и требования к доступу зависят от конкретного модуля.

Модули расширяют функциональные возможности, доступные в проекте OpenBioMaps. Их конфигурация и требования к доступу зависят от конкретного модуля. Модули часто предоставляют основные функции, например интерфейсы текстового поиска на странице карты; в других случаях они предоставляют инструменты для выполнения определённых задач. Поведение модулей часто можно настраивать.

Дополнительную информацию см. в разделе Модули.

Прерванные загрузки¶

В разделе Прерванные загрузки перечислены сохранённые или незавершённые загрузки файлов и сеансы ввода данных через веб-формы. В зависимости от состояния прерванную загрузку можно восстановить или удалить.

Перед удалением загрузки администратор должен убедиться, что она больше не нужна. Прерванная загрузка может содержать работу, которую её владелец намерен продолжить.

Диспетчер файлов¶

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

К задокументированным функциям относятся:

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

Массовый экспорт обрабатывается как фоновое задание. После завершения обработки система предоставляет ссылку для скачивания созданного архива.

Доступ к функциям управления вложениями и их экспорта должен быть ограничен авторизованными пользователями. Экспортированные файлы по-прежнему подчиняются требованиям проекта в отношении доступа к данным и конфиденциальности.

Настройки запросов SQL¶

Раздел Настройки запросов SQL определяет шаблоны, используемые для формирования запросов к слоям MapServer и текстовых результатов запросов в веб-приложении. Эти шаблоны похожи на SQL, но содержат местозаполнители OpenBioMaps, которые динамически заменяются интерпретатором запросов.

Каждый шаблон запроса должен быть связан со слоем веб-карты. В mapfile MapServer слой WMS, использующий динамически созданный запрос, должен содержать определение DATA с местозаполнителем %query%.

Шаблоны запросов могут содержать местозаполнители, ограниченные символами процента. Основные функции и установленные модули могут заменять эти местозаполнители фрагментами SQL во время выполнения.

Базовый шаблон запроса¶

В шаблоне запроса могут использоваться такие местозаполнители, как %qstr% для условий запроса и %morefilter% для дополнительных фильтров:

SELECT obm_id, %grid_geometry% AS obm_geometry
    %selected%
FROM %F%checkitout c%F%
    %uploading_join%
    %rules_join%
    %taxon_join%
    %grid_join%
    %search_join%
    %morefilter%
WHERE %geometry_type% %envelope% %qstr%

Маркеры %F% обозначают основное отношение FROM и его псевдоним, чтобы интерпретатор мог разделить и расширить шаблон.

Добавление соединений¶

Дополнительные соединения можно заключать в маркеры %J%:

SELECT
    n.obm_geometry,
    n.obm_id,
    -2 AS date_part,
    nestbox_type,
    project_id,
    beinaction
    %selected%
FROM %F%public_nestbox_data n%F%
    %J%LEFT JOIN public_nestbox_data_observations o
        ON o.nestbox_id = n.obm_id%J%
    %taxon_join%
    %morefilter%
WHERE %envelope% %qstr%

Сложные шаблоны запросов¶

В шаблонах также можно использовать обобщённые табличные выражения и другие конструкции SQL:

WITH aall AS (
    SELECT
        o.obm_id,
        n.obm_geometry,
        nestbox_type,
        project_id,
        beinaction,
        COALESCE(
            EXTRACT(DAY FROM (CURRENT_DATE - datum)::interval),
            '-1'
        ) AS date_part
        %selected%
    FROM %F%public_nestbox_data_observations o%F%
        %J%LEFT JOIN public_nestbox_data n
            ON nestbox_id = n.obm_id%J%
        %taxon_join%
        %morefilter%
    WHERE 1 = 1 %envelope% %qstr%
)
SELECT *
FROM aall
ORDER BY date_part DESC

Типичный простой шаблон имеет следующий вид:

SELECT obm_id, obm_geometry %selected%
FROM %F%checkitout c%F%
    %uploading_join%
    %rules_join%
    %taxon_join%
    %morefilter%
WHERE %geometry_type% %envelope% %qstr%

Шаблоны запросов влияют как на корректность, так и на доступ к данным. Неправильное соединение или отсутствие местозаполнителя правил доступа может раскрыть записи или поля, доступ к которым должен быть ограничен. Перед публикацией каждого запроса протестируйте его от имени общедоступного, аутентифицированного и принадлежащего к определённой группе пользователя.

Настройки карты¶

Раздел Настройки карты настраивает пространственные слои веб-карты и соответствующие им определения MapServer. Настройки веб-карты и MapServer должны оставаться согласованными, чтобы слои использовали предполагаемый источник данных, проекцию, охват и стиль.

Слои веб-карты¶

Настройки веб-карты определяют интерфейс карты на основе OpenLayers. Администраторы могут задавать такие параметры, как:

начальный центр карты и уровень масштабирования;
доступные базовые карты и слои наложения;
слои, видимые по умолчанию;
связь между слоями, таблицами проекта и шаблонами запросов; и
отдельные аспекты внешнего вида и поведения слоёв.

Настройки MapServer¶

Опытные администраторы могут редактировать исходный mapfile MapServer проекта. Mapfile определяет источники данных слоёв, системы пространственных координат, охваты, стили и параметры визуализации.

Изменения mapfile могут сделать слои проекта недоступными или раскрыть непредусмотренный источник данных. Сохраните рабочую версию и проверьте изменённый mapfile перед развёртыванием изменений.

Пространственные системы координат¶

Для слоёв карты должны быть правильно определены пространственные системы координат. Настроенный SRID определяет, как интерпретируются и преобразовываются координаты при совместном отображении данных из разных источников.

Настройки охвата и проекции карты определяют область и систему координат, отображаемые веб-картой. Они должны быть совместимы с данными слоя, конфигурацией MapServer и настройками OpenLayers.

Участники¶

Раздел Участники содержит список пользователей, зарегистрированных в проекте. Администраторы могут управлять участием в проекте, статусом и назначением групп.

Задокументированы следующие статусы участников:

Normal: Пользователь получает стандартные разрешения проекта на загрузку и выполнение запросов. Более точные назначения групп и правила доступа могут изменять эти разрешения.
Operator: Пользователь имеет доступ ко всем функциям и данным проекта.
Suspended: Пользователь не может получать доступ к функциям или данным проекта. Приостановка действия учётной записи пользователя аналогична отключению его участия в проекте, но не удаляет его профиль.

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

Связанные настройки см. в разделах Группы и Административный доступ.

Просмотр профиля другого пользователя¶

Имя участника является ссылкой на страницу его профиля. Администраторы с необходимым разрешением могут видеть значок user-secret в правой верхней части страницы. Эта функция открывает профиль другого пользователя, при этом администратор остаётся аутентифицированным под собственной учётной записью.

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

Эта функция может раскрывать персональные данные и содержимое, относящееся к конкретному пользователю. Доступ к ней должен быть ограничен, а её использование должно соответствовать политикам проекта в отношении конфиденциальности и аудита.

Шаблоны сообщений¶

Редактор шаблонов сообщений в настоящее время недоступен.

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

Чтобы настроить глобальный шаблон, выберите его, отредактируйте содержимое и сохраните в качестве локальной версии. Шаблоны могут содержать переменные, которые заменяются при отправке сообщения. Переменные, поддерживаемые отдельным шаблоном, определяются функцией, модулем или фоновым заданием, отправляющим сообщение.

Новые шаблоны также можно создавать для пользовательских модулей и фоновых заданий.

Переменные и включаемые шаблоны¶

Переменные записываются между символами процента, например %USER_NAME%. Задокументированы следующие глобальные переменные:

%PROJECT_TABLE%: Идентификатор базы данных или название таблицы проекта.
%PROJECT_TITLE%: Краткое описание проекта.
%PROJECT_DESCRIPTION%: Полное описание проекта.
%USER_NAME%: Имя получателя или соответствующего пользователя.
%URL%: URL-адрес, связанный с сообщением.
%OB_DOMAIN%: Домен OpenBioMaps, связанный с сообщением.
%DOMAIN%: Доменное имя, определённое в таблице projects.
%PROTOCOL%: Протокол, определённый в таблице projects.

Один шаблон может включать другой шаблон. Например, добавление @footer@ включает шаблон с названием footer.

Предопределённые шаблоны¶

Задокументированы следующие шаблоны, относящиеся к пользователям:

welcome_to: Приветствует пользователя в проекте.
change_email_address: Отправляет ссылку для подтверждения изменения адреса электронной почты пользователя.
dropmyaccount: Подтверждает запрос на удаление учётной записи.
create_new_project: Подтверждает создание проекта.
invitation: Отправляет приглашение присоединиться к проекту.
invitation_accomplished: Сообщает о принятии приглашения.
invitation_request: Уведомляет администраторов о запросе приглашения.
lostpw: Поддерживает восстановление пароля.

Задокументированы следующие шаблоны общего назначения:

new_gitlab_issue: Содержит копию отправленного отчёта об ошибке.
new_shared_polygon: Сообщает о новом опубликованном полигоне.
new_upload_news: Сообщает о новой загрузке в новостях проекта.
new_upload_report: Уведомляет администраторов о новой загрузке.
footer: Содержит общий нижний колонтитул сообщения.
interconnect_request: Поддерживает запрос на взаимное подключение.

Задокументированы следующие шаблоны уведомлений об оценке:

data_evaluation_commenters: Уведомляет предыдущих авторов комментариев о добавлении нового комментария к записи.
data_evaluation_owner: Уведомляет владельца о добавлении комментария к загруженной им записи.
upload_evaluation_commenters: Уведомляет предыдущих авторов комментариев о добавлении нового комментария к загрузке.
upload_evaluation_owner: Уведомляет владельца о добавлении комментария к его загрузке.
user_evaluation_commenters: Уведомляет предыдущих авторов комментариев о добавлении нового комментария к пользователю.
user_evaluation_owner: Уведомляет пользователя о добавлении комментария к нему.

Задокументированы следующие шаблоны, относящиеся к модулям:

dlr_new_request: Уведомляет администраторов проекта о новом запросе на скачивание. Задокументированы переменные username, requestid и request_message.
dlr_request_registered: Подтверждает пользователю регистрацию его запроса на скачивание.
incomplete_list_processed: Сообщает, что неполный список был обработан.
incomplete_list_unprocessed: Сообщает, что неполный список не удалось обработать.

Информация о сервере¶

Раздел Информация о сервере отображает выбранные сведения о сервере OpenBioMaps и ресурсах, используемых проектом. В зависимости от конфигурации сервера он может содержать:

установленную версию приложения OpenBioMaps;
дисковое пространство, используемое файлами проекта, вложениями и загрузками;
средние значения нагрузки за предыдущие 1, 5 и 15 минут;
нагрузку сервера, нормированную по количеству ядер процессора;
доступную память; и
ссылку на интерфейс администрирования Supervisor.

Эти значения могут помочь администраторам выявлять ограничения ресурсов и предоставлять диагностические сведения операторам сервера. Доступ к подробной информации о сервере должен быть ограничен, поскольку сведения о версии и инфраструктуре могут иметь значение для безопасности.

Журналы сервера¶

Раздел Журналы сервера предоставляет доступ к журналам, доступным в соответствии с конфигурацией сервера. К задокументированным источникам относятся:

журналы приложения или системы;
журналы MapServer;
события фоновых заданий; и
ошибки фоновых заданий.

Интерфейс может предоставлять фильтрацию и поиск. Журналы могут содержать имена пользователей, идентификаторы записей, сведения о запросах, пути к файлам, параметры запросов или другую конфиденциальную информацию. Доступ и сроки хранения должны соответствовать политикам безопасности и конфиденциальности сервера.

Настройки фоновых заданий¶

Фоновые задания позволяют проекту выполнять запланированные или запускаемые вручную задачи без постоянного взаимодействия с пользователем. Их можно использовать для таких операций, как:

поддержка данных о названиях видов;
проверка записей;
импорт или экспорт данных;
очистка временных таблиц;
выполнение анализов; и
обновление материализованных представлений.

Фоновое задание является самостоятельной программой. Задания OpenBioMaps обычно пишутся на PHP, но сервер также может поддерживать программы, написанные на Python, R, Bash или другом установленном языке.

Интерфейс администрирования можно использовать для следующих действий:

установка предопределённых заданий из центрального репозитория Git;
загрузка задания, предназначенного для конкретного проекта;
просмотр установленных заданий;
настройка параметров и расписаний заданий;
включение или отключение заданий;
запуск задания вручную;
просмотр последних результатов и состояния выполнения; и
редактирование исходного кода задания там, где эта функция включена.

Подробные журналы доступны в разделе Журналы сервера.

Редактирование или загрузка задания эквивалентны установке исполняемого кода на сервер. Эти функции должны быть доступны только доверенным администраторам, а пользовательские задания следует проверять на внедрение команд, небезопасный доступ к файлам, раскрытие учётных данных и чрезмерное использование ресурсов.

Дополнительную информацию см. в разделе Задания.

Планирование заданий¶

Сначала необходимо настроить системный планировщик сервера. В установке Docker это обычно процесс cron на хосте. Он периодически вызывает планировщик проекта, который запускает задания, срок выполнения которых наступил.

Перед планированием вновь установленного или изменённого задания:

проверьте его конфигурацию и исходный код;
используйте Run, чтобы выполнить его вручную;
дождитесь завершения выполнения;
проверьте результат и журналы; и
настраивайте повторяющееся расписание только после успешного завершения теста.

Планировщик проекта использует поля минут, часов и дней в стиле cron. Звёздочка означает каждое допустимое значение в соответствующем поле.

Системный пример Docker¶

Следующий пример вызывает планировщик проекта с хоста:

*/5 * * * * /usr/local/bin/docker-compose -f /srv/docker/openbiomaps/docker-compose.yml exec -u www-data -T app php /var/www/html/biomaps/root-site/projects/myproject/jobs.php

Замените файл Compose, сервис, путь к проекту и пользователя выполнения значениями, соответствующими вашей установке.

Описание проекта¶

Раздел Описание проекта определяет название проекта, отображаемое в заголовке страницы, и его полное описание. Для каждого активного языка можно указать отдельные значения.

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

Управление данными¶

Раздел Управление данными содержит сводную информацию о загрузках и списках наблюдений. Он может помочь администраторам просматривать последние отправленные данные, определять участников и переходить между связанными записями, загрузками и треками.

К задокументированным функциям относятся:

вывод списков наблюдений по загрузившему их пользователю, дате или треку;
сводная информация о количестве записей, загруженных каждым пользователем и в каждую таблицу;
отображение списков наблюдений, отправленных за предыдущие 90 дней; и
отображение треков, отправленных за предыдущие 30 дней.

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

	Главная \| Сообщество \| Часто задаваемые вопросы \| Вопросы \| Источник документации