Skip to content

Conversation

@blinkov
Copy link
Member

@blinkov blinkov commented Aug 13, 2024

Changelog category

  • Documentation (changelog entry is not required)

Additional information

As it is too detailed and unfinished.

@blinkov blinkov requested a review from a team as a code owner August 13, 2024 06:50
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Aug 13, 2024
@blinkov blinkov enabled auto-merge (squash) August 13, 2024 06:54
@github-actions
Copy link

✅ Documentation build

Revision built successfully
Revision preview link

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 08:23:59 UTC Pre-commit check linux-x86_64-release-clang14 for de711b6 has started.
2024-08-30 08:26:22 UTC ya make is running...
🔴 2024-08-30 08:27:19 UTC Build failed. see the logs.

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 08:24:02 UTC Pre-commit check linux-x86_64-release-asan for de711b6 has started.
2024-08-30 08:27:20 UTC ya make is running...
🔴 2024-08-30 08:28:02 UTC Build failed. see the logs.

@github-actions
Copy link

❌ Documentation build

Revision build failed

Build logs

Errors (1)

❌ Link is unreachable: ../../cluster/common_scheme_ydb.md#tablets in /ru/concepts/_includes/index/how_it_works.md

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 08:26:28 UTC Pre-commit check linux-x86_64-relwithdebinfo for de711b6 has started.
2024-08-30 08:28:53 UTC ya make is running...
🔴 2024-08-30 08:29:30 UTC Build failed. see the logs.

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 09:08:42 UTC Pre-commit check linux-x86_64-relwithdebinfo for 421debf has started.
2024-08-30 09:11:04 UTC ya make is running...
🟢 2024-08-30 09:12:04 UTC Tests successful.

Test history | Ya make output

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2024-08-30 09:12:11 UTC Build successful.

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 09:10:04 UTC Pre-commit check linux-x86_64-release-asan for 421debf has started.
2024-08-30 09:12:26 UTC ya make is running...
🟢 2024-08-30 09:12:31 UTC Tests successful.

Test history | Ya make output

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2024-08-30 09:12:37 UTC Build successful.

@github-actions
Copy link

github-actions bot commented Aug 30, 2024

2024-08-30 09:10:46 UTC Pre-commit check linux-x86_64-release-clang14 for 421debf has started.
2024-08-30 09:13:14 UTC ya make is running...
🟢 2024-08-30 09:13:22 UTC Build successful.

@github-actions
Copy link

✅ Documentation build

Revision built successfully
Revision preview link

@github-actions
Copy link

github-actions bot commented Oct 24, 2024

2024-10-24 04:00:10 UTC Pre-commit check linux-x86_64-relwithdebinfo for 9f95f82 has started.
2024-10-24 04:00:21 UTC Artifacts will be uploaded here
2024-10-24 04:02:55 UTC ya make is running...
🟢 2024-10-24 04:04:24 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2024-10-24 04:04:29 UTC Build successful.

@github-actions
Copy link

github-actions bot commented Oct 24, 2024

2024-10-24 04:00:27 UTC Pre-commit check linux-x86_64-release-asan for 9f95f82 has started.
2024-10-24 04:00:38 UTC Artifacts will be uploaded here
2024-10-24 04:03:07 UTC ya make is running...
🟢 2024-10-24 04:04:34 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2024-10-24 04:04:39 UTC Build successful.

@github-actions
Copy link

✅ Documentation build

Revision built successfully
Revision preview link


![топология block-4-2](./_assets/block-4-2.drawio.png)

- `mirror-3-dc`. Данные реплицируются между 3 зонами доступности (обычно разными дата-центрами) с использованием как минимум 3 доменов отказа (обычно серверных стоек) в каждой зоне доступности. Кластер {{ ydb-short-name }} остаётся доступным при выходе из строя любой зоны доступности; кроме того, дополнительно может выйти из строя ещё один домен отказа в любой из 2 работоспособных зон доступности без прекращения работы кластера. Этот режим рекомендуется для кластеров с высокими требованиями к отказоустойчивости, размещённых в нескольких дата-центрах.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Очень странно, что для описания mirror-3-dc не используется понятие fail realm. Хотя как раз здесь оно и должно использоваться.
Я читаю статью от начала и до конца, и как пользователь путаюсь. Мне показали: "Модель отказа, используемая в YDB, основана на концепциях домена отказа и области отказа." А дальше при описании разных топологий не используют это введенную терминологию. В результате создается WTF эффект.

О том, как задать топологию кластера {{ ydb-short-name }}, читайте в разделе [{#T}](../reference/configuration/index.md#domains-blob).

### Упрощённые конфигурации {#reduced}

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Сорри, в это место ткну, т.к. у меня претензия к тексту, который не менялся.

Сам текст:

"Базовой единицей выделения ресурсов хранения данных в кластере {{ ydb-short-name }} является группа хранения. При создании группы хранения {{ ydb-short-name }} её части — VDisk-и — размещаются на физических дисках, принадлежащих разным доменам отказа. Для режима block-4-2 каждая группа хранения распределена между 8 доменами отказа, а в режиме mirror-3-dc группа хранения распределяется между 3 областями отказа, в каждой из которых используются 3 домена отказа."

Вот здесь появляется VDisk без всякой картинки. И читателю не понятно вообще ничего. Давай улучшим этот текст

В случаях, когда невозможно использовать [рекомендованное количество](#cluster-config) оборудования, можно разделить серверы одной стойки на 2 фиктивных домена отказа. В такой конфигурации отказ одной стойки будет означать отказ не одного, а сразу двух доменов. При использовании таких упрощённых конфигураций {{ ydb-short-name }} сохраняет работоспособность при отказе сразу двух доменов. Минимальное количество стоек в кластере для режима `block-4-2` составляет 5, а для `mirror-3-dc` — по 2 в каждом дата-центре (т.е. суммарно 6 стоек).

В минимальной отказоустойчивой конфигурации {{ ydb-short-name }} используется режим `mirror-3-dc-3-nodes`, и кластер состоит из 3 серверов. В такой конфигурации каждый сервер одновременно является доменом отказа и областью отказа, и кластер может выдержать сбой только одного сервера.
В минимальной отказоустойчивой конфигурации {{ ydb-short-name }} используется режим `mirror-3-dc-3-nodes`, и кластер состоит из 3 серверов, каждый из которых должен содержать как минимум 3 диска для хранения данных. В такой конфигурации каждый сервер одновременно является доменом отказа и областью отказа, и кластер может выдержать сбой только одного сервера. Для обеспечения должного уровня отказоустойчивости каждый сервер должен размещаться в своём независимом дата-центре. **Этот режим рекомендуется только для функционального тестирования или прототипирования.**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Этот режим рекомендуется только для функционального тестирования или прототипирования."

Я бы вообще так не писал. Я считаю, что 3-х нодный кластер с mirror-3-dc-3-nodes отлично подходит для прода.

И здесь вообще очень странный текст. mirror-3-dc-3-nodes нигде до этого не вводится, но используется

@blinkov blinkov merged commit 97bd492 into main Oct 25, 2024
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants