Skip to content

docs: Add datasource sync process step #286

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
oashnic wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: Add datasource sync process step #286

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions content/documentation/admin/datasources/overview.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,17 @@ metadata:

При включённом параметре «Периодическая синхронизация» источник данных будет автоматически обновлять информацию из внешних инфраструктурных систем с интервалом, определённым в параметре «Периодичность запуска».

Также каждый источник данных может быть синхронизирован вручную в любой момент времени через веб-интерфейс (пункт «Синхронизировать» в меню источника данных), либо через API.
Также каждый источник данных может быть синхронизирован вручную в любой момент времени через веб-интерфейс (пункт «Синхронизировать» в меню источника данных), либо через API. Синхронизацию также запускают действия, автоматизации, MCP-сервер портала и элемент процесса [«Источник данных»](../../processes/overview/#источник-данных).

### Запуски синхронизации

Каждая синхронизация — это запуск со статусом «В очереди», «Выполняется», «Успешно» или «Ошибка». Источники данных одного ресурса синхронизируются по очереди. Если у источника уже есть запуск в очереди, новая синхронизация присоединяется к нему.

После нажатия «Синхронизировать» отображается уведомление «Синхронизация «{name}» поставлена в очередь». Пока запуск не завершён, на карточке источника данных отображается строка «Текущая синхронизация» с его статусом.

Чтобы посмотреть историю запусков, выберите в меню источника данных «Запуски источника данных». Новые запуски отображаются сверху, для каждого — «Статус» (текст ошибки — во всплывающей подсказке), «Поставлен в очередь», «Дата старта», «Дата завершения» и «Длительность». Кнопка «Лог синхронизации» открывает лог запуска, кнопка «Запросы» — окно «Запросы на синхронизацию»: кто запросил запуск или присоединился к нему («Время запроса», «Откуда», «Кто запросил», «Если источник занят») и «Итог» — «Создал запуск» или «Присоединился к запуску».

Если воркер остановился посреди синхронизации, примерно через 2 минуты запуск получает статус «Ошибка».

## Удаление сущностей

Expand All @@ -197,7 +207,7 @@ metadata:

## Логирование запусков

Для каждого запуска источника данных создаётся запись в базе данных (БД), содержащая полный лог выполнения. Максимальное количество подобных записей регулируется параметром «максимальное количество записей» в конфигурации источника данных. При достижении максимального количества старые записи будут удаляться.
Для каждого запуска источника данных создаётся запись в базе данных (БД), содержащая полный лог выполнения. Максимальное количество подобных записей регулируется параметром «максимальное количество записей» в конфигурации источника данных. При достижении максимального количества старые записи будут удаляться. Запуски, которые ещё выполняются или которых ждёт незавершённый процесс, не удаляются.

Параметр модуля `datasources.logging.enabled` позволяет выводить в stdout или скрывать логи синхронизации источников данных. При значении `true` логи выводятся в stdout, при значении `false` (по умолчанию) — не выводятся. Параметр задаётся в ModuleConfig `development-platform` (`spec.settings.datasources.logging.enabled`) или в настройках модуля в веб-интерфейсе Deckhouse Platform.

Expand Down
4 changes: 2 additions & 2 deletions content/documentation/admin/examples/service-autoupdates.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -627,8 +627,8 @@ values: {{ .template_values | nindent 4 }}

На вкладке «Конфигурация» настройте шаги процесса и их порядок выполнения. Названия задач и действий приведены в качестве примера.

1. Добавьте элемент типа «Задача» с названием «Создать проект в GitLab» и выберите действие «Создать проект в GitLab» для запуска.
1. Добавьте элемент типа «Задача» с названием «Создать репозиторий из шаблона» и выберите действие «Создать репозиторий из шаблона» для запуска.
1. Добавьте элемент типа «Действие» с названием «Создать проект в GitLab» и выберите действие «Создать проект в GitLab» для запуска.
1. Добавьте элемент типа «Действие» с названием «Создать репозиторий из шаблона» и выберите действие «Создать репозиторий из шаблона» для запуска.
1. Добавьте элемент типа «Конец» для завершения процесса.

После добавления всех элементов настройте последовательность выполнения:
Expand Down
Loading
Loading