Задачи (Tasks)#

Настройка и выполнение задач#

Менеджер репозиториев позволяет планировать выполнение задач. Задачи могут выполнять регулярные действия по техническому обслуживанию, которые будут применяться ко всем или к конкретным репозиториям по настраиваемому расписанию. Чтобы открыть раздел задач, перейдите в меню Администрирование -> System -> Tasks.

Чтобы получить доступ к этому пункту меню, необходимо обладать привилегиями nx-admin или nx-tasks.

В разделе Tasks представлен список ранее созданных задач в виде таблицы. Для создания новой задачи воспользуйтесь кнопкой Create task.

В таблице содержатся следующие столбцы:

Частота выполнения задач#

Выбор частоты выполнения задачи позволяет настроить расписание ее выполнения. Доступны следующие варианты: Manual, Once, Hourly, Daily, Weekly, Monthly, и Advanced(CRON).

• Manual - задачу можно выполнить только вручную;

• Once - задача выполнится только один раз в указанную дату/время;

• Daily - задача будет выполняться каждый день в указанное время;

• Weekly - задача будет выполняться каждую неделю в указанный день и время;

• Monthly - задача будет выполняться каждый месяц в указанные дни и время;

• Advanced - задача, для запуска которой требуется указать выражение CRON для настройки более сложных расписаний.

Синтаксис, используемый для задачи Advanced, соответствует синтаксису CRON в стиле UNIX. Выражения CRON состоят из 6 обязательных и одного необязательного полей, разделенных пробелами, как описано в таблице ниже. Пример простого выражения - 0 0 9 * * ?. Данная конфигурация запускает выполнение задачи каждый день в 9:00 утра.

Поля выражения CRON#

В таблице ниже представлены более подробные примеры выражений CRON.

Типы задач и время их использования#

Доступны следующие задачи:

Ведение журнала задач#

Результаты выполнения каждой задачи попадают в отдельный файл журнала. По умолчанию журналы хранятся в папке $data-dir/log/tasks. Имя файла журнала каждой задачи соответствует типу, за которым следуют полная дата и время запуска задачи. Например: repository-maven.purge-unused-snapshots-20170618153235.log.

Для длительно выполняющихся задач прогресс будет записываться в журнал Artifactory.log каждые 10 минут по мере продолжения работы. Чаще всего это будет отображаться как контекстуальное обновление, относящееся к конкретной задаче.

Файлы журнала задач удаляются через 30 дней.

Задачи Maven SNAPSHOT#

Задача Maven - Delete SNAPSHOT#

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

Чтобы создать задачу, заполните следующие поля:

• Task name - название задачи;

• Repository - название репозитория, из которого будут удаляться снепшоты;

• Minimum snapshot count - минимальное количество снепшотов в репозитории, которое должно остаться после удаления;

• Snapshot retention (days) - количество дней, в течение которых снепшоты должны храниться перед их удалением;

• Remove if released - чекбокс, при включении которого задача удаляет версии снепшотов с теми же groupId, artifactId и baseVersion что и у релизной версии;

• Grace period after release (days) - количество дней после релиза новой версии артефакта, в течение которых снепшоты не будут удалены.

Лежащие в основе «мягко удаленные» Blobs удаляются навсегда, используя стратегию, поддерживаемую реализацией blobstore.

Пример задачи Maven - Delete SNAPSHOT#

Для примера, допустим, у вас есть папка с именем 1.3-SNAPSHOT, в которой содержатся три файла с разными временными метками:

• artifact-1.3-20210226.143327-1.jar

• artifact-1.3-20210226.172432-2.jar

• artifact-1.3-20210227.102015-3.jar

Настроим задачу Maven - Delete SNAPSHOT со следующими параметрами:

• Minimum snapshot count: 1;

• Snapshot retention (days): 0;

• Grace period after release: 0.

После выполнения задачи с такой конфигурацией останется только один файл с последней временной меткой в названии файла - artifact-1.3-20210227.102015-3.jar.

Задача Maven - Delete Unused SNAPSHOT#

Задача Maven - Delete Unused SNAPSHOT автоматически удаляет снепшоты, которые не использовались в течение определенного периода времени, основываясь на количестве дней, прошедших с момента последнего запроса артефакта. При запуске этой задачи будет удалена любая версия снепшота, которая не использовалась в течение заданного количества дней.

Задача Repository Export#

Задача Repository - Export Assets позволяет пользователям экспортировать файлы и папки из выбранного репозитория в локальную систему.

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

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

Чтобы создать задачу, заполните следующие поля:

• Task Name - название задачи;

• Source repository - репозиторий, из которого будет производиться экспорт. В этом списке представлены только репозитории поддерживаемых форматов;

• Target directory - каталог, в который будут экспортироваться файлы;

• Task frequency - частота, с которой будет выполняться задача, подробнее в разделе Частота выполнения задач.

Задача Repository Import#

Задача Repository - Import external files предназначена для импорта внешних файлов в репозиторий. Принцип работы заключается в сканировании локальной системы на наличие файлов и папок, которые соответствуют заданным критериям, после чего происходит ипорт найденных файлов в репозиторий, создавая новые записи и сохраняя их метаданные.

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

Чтобы создать задачу, заполните следующие поля:

• Task Name - название задачи;

• Target repository - репозиторий, в который будут импортироваться файлы;

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

• Task frequency - частота, с которой будет выполняться задача, подробнее в разделе Частота выполнения задач.

После запуска задачи, она создает каталог .artifactory/nxp-import-export-task/ внутри исходного каталога. Данный каталог содержит метаданные, которые будут использоваться для будущего импорта, если задача выполняется более одного раза.