# Возможности etcd

> Использование возможностей etcd

---

Индекс LLMS: [llms.txt](/ru/llms.txt)

---

В этом документе представлен обзор возможностей etcd, помогающий понять их назначение и связанный с ними процесс устаревания. Порядок разработки возможностей etcd описан в [рекомендациях для разработчиков](https://github.com/etcd-io/etcd/blob/main/Documentation/contributor-guide/features.md).

Возможности etcd проходят три стадии: экспериментальную, стабильную и небезопасную. Получить их список можно командой `etcd --help`.

## Экспериментальные {#experimental}

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

- Из-за недостаточного пользовательского тестирования она может содержать ошибки и работать не так, как ожидается.
- По умолчанию она отключена.
- Её поддержка может быть прекращена в любой момент без уведомления.
    - Возможность может быть удалена в следующем минорном или мажорном выпуске без соблюдения политики [устаревания возможностей](#feature-deprecation), если она не перейдёт в стабильную стадию.
    - Команда проекта приветствует сообщения о проблемах с экспериментальными возможностями, однако такие проблемы могут иметь более низкий приоритет, чем проблемы стабильных возможностей.
- Экспериментальный [флаг возможности устаревает](#feature-deprecation) при переходе в стабильную стадию. Следует как можно раньше перейти на стабильный флаг.

## Стабильные {#stable}

Это наиболее распространённая стадия возможностей etcd. Стабильная возможность обладает следующими свойствами:

- Поддерживается в составе поддерживаемых выпусков etcd.
- Может быть включена по умолчанию.
- Прекращение поддержки должно соответствовать политике [устаревания возможностей](#feature-deprecation).

## Небезопасные {#unsafe}

Небезопасные возможности встречаются редко и перечисляются в разделе `Unsafe feature:` документации по использованию etcd. По умолчанию они отключены. Используйте их с осторожностью и в соответствии с документацией. Небезопасная возможность может быть удалена в следующем минорном или мажорном выпуске без соблюдения политики устаревания.

## Устаревание возможностей {#feature-deprecation}

### Экспериментальные {#experimental-1}

Экспериментальная возможность устаревает при переходе в стабильную стадию.

- В документации экспериментальной возможности появляется сообщение об устаревании с рекомендацией использовать соответствующий стабильный флаг, например `DEPRECATED. Use <feature-name> instead.`
- Устаревшая возможность удаляется в следующем выпуске.

### Стабильные {#stable-1}

По мере развития проекта стабильную возможность иногда приходится объявлять устаревшей и удалять. В таком случае:

- До запланированного выпуска с объявлением об устаревании в документации появляется предупреждение, например `To be deprecated in <release>.`. Если уже запланирована замена возможности, помеченной `To be deprecated`, документация также указывает её, например `Use <feature-name> instead.`.
- В запланированном выпуске возможность объявляется устаревшей. В документации появляется соответствующее сообщение с рекомендацией использовать связанную стабильную возможность, например `DEPRECATED. Use <feature-name> instead.`
- Устаревшая возможность удаляется в следующем выпуске.