Software Releases: различия между версиями
м (A.Degtyarev переименовал страницу Wiren Board Software Releases в Software Releases: Сократил) |
N.maslov (обсуждение | вклад) (Более развёрнутое описание, мелкие правки в инструкции) |
||
Строка 1: | Строка 1: | ||
{{Draft}} | {{Draft}} | ||
{{DISPLAYTITLE: Релизы ПО Wiren Board}} | {{DISPLAYTITLE: Релизы ПО Wiren Board}} | ||
== | == Введение == | ||
В апреле 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-образа === | ||
Строка 24: | Строка 59: | ||
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]]. | Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[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> | ||
# | # Обновите систему с новым репозиторием: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt update && apt dist-upgrade | apt update && apt dist-upgrade | ||
</syntaxhighlight> | </syntaxhighlight> | ||
#: | #: В систему будет установлен пакет <code>wb-configs</code> с новыми настройками Apt. | ||
# После завершения обновления | # После завершения обновления обновите систему ещё раз: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
apt update && apt dist-upgrade | apt update && apt dist-upgrade | ||
Строка 49: | Строка 81: | ||
#:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''. | #:* если у вас раскомментирована запись в файле <code>/etc/apt/sources.list.d/wb-unstable.list</code>, то контроллер переключится на релиз '''testing'''. | ||
#:* в остальных случаях контроллер переключится на релиз '''stable'''. | #:* в остальных случаях контроллер переключится на релиз '''stable'''. | ||
# Теперь можно отключить вспомогательный репозиторий, он больше не потребуется: | |||
#:<syntaxhighlight lang="bash"> | |||
rm /etc/apt/sources.list.d/wb-release-transitional.list | |||
</syntaxhighlight> | |||
== Как узнать версию установленного ПО == | == Как узнать версию установленного ПО == | ||
Строка 100: | Строка 137: | ||
=== Заморозить релиз === | === Заморозить релиз === | ||
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. | Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. | ||
Заморозка релиза может быть нужна в особо ответственных применениях. | |||
Для заморозки укажите в параметрах wb-release текущую версию stable-релиза: | Для заморозки укажите в параметрах wb-release текущую версию stable-релиза: |
Версия 18:06, 11 мая 2021
Это черновик страницы. Последняя правка сделана 11.05.2021 пользователем N.maslov.
Введение
В апреле 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.
Контроллер будет настроен на использование стабильной ветки (stable).
Обновление через Apt
Для тех, кому не подходит обновление прошивки с помощью fit-образа (например, есть важные установленные пакеты, которые потеряются при обновлении), мы подготовили альтернативный способ обновления с помощью Apt.
- Добавьте вспомогательный репозиторий:
echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
- Обновите систему с новым репозиторием:
apt update && apt dist-upgrade
- В систему будет установлен пакет
wb-configs
с новыми настройками Apt.
- После завершения обновления обновите систему ещё раз:
apt update && apt dist-upgrade
- программное обеспечение контроллера переключится на один из релизов и обновится:
- если у вас раскомментирована запись в файле
/etc/apt/sources.list.d/wb-unstable.list
, то контроллер переключится на релиз testing. - в остальных случаях контроллер переключится на релиз stable.
- если у вас раскомментирована запись в файле
- Теперь можно отключить вспомогательный репозиторий, он больше не потребуется:
rm /etc/apt/sources.list.d/wb-release-transitional.list
Как узнать версию установленного ПО
Консоль
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
__ _(_)_ __ ___ _ __ | |__ ___ __ _ _ __ __| |
\ \ /\ / / | '__/ _ \ '_ \| '_ \ / _ \ / _` | '__/ _` |
\ 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.
Веб-интерфейс
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
- Перейдите в раздел Devices
- Найдите устройство System. Название текущего релиза в поле Release suite, а версия ПО в поле wb-2104.
Переключение между релизами
Для переключения между релизами используйте утилиту wb-release
с флагом -t
. При переключении утилита автоматически обновит текущий релиз до актуального состояния, а потом переключит релизы и обновит систему еще раз.
Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.
После смены репозитория мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
Testing
Для переключения на testing-релиз выполните команду:
wb-release -t testing
Stable
Для переключения на stable-релиз выполните команду:
wb-release -t stable
Заморозить релиз
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений. Заморозка релиза может быть нужна в особо ответственных применениях.
Для заморозки укажите в параметрах wb-release текущую версию stable-релиза:
wb-release -t wb-2104