Skip to content

Commit 68bd8ca

Browse files
oashnicpavel.korolkovLada7878asidorok-NSAvtandilko
authored
docs: Add github actions widget (#144)
* docs: Add github actions widget * Minor language correction (#149) Signed-off-by: Lada <lada7878@Ladas-MacBook-Pro.local> * docs: Edit github tags widget (Review PR 126) (#148) * docs: add Go template support for repository ignore rules (#146) Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com> * processes error element (#151) * processes error element * minor edit Signed-off-by: Lada7878 <ladalada7878@gmail.com> --------- Signed-off-by: Lada7878 <ladalada7878@gmail.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: Lada7878 <ladalada7878@gmail.com> * change release date (#154) Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * [frontend] Harden upstream resilience and startup (#155) - Add DNS readiness loop and upstream cache-warming entrypoint to ensure external backends are resolvable and responsive before nginx begins accepting traffic - Introduce dedicated includes location block with non-intercepting error handling and strict proxy timeouts, separating static asset proxying from the default fallback-to-hugo routing logic - Enable dynamic DNS resolution on upstream definitions via resolve flag and shared memory zones, replacing static resolution that broke on address changes - Restore default upstream mapping to the international endpoint, removing temporary override to the Russian locale - Disable git-info via environment variable for the static site generator to avoid build-time penalties in local development * [build] Add port-freeing and clean teardown to up (#156) - Introduce a free-ports target that discovers and stops any containers occupying configurable published ports before the service stack is brought up, preventing bind-address conflicts - Chain down and free-ports as prerequisites of the up target to guarantee a clean environment on every invocation - Extend the down target with orphan removal to ensure no stale containers persist across successive runs * AI-assistant chats and context (#153) * AI-assistant chats and context * add breaking changes * fix list Signed-off-by: sidorok <a.sidorok@me.com> --------- Signed-off-by: sidorok <a.sidorok@me.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: sidorok <a.sidorok@me.com> * update process loop element description (#147) * update process loop element description * add note element description * add note element description * fix release notes * fix release notes * add deprecation notice * add deprecation notice * fix release notes * gitlab contributors widget * fix rn 1.3 * fix tupes_ru Signed-off-by: sidorok <a.sidorok@me.com> * Update types.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update types.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update types.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update types.ru.md GitLab Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update v1.4.0.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update v1.3.0.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> --------- Signed-off-by: Nikita Velgin <direct.vegas@gmail.com> Signed-off-by: sidorok <a.sidorok@me.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: sidorok <a.sidorok@me.com> Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> * add codescoring secrets widget (#157) Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * docs: Action CreateVaultSecret: add merge_or_create (#145) Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com> * Decrecation: remove specific kubernetes datasources (#158) Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * Mcp tools tuning 1 (#160) * mcp tools tuning * mcp tools tuning * mcp tools tuning --------- Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * Release v1.4.0 (#162) * Release v1.4.0 * Release v1.4.0 --------- Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * docs: Mcp tools tunung and AI-assistant review (#166) * Updates for links in release notes and other edits Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * ai-assistant doc fixes Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * mcp-server fixes Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * fix of domain example Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * one number fix Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * Apply suggestions from code review Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com> Co-authored-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * Apply suggestions from code review Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com> Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * Added what instructions returns Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * Apply suggestions from code review Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com> Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> * Removed bold text Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> --------- Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com> * add entity cards view (#167) * add entity cards view * fix Signed-off-by: sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Update catalog.ru.md Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> --------- Signed-off-by: sidorok <a.sidorok@me.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: sidorok <a.sidorok@me.com> Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> * add rrpo section (#171) * add rrpo section * fixes * add tech-support and licensing * fix --------- Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * change hugo version to v0.159.2 (#172) * change hugo-web-product-module version to v0.1.12 Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com> * change hugo version to v0.159.2 Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com> --------- Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com> * change naming (#175) Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> * Release notes v1.5.0 (#170) * new relations graph * new relations graph * Query changes * fixes * fixes * add users sorting fix * add favorites * fix markdown-lint * types Signed-off-by: sidorok <a.sidorok@me.com> * types-health Signed-off-by: sidorok <a.sidorok@me.com> * v1.5.0 Signed-off-by: sidorok <a.sidorok@me.com> * catalog Signed-off-by: sidorok <a.sidorok@me.com> * types2 Signed-off-by: sidorok <a.sidorok@me.com> * types3 Signed-off-by: sidorok <a.sidorok@me.com> * Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * fix type4 Signed-off-by: sidorok <a.sidorok@me.com> --------- Signed-off-by: Nikita Velgin <direct.vegas@gmail.com> Signed-off-by: sidorok <a.sidorok@me.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: sidorok <a.sidorok@me.com> Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> --------- Signed-off-by: Lada <lada7878@Ladas-MacBook-Pro.local> Signed-off-by: Lada7878 <ladalada7878@gmail.com> Signed-off-by: sidorok <a.sidorok@me.com> Signed-off-by: Nikita Velgin <direct.vegas@gmail.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> Signed-off-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> Signed-off-by: Aleksandr Radchenko <dacetascien@gmail.com> Co-authored-by: pavel.korolkov <pavel.korolkov@flant.com> Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Co-authored-by: Anastasia Sidorok <a.sidorok@me.com> Co-authored-by: Nikita Velgin <direct.vegas@gmail.com> Co-authored-by: Nikita Velgin <nikita.velgin@flant.com> Co-authored-by: Lada7878 <ladalada7878@gmail.com> Co-authored-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> Co-authored-by: Valeria Brazhnikova <valeria.brazhnikova@flant.com> Co-authored-by: Denis Rebenok <60424108+denmaloyreb@users.noreply.github.com> Co-authored-by: Aleksandr Radchenko <102186217+dacetascien@users.noreply.github.com>
1 parent 9116ee6 commit 68bd8ca

2 files changed

Lines changed: 82 additions & 16 deletions

File tree

‎content/documentation/admin/widgets/types.ru.md‎

Lines changed: 76 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,10 @@ title: Типы виджетов
4343

4444
### Конфигурация
4545

46-
| Название | Обязательность | Описание | Пример |
47-
|---------------------------|-----------------|-------------------------------------------------------------------|------------------------------------------------------------------------|
48-
| Ключ проекта | **Да** | Часть URL репозитория, которая идёт сразу после **/projects/** | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `MYTEAM` |
49-
| Идентификатор репозитория | **Да** | Часть URL репозитория, которая идёт сразу после **/repos/** | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `backend` |
46+
| Название | Обязательность | Описание | Пример |
47+
|---------------------------|-----------------|----------------------------------------------------------|------------------------------------------------------------------------|
48+
| Ключ проекта | **Да** | Часть URL репозитория, которая идёт сразу после **/projects/** | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `MYTEAM` |
49+
| Идентификатор репозитория | **Да** | Часть URL репозитория, которая идёт сразу после **/repos/** | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `backend` |
5050

5151
### Фильтрация по статусу
5252

@@ -82,12 +82,18 @@ title: Типы виджетов
8282
Конфигурация авторизации описана в разделе [«Внешние сервисы»](../external-services/#github).
8383
В настройках внешнего сервиса или в конфигурации виджета в поле **URL** необходимо указать `https://api.github.com`.
8484

85+
### Учётная запись и автор действий
86+
87+
Запросы к GitHub выполняются с токеном из учётных данных того пользователя платформы, от имени которого вызывается действие. Если в настройках виджета включено **Выбрать учётную запись для виджета**, используются учётные данные выбранного пользователя платформы, а не текущего.
88+
89+
При **создании**, **слиянии** и **закрытии** Pull Request в GitHub автором PR и исполнителем действий считается учётная запись GitHub, которой принадлежит этот токен. Логин и имя в интерфейсе GitHub могут не совпадать с именем в профиле DDP.
90+
8591
### Конфигурация
8692

87-
| Название | Обязательность | Описание | Значение по умолчанию |
88-
|----------------------|----------------|--------------------------------------------------------------------------------------------------------------------------|-----------------------|
89-
| Владелец репозитория | **Да** | Владелец репозитория (организация или пользователь). Пример: для `https://github.com/example/my-repo` укажите `example` | — |
90-
| Репозиторий | **Да** | Название репозитория без `.git`. Пример: для `https://github.com/example/my-repo` укажите `my-repo` | — |
93+
| Название | Обязательность | Описание | Пример |
94+
|----------------------|----------------|------------------------------------------------------|------------------------------------------------------------|
95+
| Владелец репозитория | **Да** | Владелец репозитория (организация или пользователь). | Для `https://github.com/example/my-repo` укажите `example` |
96+
| Репозиторий | **Да** | Название репозитория без `.git`. | Для `https://github.com/example/my-repo` укажите `my-repo` |
9197

9298
### Статус
9399

@@ -111,6 +117,52 @@ title: Типы виджетов
111117
Для выполнения действий с PR требуются соответствующие права доступа в репозитории GitHub.
112118
{{< /alert >}}
113119

120+
## GitHub. Actions
121+
122+
Виджет показывает запуски GitHub Actions в репозитории и позволяет просматривать jobs, артефакты, а также производить действия над ними.
123+
124+
### Авторизация
125+
126+
Конфигурация авторизации описана в разделе [Внешние сервисы](../external-services/#github).
127+
В настройках внешнего сервиса в поле **URL** необходимо указать `https://api.github.com`.
128+
129+
### Учётная запись и автор действий
130+
131+
Запросы к GitHub выполняются с токеном из учётных данных того пользователя платформы, от имени которого вызывается действие. Если в настройках виджета включено **Выбрать учётную запись для виджета**, используются учётные данные выбранного пользователя платформы, а не текущего.
132+
133+
При **запуске** и **перезапуске** workflow, **отмене** запуска, работе с **артефактами** и **логами** в GitHub инициатором считается учётная запись GitHub, которой принадлежит токен. Логин в интерфейсе GitHub может не совпадать с именем в профиле DDP.
134+
135+
### Конфигурация
136+
137+
| Название | Обязательность | Описание | Пример |
138+
|----------------------|----------------|------------------------------------------------------|------------------------------------------------------------|
139+
| Владелец репозитория | **да** | Владелец репозитория (организация или пользователь). | Для `https://github.com/example/my-repo` укажите `example` |
140+
| Репозиторий | **да** | Название репозитория без `.git`. | Для `https://github.com/example/my-repo` укажите `my-repo` |
141+
142+
### Параметры запроса
143+
144+
В настройках запроса виджета можно задать фильтры:
145+
146+
- **Ветка** — только запуски с указанной head-веткой.
147+
- **Событие** — только запуски с выбранным типом события.
148+
- **Статус** — только запуски в выбранном статусе или с выбранным итогом (conclusion).
149+
- **Workflow** — только запуски для выбранного файла workflow.
150+
- **Кто запустил** — только запуски, начатые указанным пользователем GitHub.
151+
- **Фильтр по дате создания** — интервал дат создания запуска (дата начала и дата окончания).
152+
153+
### Действия
154+
155+
В виджете доступны следующие действия:
156+
157+
- **Запустить workflow** — ручной запуск workflow с триггером `workflow_dispatch`: выбираются **Workflow** и **Ветка или тег**; при объявленных во входном YAML параметрах отображаются **Входные параметры**.
158+
- **Перезапустить workflow**, **Перезапустить упавшие jobs**, **Отменить workflow** — для выбранного запуска.
159+
- **Перезапустить job** — для job в статусе «завершён» с итогом failure или cancelled.
160+
- Просмотр логов job, скачивание артефактов, открытие запуска на GitHub, дерево jobs и шагов.
161+
162+
{{< alert level="info" >}}
163+
Для действий с workflow и артефактами нужны соответствующие права в репозитории GitHub.
164+
{{< /alert >}}
165+
114166
## CodeScoring. Зависимости
115167

116168
Виджет позволяет вывести таблицу с зависимостями продукта на основе данных из CodeScoring с указанием названия зависимости, версии, лицензии, количества уязвимостей и другой информации для каждой зависимости.
@@ -123,8 +175,8 @@ title: Типы виджетов
123175

124176
| Название | Обязательность | Описание | Значение по умолчанию |
125177
|-------------------|-----------------|-------------------------------------|-----------------------|
126-
| URL | **Да** | URL CodeScoring | - |
127-
| ID проекта | **Да** | Идентификатор проекта в CodeScoring | - |
178+
| URL | **Да** | URL CodeScoring | - |
179+
| ID проекта | **Да** | Идентификатор проекта в CodeScoring | - |
128180

129181
## CodeScoring. Уязвимости
130182

@@ -466,12 +518,22 @@ title: Типы виджетов
466518
Конфигурация авторизации описана в разделе [«Внешние сервисы»](../external-services/#github).
467519
В настройках внешнего сервиса в поле **URL** необходимо указать `https://api.github.com`.
468520

521+
### Учётная запись и автор действий
522+
523+
Запросы к GitHub выполняются с токеном из учётных данных того пользователя платформы, от имени которого вызывается действие. Если в настройках виджета включено **Выбрать учётную запись для виджета**, используются учётные данные выбранного пользователя платформы, а не текущего.
524+
525+
**Аннотированный тег** (поле **Описание** заполнено): в метаданных git-тега поля автора аннотации (**tagger**) заполняются из имени и email пользователя платформы, выполнившего действие (как в профиле в DDP). Если имя не задано, может подставляться email.
526+
527+
**Лёгкий тег** (без описания): отдельный автор тега в git не задаётся; создаётся ссылка на коммит.
528+
529+
Создание тега через API выполняется от учётной записи GitHub по токену; данные **tagger** при этом берутся из профиля DDP и могут не совпадать с логином GitHub.
530+
469531
### Конфигурация
470532

471-
| Название | Обязательность | Описание | Значение по умолчанию |
472-
|----------------------|----------------|--------------------------------------------------------------------------------------------------------------------------|-----------------------|
473-
| Владелец репозитория | **Да** | Владелец репозитория (организация или пользователь). Пример: для `https://github.com/example/my-repo` укажите `example` | — |
474-
| Репозиторий | **Да** | Название репозитория без `.git`. Пример: для `https://github.com/example/my-repo` укажите `my-repo` | — |
533+
| Название | Обязательность | Описание | Пример |
534+
|----------------------|----------------|------------------------------------------------------|------------------------------------------------------------|
535+
| Владелец репозитория | **Да** | Владелец репозитория (организация или пользователь). | Для `https://github.com/example/my-repo` укажите `example` |
536+
| Репозиторий | **Да** | Название репозитория без `.git`. | Для `https://github.com/example/my-repo` укажите `my-repo` |
475537

476538
### Отображаемые данные
477539

@@ -489,8 +551,6 @@ title: Типы виджетов
489551
| Создать из | **Да** | Ветка или существующий тег, от которого создаётся новый тег | — |
490552
| Описание | Нет | Аннотация к тегу (например, описание релиза). Если указано, создаётся аннотированный тег | — |
491553

492-
Автором аннотированного тега в GitHub отображается пользователь DDP, выполнивший действие.
493-
494554
{{< alert level="info" >}}
495555
Для создания тегов требуются права на запись в репозиторий GitHub.
496556
{{< /alert >}}

‎content/documentation/release-notes/v1.5.0.ru.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,12 @@ weight: 920
99

1010
## Новые возможности
1111

12+
### Виджеты
13+
14+
Добавлены новые виджеты:
15+
16+
- «GitHub. Actions» — для просмотра запусков и управления ([GitHub Actions](../../admin/widgets/types/#github-actions)).
17+
1218
### Связи
1319

1420
В связях ресурсов теперь можно указывать параметры родительского и дочернего ресурса, через которые будут связаны сущности. Подробнее — в разделе [«Связи между ресурсами»](../../user/catalog/#связи-между-ресурсами).

0 commit comments

Comments
 (0)