Skip to content

docs: Add bitbucket tags widget #94

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 5 commits into
base: main
Choose a base branch
from
Open

docs: Add bitbucket tags widget #94

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
87ab130
fix merge conflicts
Mar 3, 2026
c79362f
docs: Edit content after PR 87 (#97)
denmaloyreb Feb 27, 2026
bc679b0
bitbucket widgets: release notes and fixes
Mar 3, 2026
ac8988e
rollback some ext services changes
Mar 3, 2026
da35e1e
bitbucket widgets fixes
Mar 3, 2026
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
28 changes: 14 additions & 14 deletions content/documentation/admin/external-services.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,8 +111,8 @@ Authorization: Token <ваш-defectdojo-api-v2-key>

**Заголовки:**

| Заголовок | Формат значения |
|-----------|-----------------|
| Заголовок | Формат значения |
|-----------------|------------------|
| `Authorization` | `Bearer <токен>` |

**Пример:**
Expand All @@ -134,8 +134,8 @@ Authorization: Bearer <ваш-bitbucket-personal-access-token>
**Пример:**

1. Сформируйте строку `username:password`.
2. Закодируйте её в Base64: `echo "username:password" | base64`.
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand Down Expand Up @@ -172,8 +172,8 @@ Private-Token: <ваш-gitlab-token>
**Пример:**

1. Сформируйте строку `username:password`.
2. Закодируйте её в Base64: `echo "username:password" | base64`.
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand All @@ -194,8 +194,8 @@ Authorization: Basic <base64-encoded-credentials>
1. Сформируйте строку `username:password`, где:
- `username` — имя пользователя в Jenkins.
- `password` — пароль пользователя.
2. Закодируйте её в Base64: `echo "username:password" | base64`
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand All @@ -214,8 +214,8 @@ Authorization: Basic <base64-encoded-credentials>
**Пример:**

1. Сформируйте строку `username:password`.
2. Закодируйте её в Base64: `echo "username:password" | base64`.
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand Down Expand Up @@ -266,8 +266,8 @@ Authorization: Bearer <ваш-kubernetes-token>
**Пример:**

1. Сформируйте строку `username:password`.
2. Закодируйте её в Base64: `echo "username:password" | base64`.
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand All @@ -286,8 +286,8 @@ Authorization: Basic <base64-encoded-credentials>
**Пример:**

1. Сформируйте строку `username:password`.
2. Закодируйте её в Base64: `echo "username:password" | base64`.
3. Добавьте заголовок:
1. Закодируйте её в Base64: `echo "username:password" | base64`.
1. Добавьте заголовок:

```sh
Authorization: Basic <base64-encoded-credentials>
Expand Down
50 changes: 43 additions & 7 deletions content/documentation/admin/widgets/types.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,18 +35,18 @@ title: Типы виджетов

## Bitbucket. Pull Requests

Виджет позволяет отображать данные о Pull Requests (PR) в Bitbucket Server / Bitbucket Data Center и выполнять действия с ними.
Виджет позволяет отображать данные о Pull Requests (PR) в Bitbucket и выполнять действия с ними.

### Авторизация

Конфигурация авторизации описана в разделе [Внешние сервисы](../external-services/#bitbucket).

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

| Название | Опциональность | Описание | Значение по умолчанию |
|---------------------------|-----------------|------------------------------------------------------------------------------------------------------|-----------------------|
| Ключ проекта | **обязательно** | Ключ проекта в Bitbucket. Пример: из URL `.../projects/PROJ/repos/my_repo` укажите `PROJ` | - |
| Идентификатор репозитория | **обязательно** | Идентификатор репозитория (slug). Пример: из URL `.../projects/PROJ/repos/my_repo` укажите `my_repo` | - |
| Название | Обязательность | Описание | Пример |
|---------------------------|-----------------|------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| Ключ проекта | **да** | Часть URL репозитория, которая идёт сразу после **/projects/**. | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `MYTEAM` |
| Идентификатор репозитория | **да** | Часть URL репозитория, которая идёт сразу после **/repos/**. | Для репозитория `.../projects/MYTEAM/repos/backend` укажите `backend` |

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

Expand Down Expand Up @@ -368,6 +368,42 @@ title: Типы виджетов
| Создать из | **да** | Целевая ветка или тег для запуска пайплайна. | - |
| Описание | нет | Описание создаваемого тега. | - |

## Bitbucket. Теги

Виджет позволяет отображать данные о тегах репозитория в Bitbucket.

### Авторизация

Конфигурация авторизации описана в разделе [Внешние сервисы](../external-services/#bitbucket).

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

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

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

Виджет отображает список тегов репозитория с информацией о каждом теге:

* **Название тега** — название тега.
* **Коммит** — хэш коммита, сообщение коммита, автор, дата создания, ссылка на коммит в Bitbucket.

### Дополнительные возможности виджета

#### Создание тегов

Виджет позволяет создавать теги в Bitbucket напрямую из платформы DDP.

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

| Название | Обязательность | Описание |
|------------|-----------------|-------------------------------------------------------------------------------------|
| Название | **да** | Название создаваемого тега. |
| Создать из | **да** | Ветка или существующий тег, от которого создаётся новый тег (выбирается из списка). |
| Описание | нет | Описание создаваемого тега. |

## GitLab. Релизы

Виджет отображает список релизов GitLab-проекта, подсвечивает последний релиз и показывает связанную информацию: тег, ссылку на коммит, автора, дату публикации и описание (поддерживает Markdown).
Expand Down Expand Up @@ -1223,8 +1259,8 @@ sum(ingress_nginx_detail_requests_total)

| Название | нет | Описание | Значение по умолчанию |
|-----------------|-------------|--------------------------------------------------------------------------------------------|-----------------------|
| Дата от | обязательно | Начальная дата для выборки событий | 3 дня назад |
| Дата до | обязательно | Конечная дата для выборки событий | текущая дата |
| Дата от | **да** | Начальная дата для выборки событий | 3 дня назад |
| Дата до | **да** | Конечная дата для выборки событий | текущая дата |
| Интервал | нет | Интервал группировки событий на графике (секунды, минуты, часы, дни, недели, месяцы, годы) | час |
| Шаг интервала | нет | Количество единиц интервала для группировки | 1 |
| Топ сущностей | нет | Количество сущностей с максимальным количеством событий для отображения в таблице | 10 |
Expand Down
8 changes: 8 additions & 0 deletions content/documentation/release-notes/v1.4.0.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,14 @@ weight: 930
Выпуск релиза планируется 06.04.2026
{{< /alert >}}

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

### Виджеты

Добавлены новые виджеты:

- **Bitbucket. Теги** — для отображения и создания тегов репозитория в Bitbucket ([подробнее](../../admin/widgets/types/#bitbucket-теги)).

## Исправленные проблемы

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