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

Материал из Wiren Board
м (Форматирование)
(Перенаправление изменено с Wiren Board Firmware Update на Wiren Board Software)
Метка: изменение цели перенаправления
 
(не показано 79 промежуточных версий 3 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Релизы ПО Wiren Board}}
#REDIRECT [[Wiren_Board_Software]]
== Введение ==
 
В апреле 2021 года мы переделали систему обновления ПО контроллеров. Теперь обновления будут доступны через новый репозиторий (http://deb.wirenboard.com/).
 
Можно настроить одну из двух веток обновлений:
 
* тестовую ('''testing'''), в которой новые версии ПО будут публиковаться сразу после выпуска;
* стабильную ('''stable'''), которая будет обновляться раз в три месяца в формате больших релизов после тестирования.
 
Рекомендуем переключаться на '''testing''' всем тем, кому интересно пробовать новые функции.
 
Переключиться на новый репозиторий могут все пользователи Wiren Board версии 5.5 и новее.
 
В следующих разделах подробнее рассказано о том, как это работает и как можно начать использовать новый репозиторий на вашем Wiren Board.
 
== Ветки обновления ==
 
=== testing ===
 
Новые версии пакетов в этой ветке публикуются практически сразу после появления. Перед публикацией проводится автотестирование обновления, чтобы не допустить попадания заведомо сломанных пакетов в репозиторий. Поэтому '''testing''' является лучшим способом быстро получить доступ к новым возможностям.
 
Раз в три месяца '''testing''' "замораживается" на месяц: команда Wiren Board начинает работу по исправлению ошибок в опубликованных версиях ПО, не добавляя при этом новые функции.
Так мы готовим новые пакеты к выпуску нового стабильного релиза. После выпуска нового стабильного релиза '''testing''' "размораживается" и в нём снова начинают публиковаться новые версии пакетов.
 
Нам очень нужны пользователи, которые могут дать обратную связь по ошибкам и недостаткам в обновлениях. Обо всех проблемах с '''testing''' можно писать в техподдержку (https://support.wirenboard.com/), так мы сможем быстрее выпустить исправления.
 
=== stable ===
 
Пакеты в стабильных релизах уже прошли тестирование силами команды Wiren Board и пользователей ветки '''testing''', поэтому мы рекомендуем использовать ветку '''stable''' в ответственных инсталляциях.
 
Эта ветка по умолчанию настроена на новых контроллерах Wiren Board.
 
Обновления в этой ветке публикуются в формате релизов раз в три месяца, подобно релизам Ubuntu или других программных продуктов. Каждый релиз имеет номер, например, '''wb-2104''' - релиз, выпущенный в апреле 2021 года.
 
Если в уже опубликованном релизе обнаруживаются серьёзные ошибки, исправления публикуются сразу после их выхода.
 
== Как начать пользоваться ==
 
Перейти на использование нового репозитория можно одним из следующих способов:
 
=== Прошивка fit-образа ===
Вы можете обновить прошивку контроллера целиком, для этого загрузите и прошейте fit-образ программного обеспечения.
 
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].
 
Контроллер будет настроен на использование стабильной ветки ('''stable''').
 
=== Обновление через Apt ===
Для тех, кому не подходит обновление прошивки с помощью fit-образа (например, есть важные установленные пакеты, которые потеряются при обновлении), мы подготовили альтернативный способ обновления с помощью Apt.
 
# Добавьте вспомогательный репозиторий:
#:<syntaxhighlight lang="bash">
echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
</syntaxhighlight>
# Обновите систему с новым репозиторием:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: В систему будет установлен пакет <code>wb-configs</code> с новыми настройками Apt.
# После завершения обновления обновите систему ещё раз:
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
#: Программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на ветку '''testing'''.
#:* в остальных случаях контроллер переключится на ветку '''stable'''.
# Теперь можно отключить вспомогательный репозиторий, он больше не потребуется:
#:<syntaxhighlight lang="bash">
rm /etc/apt/sources.list.d/wb-release-transitional.list
</syntaxhighlight>
 
== Как узнать версию установленного ПО ==
 
[[Image: Screenshot_20210511_182732.png|300px|thumb|right| Версия ПО в веб-интерфейсе для '''stable''']]
[[Image: Screenshot_20210507_110130.png|300px|thumb|right| Версия ПО в веб-интерфейсе для '''testing''']]
 
=== Консоль ===
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
<syntaxhighlight lang="bash">
__      _(_)_ __ ___ _ __ | |__  ___  __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
\ 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
 
~#
</syntaxhighlight>
 
Также можно использовать команду '''wb-release''', пример для stable-ветки:
<syntaxhighlight lang="bash">
~# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch
 
You can get this info in scripts from /usr/lib/wb-release.
</syntaxhighlight>
 
=== Веб-интерфейс ===
 
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
# Перейдите в раздел '''Devices'''
# Найдите устройство '''System'''. Название текущего релиза в поле '''Release suite''', а версия ПО в поле '''wb-2104'''.
 
== Переключение между релизами ==
Для переключения между релизами используйте утилиту <code>wb-release</code> с флагом <code>-t</code>. При переключении утилита автоматически обновит текущий релиз до актуального состояния, а потом переключит релизы и обновит систему еще раз.
 
Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.
 
После смены репозитория мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
 
=== Testing ===
Для переключения на testing-релиз выполните команду:
<syntaxhighlight lang="bash">
wb-release -t testing
</syntaxhighlight>
 
=== Stable ===
Для переключения на stable-релиз выполните команду:
<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
 
=== Заморозить релиз ===
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений.
Заморозка релиза может быть нужна в особо ответственных применениях.
 
Для заморозки укажите в параметрах <code>wb-release</code> текущую версию stable-релиза:
<syntaxhighlight lang="bash">
wb-release -t wb-2104
</syntaxhighlight>

Текущая версия на 18:05, 20 декабря 2023

Перенаправление на: