> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Обновление версии

Этот документ описывает, как обновить развёртывание Teable с самостоятельным размещением.

## Каналы релизов и теги версий

Приложение Teable публикует **теги релизов на основе даты** в формате
`release.<timestamp>.<build>` (например,
`release.2026-07-14T12-24-39Z.2228`), а также два плавающих канала:

| Тег                           | Значение                                                                    |
| ----------------------------- | --------------------------------------------------------------------------- |
| `latest`                      | **Стабильный** канал — всегда указывает на самый последний стабильный релиз |
| `beta`                        | Скользящий канал — самая новая сборка, опережающая стабильную               |
| `release.<timestamp>.<build>` | Неизменяемый конкретный релиз                                               |

Релизы выходят часто (нередко несколько раз в неделю); вы сами решаете, когда выполнять обновление.
Все теги перечислены в
[GitHub Packages](https://github.com/teableio/teable/pkgs/container/teable).

<Note>
  Перед выполнением любого обновления мы настоятельно рекомендуем сначала создать резервную копию данных.
</Note>

## Регулярные обновления: следите за журналом изменений

О новых функциях и исправлениях объявляется в [журнале изменений](/ru/changelog), и
каждый тег релиза Teable содержит дату сборки — поэтому вопрос «у меня это уже есть?»
сводится к сравнению дат. Чтобы получить функцию, о которой вы прочитали, переместите образ Teable
на любой релиз с датой, совпадающей с датой этой записи или более поздней:

* **Развёртывания Docker** могут просто использовать канал `latest`:

  ```bash theme={null}
  cd teable          # your deployment directory
  docker compose pull
  docker compose up -d
  ```

  Контейнеры будут пересозданы с новым образом; ваши данные хранятся в томах Docker
  (или во внешней базе данных) и не будут затронуты.

* **Развёртывания Kubernetes** не должны использовать плавающий тег: сохраняйте образ Teable
  закреплённым и **намеренно обновляйте закреплённый тег при каждом обновлении**. Скрипт
  `pin-image.sh` в репозитории развёртывания определяет, на какой конкретный релиз
  в данный момент указывает `latest`.

## Рекомендуемый подход: обновляйте всю платформу вместе

Полнофункциональное развёртывание имеет две линии версий — приложение Teable и
саму платформу (см. [Архитектура](/ru/deploy/architecture)). Наиболее
надёжный процесс объединяет их, используя
[`VERSIONS.md`](https://github.com/teableio/teable-deployment/blob/main/VERSIONS.md)
в качестве таблицы обновлений. При каждом цикле:

1. Обновите плоскость выполнения до **новейшего релиза платформы**
   (`v<year>.<month>.<seq>`): каждый тег Git — это проверенный снимок всех
   компонентов выполнения, а его запись в
   [`CHANGELOG.md`](https://github.com/teableio/teable-deployment/blob/main/CHANGELOG.md)
   указывает, что изменилось и что, если вообще что-либо, необходимо сделать (большинство релизов
   можно заменить без остановки). Работайте с репозиторием, извлечённым на этом теге.
2. Переместите приложение Teable на **конкретный тег релиза, которому сейчас
   соответствует `latest`** (`pin-image.sh` определяет его) — закреплённая, проверенная
   комбинация вместо плавающего канала.
3. Запустите включённый **doctor** — он проверяет работоспособность и сравнивает фактически
   запущенное с манифестом релиза платформы (совместимо / обновите приложение
   Teable / неизвестная комбинация).

## Обязательные секреты

Teable больше не использует встроенные секреты по умолчанию. Если ваше развёртывание
полагалось на эти значения по умолчанию, первый запуск после обновления остановится со списком
необходимых переменных среды и блоком для копирования и вставки, который сохраняет ваши
существующие сеансы, токены и зашифрованные данные. Добавьте этот блок, перезапустите, затем
запланируйте ротацию. См. [Секреты и ротация](/ru/deploy/env#secrets-and-rotation).

## Миграция базы данных

Teable выполняет миграции базы данных автоматически при запуске; ручные действия
не требуются. Если после обновления что-то выглядит неправильно, проверьте журналы:

```bash theme={null}
docker compose logs teable | grep -i migration
```

## Откат

Если после обновления возникли проблемы:

1. Установите в `docker-compose.yaml` тег образа обратно на предыдущий тег релиза
   (поэтому закрепление лучше, чем `latest`: предыдущая версия зафиксирована).
2. `docker compose up -d`

<Warning>
  Откат **после** релиза, который мигрировал схему базы данных, может быть небезопасен —
  в этом случае восстановите данные из резервной копии, созданной до обновления. Это главная
  причина приведённой выше рекомендации о резервном копировании.
</Warning>

## Часто задаваемые вопросы

<Accordion title="Потеряю ли я данные после обновления?">
  Нет. Ваши данные хранятся в томах Docker или внешних базах данных, и обновление контейнеров не повлияет на них. Однако мы всё равно рекомендуем создать резервную копию перед обновлением.
</Accordion>

<Accordion title="Изменится ли мой Instance ID после обновления?">
  Нет. Ваш Instance ID остаётся неизменным при обновлениях приложения. Это постоянный идентификатор вашей установки с самостоятельным размещением.
</Accordion>

<Accordion title="Сколько времени занимает обновление?">
  Как правило, загрузка новых образов занимает несколько минут (в зависимости от скорости сети), а перезапуск контейнеров — всего несколько секунд. Весь процесс обычно завершается за 5–10 минут.
</Accordion>

<Accordion title="Будет ли прерывание работы сервиса во время обновления?">
  При использовании `docker compose up -d` произойдёт короткое прерывание работы сервиса (обычно от нескольких секунд до нескольких десятков секунд).
</Accordion>

<Accordion title="Как проверить текущую запущенную версию?">
  Проверить текущую версию можно следующим образом:

  * Посмотреть номер версии в левом нижнем углу интерфейса Teable
  * Использовать учётную запись администратора для доступа к панели администратора
  * Выполнить `docker inspect <container> --format='{{.Config.Image}}'`, чтобы проверить версию образа. Если вы используете канал `latest`, полнофункциональное развёртывание включает помощник `pin-image.sh`, который определяет, каким релизом сейчас является `latest`.
</Accordion>

<Accordion title="Что делать, если обновление завершилось ошибкой?">
  1. Сначала проверьте журналы контейнера для диагностики: `docker compose logs teable`
  2. Если проблема связана с миграцией базы данных, попробуйте восстановить данные из резервной копии
  3. Если проблема сохраняется, выполните откат до предыдущей версии
  4. Свяжитесь со службой поддержки по адресу [support@teable.ai](mailto:support@teable.ai)
</Accordion>
