> For the complete documentation index, see [llms.txt](https://docs.tumbler.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tumbler.app/ru/uluchsheniya-posle-pervogo-zapuska/mirrors-and-migration.md).

# Зеркала и миграция

## Для кого

Провайдеры, которые управляют несколькими площадками или готовят миграцию URL без прерывания сервиса.

## Что можно сделать

* Настроить зеркала для подписки.
* Безопасно перенести клиентов на новый домен или путь.
* Сообщить о миграции через метаданные.

## Примеры

* Основной URL + зеркало в другом регионе.
* 301 со старого пути на новый с сохранением схемы.
* Поле `meta.mirrors` со списком альтернатив.

## См. также

* [subscription/fetch-url.md](/ru/nachat/fetch-url.md)
* [operations/reliability-and-timeouts.md](/ru/uluchsheniya-posle-pervogo-zapuska/reliability-and-timeouts.md)
* [changelog.md](/ru/changelog.md)

## Стратегия зеркал

* Храните одинаковое содержимое на всех зеркалах и синхронизируйте `ETag`.
* Указывайте список зеркал в `meta.mirrors`, если хотите явных подсказок для клиентов.
* Следите за сертификатами: зеркала должны иметь валидный TLS и тот же набор заголовков.

## Пошаговая миграция без простоя

1. **Добавьте зеркала.** Опубликуйте новый домен/путь в `meta.mirrors`, начните отдавать идентичное тело с тем же `ETag` на обеих площадках. Дайте клиентам время (минимум 1–2 недели) обновить конфигурации и переключиться на зеркало.
2. **Включите новый endpoint.** Сделайте новый URL основным в выдаче (например, в панели или документации), но продолжайте обслуживать старый с тем же контентом и заголовками.
3. **Включите редирект.** Когда убедились, что новый endpoint доступен, включите 301/308 со старого на новый. Сохраняйте схему/путь/параметры.
4. **Держите совместимость.** Оставьте старый endpoint (или редирект) доступным минимум на время обновления клиентов. Рекомендуемый горизонт — не меньше одного цикла автообновления клиентов (обычно 3–6 месяцев). Объявите дедлайн в [changelog.md](/ru/changelog.md).
5. **Отключайте постепенно.** После окна совместимости снимайте редирект и завершайте миграцию, убедившись, что все клиенты перешли на новый URL.

## Плавная миграция

* Оставляйте старый URL доступным с 301 или идентичным содержимым минимум на время обновления клиентов.
* Объявляйте миграцию и дедлайны в [changelog.md](/ru/changelog.md).
* Не меняйте схему доступа (например, не переключайтесь с GET на POST) без переходного периода.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tumbler.app/ru/uluchsheniya-posle-pervogo-zapuska/mirrors-and-migration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.