diff --git a/content/documentation/admin/actions/overview.ru.md b/content/documentation/admin/actions/overview.ru.md index 11a9db3..fd78456 100644 --- a/content/documentation/admin/actions/overview.ru.md +++ b/content/documentation/admin/actions/overview.ru.md @@ -7,6 +7,7 @@ weight: 10 - создавать проекты, переменные, ветки или теги в GitLab; - создавать ресурсы в Kubernetes; +- получать ресурсы из Kubernetes; - создавать секреты в Deckhouse Stronghold или HashiCorp Vault; - создавать проекты в SonarQube, DefectDojo и других системах; - создавать топики и ACL в Kafka. diff --git a/content/documentation/admin/actions/types.ru.md b/content/documentation/admin/actions/types.ru.md index da1b42f..4bbaa7d 100644 --- a/content/documentation/admin/actions/types.ru.md +++ b/content/documentation/admin/actions/types.ru.md @@ -620,6 +620,42 @@ manifests: * `token` — токен сервисного аккаунта в Kubernetes. +## GetKubernetesResource + +GetKubernetesResource — получает ресурс из Kubernetes кластера. + +### Пример запроса + +```yaml +group: managed-services.deckhouse.io +version: v1alpha1 +resource_type: postgres +resource_name: example-postgres +namespace: default +``` + +### Спецификация запроса + +| Название | Обязательность | Описание | Возможные значения | +|---------------------------|----------------|------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| group | Да | API-группа ресурса. Указывает, к какой группе API относится запрашиваемый объект | [Определение требуемых Group и Version](#определение-требуемых-group-и-version) | +| version | Да | Версия API ресурса | [Определение требуемых Group и Version](#определение-требуемых-group-и-version) | +| resource_type | Да | Название ресурса во множественном числе, как в поле NAME вывода команды `kubectl api-resources` | - | +| resource_name | Да | Название конкретного ресурса, который необходимо получить | - | +| namespace | Да | Неймспейс, в котором находится ресурс | - | + +### Ответ + +При успешном выполнении действие возвращает объект ресурса в поле `resource`. Если ресурс не найден, действие завершается с ошибкой. + +| Название | Описание | +|------------|-----------------------------------------------| +| `resource` | Объект ресурса в формате Kubernetes | + +### Учётные данные + +* `token` — токен сервисного аккаунта в Kubernetes. + ## CreateRepositoryFromTemplate CreateRepositoryFromTemplate — создаёт новый репозиторий из шаблона в Gitlab. Механизм рендеринга основан на [Go template](https://developer.hashicorp.com/nomad/docs/reference/go-template-syntax) и поддерживает все встроенные методы, а также расширения, добавленные в платформу. diff --git a/content/documentation/admin/datasets.ru.md b/content/documentation/admin/datasets.ru.md index 5729f59..65f19f4 100644 --- a/content/documentation/admin/datasets.ru.md +++ b/content/documentation/admin/datasets.ru.md @@ -159,3 +159,69 @@ menuTitle: Наборы данных 1. Подключите внешний сервис «Vault» к действиям, виджетам или источникам данных, которые обращаются к API Vault. После этого запросы через внешний сервис будут использовать токен из учётных данных пользователя. Например, внешний сервис можно подключить к виджету [«Vault. Секреты»](../widgets/types/#vault-секреты) для просмотра секретов в KV v2. + +### Deckhouse managed PostgreSQL + +Набор данных для развёртывания managed PostgreSQL в Deckhouse Kubernetes Platform. + +Набор данных подготавливает ресурс, действия и процессы для управления жизненным циклом managed PostgreSQL: создание инстанса в кластере через внешний сервис Kubernetes и сохранение реквизитов подключения в Vault или Stronghold. + +Настройка: + +Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). + +{{< alert level="info" >}} +Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». +{{< /alert >}} + +Параметры настройки: + +| Название | Описание | Значение по умолчанию | +|----------|----------|-----------------------| +| «Внешний сервис Kubernetes» | Kubernetes кластер, в котором будет разворачиваться managed PostgreSQL | — | +| «Внешний сервис Vault или Stronghold» | Внешний сервис для записи реквизитов подключения в KV v2 | — | +| «Префикс пути Vault» | Префикс пути KV v2 для сохранения реквизитов (с `/data/`) | `services/data/` | + +### Deckhouse managed Valkey + +Набор данных для развёртывания managed Valkey в Deckhouse Kubernetes Platform. + +Набор данных подготавливает ресурс, действия и процессы для управления жизненным циклом managed Valkey: создание инстанса в кластере через внешний сервис Kubernetes и сохранение реквизитов подключения в Vault или Stronghold. + +Настройка: + +Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). + +{{< alert level="info" >}} +Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». +{{< /alert >}} + +Параметры настройки: + +| Название | Описание | Значение по умолчанию | +|----------|----------|-----------------------| +| «Внешний сервис Kubernetes» | Kubernetes кластер, в котором будет разворачиваться managed Valkey | — | +| «Внешний сервис Vault или Stronghold» | Внешний сервис для записи реквизитов подключения в KV v2 | — | +| «Префикс пути Vault» | Префикс пути KV v2 для сохранения реквизитов (с `/data/`) | `services/data/` | + +### Deckhouse managed Kafka + +Набор данных для развёртывания managed Kafka в Deckhouse Kubernetes Platform. + +Набор данных подготавливает ресурс, действия и процессы для управления жизненным циклом managed Kafka: создание инстанса в кластере через внешний сервис Kubernetes и сохранение реквизитов подключения в Vault или Stronghold. + +Настройка: + +Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). + +{{< alert level="info" >}} +Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». +{{< /alert >}} + +Параметры настройки: + +| Название | Описание | Значение по умолчанию | +|----------|----------|-----------------------| +| «Внешний сервис Kubernetes» | Kubernetes кластер, в котором будет разворачиваться managed Kafka | — | +| «Внешний сервис Vault или Stronghold» | Внешний сервис для записи реквизитов подключения в KV v2 | — | +| «Префикс пути Vault» | Префикс пути KV v2 для сохранения реквизитов (с `/data/`) | `services/data/` | diff --git a/content/documentation/release-notes/v1.6.0.ru.md b/content/documentation/release-notes/v1.6.0.ru.md index 66af08a..7a8e173 100644 --- a/content/documentation/release-notes/v1.6.0.ru.md +++ b/content/documentation/release-notes/v1.6.0.ru.md @@ -27,6 +27,10 @@ description: Заметки о выпуске v1.6.0 — выгрузка ауд Добавлена функция шаблонизации [«toSlug»](../../user/templating/#toslug). +### Действия + +Добавлено действие [GetKubernetesResource](../../admin/actions/types/#getkubernetesresource) для получения спецификации ресурса из Kubernetes кластера. + ### Процессы Добавлен новый элемент [«Таймер»](../../admin/processes/#таймер) — пауза выполнения процесса до заданного момента времени. @@ -41,6 +45,9 @@ description: Заметки о выпуске v1.6.0 — выгрузка ауд - Добавлен [набор данных Yandex Cloud](../../admin/datasets/#yandex-cloud) для подключения к API Yandex Cloud. - Добавлен [набор данных Vault](../../admin/datasets/#vault) для подключения к API HashiCorp Vault. +- Добавлен [набор данных Deckhouse managed PostgreSQL](../../admin/datasets/#deckhouse-managed-postgresql) для развёртывания managed PostgreSQL в Deckhouse Kubernetes Platform. +- Добавлен [набор данных Deckhouse managed Valkey](../../admin/datasets/#deckhouse-managed-valkey) для развёртывания managed Valkey в Deckhouse Kubernetes Platform. +- Добавлен [набор данных Deckhouse managed Kafka](../../admin/datasets/#deckhouse-managed-kafka) для развёртывания managed Kafka в Deckhouse Kubernetes Platform. ### Проверки статуса