Software Releases: различия между версиями

Материал из Wiren Board
м (Отмена правки 49661, сделанной A.Degtyarev (обсуждение))
Метка: отмена
Строка 64: Строка 64:


=== Автоматический переход ===
=== Автоматический переход ===
После отладки системы релизов мы планируем автоматически перевести всех пользователей на новую систему релизов в момент обновления ПО контроллера. Переход запланирован на 1 июля 2021 года, для перехода просто обновите ПО контроллера после этой даты.
После отладки системы релизов мы планируем автоматически перевести всех пользователей на новую систему релизов в момент обновления ПО контроллера.  
 
'''Переход запланирован на 1 июля 2021 года''', для перехода просто обновите ПО контроллера после этой даты:
# Выполните команды:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: в систему будет установлен пакет <code>wb-configs</code>
# После завершения обновления выполните эти команды еще раз:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''.
#:* в остальных случаях контроллер переключится на релиз '''stable'''.


== Как узнать версию установленного ПО ==
== Как узнать версию установленного ПО ==

Версия 12:12, 14 мая 2021

Изменения

С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов, также изменился путь к основному репозиторию.

Новые релизы доступны для контроллеров Wiren Board версии 5.5 и новее.

Старый репозиторий

Старый репозиторий находится по адресу http://releases.contactless.ru/. Обновления в него перестанут публиковаться в скором времени.

Новый репозиторий

Новый репозиторий находится по адресу http://deb.wirenboard.com/.

Ветки релизов

Testing

Testing — нестабильная ветка со свежими версиями пакетов: новые функции и неизвестные ошибки.

Новые версии пакетов публикуются сразу после появления и предварительного автоматического тестирования — это позволит исключить публикации сломанных пакетов.

Раз в три месяца testing-ветка «замораживается», команда Wiren Board исправляет найденные ошибки и сливает её со stable. После слияния мы продолжаем обновление пакетов в testing.

Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.

Stable

Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.

Публикуемые в ней пакеты прошли тестирование пользователями testing-ветки, поэтому мы рекомендуем использовать stable в ответственных инсталляциях.

Каждый релиз имеет номер, например wb-2104 — релиз, выпущенный в апреле 2021 года.

Если в опубликованном релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода.

Как начать пользоваться

Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.

Прошивка fit-образа

Вы можете обновить прошивку контроллера целиком, для этого загрузите и прошейте fit-образ программного обеспечения.

Инструкцию по прошивке и ссылки на загрузку смотрите в статье Обновление прошивки контроллера Wiren Board.

В контроллер будет зашит последний стабильный релиз (stable).

Обновление через Apt

Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили способ обновления с помощью стандартного менеджера пакетов Apt:

  1. Добавьте вспомогательный репозиторий:
    echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
    
  2. Выполните команды:
    apt update && apt dist-upgrade
    
    в систему будет установлен пакет wb-configs
  3. После завершения обновления выполните эти команды еще раз:
    apt update && apt dist-upgrade
    
    программное обеспечение контроллера переключится на один из релизов и обновится:
    • если у вас раскомментирована запись в файле /etc/apt/sources.list.d/wb-unstable.list, то контроллер переключится на релиз testing.
    • в остальных случаях контроллер переключится на релиз stable.
  4. Удалите вспомогательный репозиторий, он больше не потребуется:
    rm /etc/apt/sources.list.d/wb-release-transitional.list
    

Автоматический переход

После отладки системы релизов мы планируем автоматически перевести всех пользователей на новую систему релизов в момент обновления ПО контроллера.

Переход запланирован на 1 июля 2021 года, для перехода просто обновите ПО контроллера после этой даты:

  1. Выполните команды:
    apt update && apt dist-upgrade
    
    в систему будет установлен пакет wb-configs
  2. После завершения обновления выполните эти команды еще раз:
    apt update && apt dist-upgrade
    
    программное обеспечение контроллера переключится на один из релизов и обновится:
    • если у вас раскомментирована запись в файле /etc/apt/sources.list.d/wb-unstable.list, то контроллер переключится на релиз testing.
    • в остальных случаях контроллер переключится на релиз stable.

Как узнать версию установленного ПО

Консоль

При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:

__      _(_)_ __ ___ _ __ | |__   ___   __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
 \ V  V /| | | |  __/ | | | |_) | (_) | (_| | | | (_| |
  \_/\_/ |_|_|  \___|_| |_|_.__/ \___/ \__,_|_|  \__,_|
                                                       
Welcome to Wirenboard 6.7.2 (s/n A6XXXXXX), release wb-2104 (as stable)
Linux wirenboard-A6XXXXXX 4.9.22-wb1 #2 SMP Sun Apr 18 18:12:58 UTC 2021 armv7l GNU/Linux

~#

Также можно использовать команду wb-release, пример для stable-ветки:

~# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch

You can get this info in scripts from /usr/lib/wb-release.

Веб-интерфейс

Версия ПО в веб-интерфейсе для stable
Версия ПО в веб-интерфейсе для testing

Чтобы посмотреть текущую версию ПО в веб-интерфейсе:

  1. Перейдите в раздел Devices
  2. Найдите устройство System. Название текущего релиза в поле Release suite, а версия ПО в поле Release name.

Переключение между релизами

Для переключения между релизами используйте утилиту wb-release с флагом -t. При переключении утилита автоматически обновит текущий релиз до актуального состояния, а потом переключит релизы и обновит систему еще раз.

Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.

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

Testing

Для переключения на testing-релиз выполните команду:

wb-release -t testing

Stable

Для переключения на stable-релиз выполните команду:

wb-release -t stable

Заморозить релиз

Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений.

Для заморозки укажите в параметрах wb-release текущую версию stable-релиза:

wb-release -t wb-2104