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

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

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

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

О новых функциях и исправлениях объявляется в журнале изменений, и каждый тег релиза Teable содержит дату сборки — поэтому вопрос «у меня это уже есть?» сводится к сравнению дат. Чтобы получить функцию, о которой вы прочитали, переместите образ Teable на любой релиз с датой, совпадающей с датой этой записи или более поздней:
  • Развёртывания Docker могут просто использовать канал latest:
    Контейнеры будут пересозданы с новым образом; ваши данные хранятся в томах Docker (или во внешней базе данных) и не будут затронуты.
  • Развёртывания Kubernetes не должны использовать плавающий тег: сохраняйте образ Teable закреплённым и намеренно обновляйте закреплённый тег при каждом обновлении. Скрипт pin-image.sh в репозитории развёртывания определяет, на какой конкретный релиз в данный момент указывает latest.

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

Полнофункциональное развёртывание имеет две линии версий — приложение Teable и саму платформу (см. Архитектура). Наиболее надёжный процесс объединяет их, используя VERSIONS.md в качестве таблицы обновлений. При каждом цикле:
  1. Обновите плоскость выполнения до новейшего релиза платформы (v<year>.<month>.<seq>): каждый тег Git — это проверенный снимок всех компонентов выполнения, а его запись в CHANGELOG.md указывает, что изменилось и что, если вообще что-либо, необходимо сделать (большинство релизов можно заменить без остановки). Работайте с репозиторием, извлечённым на этом теге.
  2. Переместите приложение Teable на конкретный тег релиза, которому сейчас соответствует latest (pin-image.sh определяет его) — закреплённая, проверенная комбинация вместо плавающего канала.
  3. Запустите включённый doctor — он проверяет работоспособность и сравнивает фактически запущенное с манифестом релиза платформы (совместимо / обновите приложение Teable / неизвестная комбинация).

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

Teable больше не использует встроенные секреты по умолчанию. Если ваше развёртывание полагалось на эти значения по умолчанию, первый запуск после обновления остановится со списком необходимых переменных среды и блоком для копирования и вставки, который сохраняет ваши существующие сеансы, токены и зашифрованные данные. Добавьте этот блок, перезапустите, затем запланируйте ротацию. См. Секреты и ротация.

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

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

​
Откат

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

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

Нет. Ваши данные хранятся в томах Docker или внешних базах данных, и обновление контейнеров не повлияет на них. Однако мы всё равно рекомендуем создать резервную копию перед обновлением.
Нет. Ваш Instance ID остаётся неизменным при обновлениях приложения. Это постоянный идентификатор вашей установки с самостоятельным размещением.
Как правило, загрузка новых образов занимает несколько минут (в зависимости от скорости сети), а перезапуск контейнеров — всего несколько секунд. Весь процесс обычно завершается за 5–10 минут.
При использовании docker compose up -d произойдёт короткое прерывание работы сервиса (обычно от нескольких секунд до нескольких десятков секунд).
Проверить текущую версию можно следующим образом:
  • Посмотреть номер версии в левом нижнем углу интерфейса Teable
  • Использовать учётную запись администратора для доступа к панели администратора
  • Выполнить docker inspect <container> --format='{{.Config.Image}}', чтобы проверить версию образа. Если вы используете канал latest, полнофункциональное развёртывание включает помощник pin-image.sh, который определяет, каким релизом сейчас является latest.
  1. Сначала проверьте журналы контейнера для диагностики: docker compose logs teable
  2. Если проблема связана с миграцией базы данных, попробуйте восстановить данные из резервной копии
  3. Если проблема сохраняется, выполните откат до предыдущей версии
  4. Свяжитесь со службой поддержки по адресу support@teable.ai
Последнее изменение 4 сентября 2026 г.