LaunchDarkly
Управление функциональными флагами с помощью LaunchDarkly.
LaunchDarkly — это платформа управления функциональными возможностями, которая позволяет командам безопасно развертывать, контролировать и измерять свои программные функции в масштабе.
С интеграцией LaunchDarkly в AACFlow вы можете:
- Управление функциональными флагами — Программно выводить список, создавать, обновлять, переключать и удалять функциональные флаги. Включать или выключать флаги в определенных средах с использованием семантического API LaunchDarkly.
- Мониторинг статуса флагов — Проверять, активен ли флаг, неактивен, новый или запущен в заданной среде. Отслеживать время последней оценки флага.
- Управление проектами и средами — Выводить список всех проектов и их сред для понимания структуры вашей организации LaunchDarkly.
- Сегменты пользователей — Выводить список сегментов пользователей в рамках проекта и среды для понимания организации вашей аудитории для таргетинга.
- Видимость команды — Выводить список участников учетной записи и их ролей для аудита и рабочих процессов управления доступом.
- Журнал аудита — Получать последние записи журнала аудита для отслеживания того, кто что изменил и когда. Фильтровать записи по типу ресурса для целевого мониторинга.
В AACFlow интеграция LaunchDarkly позволяет вашим агентам автоматизировать операции с функциональными флагами в рамках своих рабочих процессов. Это позволяет реализовать сценарии автоматизации, такие как включение/выключение флагов на основе событий конвейера развертывания, мониторинг статуса флагов и оповещение о устаревших или неиспользуемых флагах, аудит изменений флагов путем запроса журнала аудита после развертываний, синхронизация метаданных флагов с вашими инструментами управления проектами и вывод списка всех функциональных флагов по проектам для управления.
Эта интеграция использует API-ключ LaunchDarkly. Вы можете создавать персональные токены доступа или сервисные токены в панели управления LaunchDarkly в разделе Account Settings > Authorization. API-ключ передается непосредственно в заголовке Authorization (без префикса Bearer).
Если у вас возникли проблемы с интеграцией LaunchDarkly, свяжитесь с нами по адресу help@aacflow.io
Интегрируйте LaunchDarkly в свой рабочий процесс. Выводите список, создавайте, обновляйте, переключайте и удаляйте функциональные флаги. Управляйте проектами, средами, сегментами, участниками и журналами аудита. Требуется API-ключ.
Создать новый функциональный флаг в проекте LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта для создания флага |
name | string | Да | Человекочитаемое имя функционального флага |
key | string | Да | Уникальный ключ функционального флага (используется в коде) |
description | string | Нет | Описание функционального флага |
tags | string | Нет | Список тегов через запятую |
temporary | boolean | Нет | Является ли флаг временным (по умолчанию true) |
| Параметр | Тип | Описание |
|---|
key | string | Уникальный ключ функционального флага |
name | string | Человекочитаемое имя функционального флага |
kind | string | Тип флага (boolean или multivariate) |
description | string | Описание функционального флага |
temporary | boolean | Является ли флаг временным |
archived | boolean | Архивирован ли флаг |
deprecated | boolean | Устарел ли флаг |
creationDate | number | Метка времени Unix в миллисекундах, когда был создан флаг |
tags | array | Теги, примененные к флагу |
variations | array | Вариации для этого функционального флага |
↳ value | string | Значение вариации |
↳ name | string | Имя вариации |
↳ description | string | Описание вариации |
maintainerId | string | ID участника, который поддерживает этот флаг |
Удалить функциональный флаг из проекта LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
flagKey | string | Да | Ключ функционального флага для удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Был ли флаг успешно удален |
Вывести список записей журнала аудита из вашей учетной записи LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
limit | number | Нет | Максимальное количество записей для возврата (по умолчанию 10, максимум 20) |
spec | string | Нет | Выражение фильтра (например, "resourceType:flag") |
| Параметр | Тип | Описание |
|---|
entries | array | Список записей журнала аудита |
↳ id | string | ID записи журнала аудита |
↳ date | number | Метка времени Unix в миллисекундах |
↳ kind | string | Тип выполненного действия |
↳ name | string | Имя ресурса, над которым было выполнено действие |
↳ description | string | Полное описание действия |
↳ shortDescription | string | Краткое описание действия |
↳ memberEmail | string | Email участника, выполнившего действие |
↳ targetName | string | Имя целевого ресурса |
↳ targetKind | string | Тип целевого ресурса |
totalCount | number | Общее количество записей журнала аудита |
Получить один функциональный флаг по ключу из проекта LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
flagKey | string | Да | Ключ функционального флага |
environmentKey | string | Нет | Фильтровать конфигурацию флага для конкретной среды |
| Параметр | Тип | Описание |
|---|
key | string | Уникальный ключ функционального флага |
name | string | Человекочитаемое имя функционального флага |
kind | string | Тип флага (boolean или multivariate) |
description | string | Описание функционального флага |
temporary | boolean | Является ли флаг временным |
archived | boolean | Архивирован ли флаг |
deprecated | boolean | Устарел ли флаг |
creationDate | number | Метка времени Unix в миллисекундах, когда был создан флаг |
tags | array | Теги, примененные к флагу |
variations | array | Вариации для этого функционального флага |
↳ value | string | Значение вариации |
↳ name | string | Имя вариации |
↳ description | string | Описание вариации |
maintainerId | string | ID участника, который поддерживает этот флаг |
on | boolean | Включен ли флаг в запрошенной среде (null, если не указана конкретная среда) |
Получить статус функционального флага в разных средах (активен, неактивен, запущен и т.д.).
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
flagKey | string | Да | Ключ функционального флага |
environmentKey | string | Да | Ключ среды |
| Параметр | Тип | Описание |
|---|
name | string | Статус флага (new, active, inactive, launched) |
lastRequested | string | Метка времени последней оценки |
defaultVal | string | Значение вариации по умолчанию |
Вывести список сред в проекте LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта для вывода списка сред |
limit | number | Нет | Максимальное количество сред для возврата (по умолчанию 20) |
| Параметр | Тип | Описание |
|---|
environments | array | Список сред |
↳ id | string | ID среды |
↳ key | string | Уникальный ключ среды |
↳ name | string | Имя среды |
↳ color | string | Цвет, назначенный этой среде |
↳ apiKey | string | Ключ SDK на стороне сервера для этой среды |
↳ mobileKey | string | Ключ мобильного SDK для этой среды |
↳ tags | array | Теги, примененные к среде |
totalCount | number | Общее количество сред |
Вывести список функциональных флагов в проекте LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта для вывода списка флагов |
environmentKey | string | Нет | Фильтровать конфигурации флагов для конкретной среды |
tag | string | Нет | Фильтровать флаги по имени тега |
limit | number | Нет | Максимальное количество флагов для возврата (по умолчанию 20) |
| Параметр | Тип | Описание |
|---|
flags | array | Список функциональных флагов |
↳ key | string | Уникальный ключ функционального флага |
↳ name | string | Человекочитаемое имя функционального флага |
↳ kind | string | Тип флага (boolean или multivariate) |
↳ description | string | Описание функционального флага |
↳ temporary | boolean | Является ли флаг временным |
↳ archived | boolean | Архивирован ли флаг |
↳ deprecated | boolean | Устарел ли флаг |
↳ creationDate | number | Метка времени Unix в миллисекундах, когда был создан флаг |
↳ tags | array | Теги, примененные к флагу |
↳ variations | array | Вариации для этого функционального флага |
↳ value | string | Значение вариации |
↳ name | string | Имя вариации |
↳ description | string | Описание вариации |
↳ maintainerId | string | ID участника, который поддерживает этот флаг |
totalCount | number | Общее количество флагов |
Вывести список участников учетной записи в вашей организации LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
limit | number | Нет | Максимальное количество участников для возврата (по умолчанию 20) |
| Параметр | Тип | Описание |
|---|
members | array | Список участников учетной записи |
↳ id | string | ID участника |
↳ email | string | Адрес электронной почты участника |
↳ firstName | string | Имя участника |
↳ lastName | string | Фамилия участника |
↳ role | string | Роль участника (reader, writer, admin, owner) |
↳ lastSeen | number | Метка времени Unix последней активности |
↳ creationDate | number | Метка времени Unix, когда был создан участник |
↳ verified | boolean | Подтвержден ли email участника |
totalCount | number | Общее количество участников |
Вывести список всех проектов в вашей учетной записи LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
limit | number | Нет | Максимальное количество проектов для возврата (по умолчанию 20) |
| Параметр | Тип | Описание |
|---|
projects | array | Список проектов |
↳ id | string | ID проекта |
↳ key | string | Уникальный ключ проекта |
↳ name | string | Имя проекта |
↳ tags | array | Теги, примененные к проекту |
totalCount | number | Общее количество проектов |
Вывести список сегментов пользователей в проекте и среде LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
environmentKey | string | Да | Ключ среды |
limit | number | Нет | Максимальное количество сегментов для возврата (по умолчанию 20) |
| Параметр | Тип | Описание |
|---|
segments | array | Список сегментов пользователей |
↳ key | string | Уникальный ключ сегмента |
↳ name | string | Имя сегмента |
↳ description | string | Описание сегмента |
↳ tags | array | Теги, примененные к сегменту |
↳ creationDate | number | Метка времени Unix в миллисекундах, когда был создан сегмент |
↳ unbounded | boolean | Является ли это неограниченным (большим) сегментом |
↳ included | array | Ключи пользователей, явно включенные в сегмент |
↳ excluded | array | Ключи пользователей, явно исключенные из сегмента |
totalCount | number | Общее количество сегментов |
Включить или выключить функциональный флаг в конкретной среде LaunchDarkly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
flagKey | string | Да | Ключ функционального флага для переключения |
environmentKey | string | Да | Ключ среды для переключения флага |
enabled | boolean | Да | Включить ли флаг (true) или выключить (false) |
| Параметр | Тип | Описание |
|---|
key | string | Уникальный ключ функционального флага |
name | string | Человекочитаемое имя функционального флага |
kind | string | Тип флага (boolean или multivariate) |
description | string | Описание функционального флага |
temporary | boolean | Является ли флаг временным |
archived | boolean | Архивирован ли флаг |
deprecated | boolean | Устарел ли флаг |
creationDate | number | Метка времени Unix в миллисекундах, когда был создан флаг |
tags | array | Теги, примененные к флагу |
variations | array | Вариации для этого функционального флага |
↳ value | string | Значение вариации |
↳ name | string | Имя вариации |
↳ description | string | Описание вариации |
maintainerId | string | ID участника, который поддерживает этот флаг |
on | boolean | Включен ли флаг теперь в целевой среде |
Обновить метаданные функционального флага (имя, описание, теги, временный, архивный) с использованием семантического патча.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ LaunchDarkly |
projectKey | string | Да | Ключ проекта |
flagKey | string | Да | Ключ функционального флага для обновления |
updateName | string | Нет | Новое имя для флага |
updateDescription | string | Нет | Новое описание для флага |
addTags | string | Нет | Теги для добавления через запятую |
removeTags | string | Нет | Теги для удаления через запятую |
archive | boolean | Нет | Установить true для архивации, false для восстановления |
comment | string | Нет | Необязательный комментарий, объясняющий обновление |
| Параметр | Тип | Описание |
|---|
key | string | Уникальный ключ функционального флага |
name | string | Человекочитаемое имя функционального флага |
kind | string | Тип флага (boolean или multivariate) |
description | string | Описание функционального флага |
temporary | boolean | Является ли флаг временным |
archived | boolean | Архивирован ли флаг |
deprecated | boolean | Устарел ли флаг |
creationDate | number | Метка времени Unix в миллисекундах, когда был создан флаг |
tags | array | Теги, примененные к флагу |
variations | array | Вариации для этого функционального флага |
↳ value | string | Значение вариации |
↳ name | string | Имя вариации |
↳ description | string | Описание вариации |
maintainerId | string | ID участника, который поддерживает этот флаг |
