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

м
Вернул свою версию и дополнил.
м (Форматирование)
м (Вернул свою версию и дополнил.)
Строка 1: Строка 1:
{{Draft}}
{{DISPLAYTITLE: Релизы ПО Wiren Board}}
{{DISPLAYTITLE: Релизы ПО Wiren Board}}
== Введение ==
== Введение ==
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов и изменился путь к основному репозиторию.


В апреле 2021 года мы переделали систему обновления ПО контроллеров. Теперь обновления будут доступны через новый репозиторий (http://deb.wirenboard.com/).
Новые релизы доступны для контроллеров Wiren Board 5 и Wiren Board 6.


Можно настроить одну из двух веток обновлений:
=== Ссылки на репозиторий ===
Мы переехали на новый репозиторий по адресу http://deb.wirenboard.com/, поэтому обновления ПО в старый репозиторий http://releases.contactless.ru/ в скором времени перестанут публиковаться.


* тестовую ('''testing'''), в которой новые версии ПО будут публиковаться сразу после выпуска;
=== Testing ===
* стабильную ('''stable'''), которая будет обновляться раз в три месяца в формате больших релизов после тестирования.
Testing — нестабильная ветка со свежими версиями пакетов: новые функции и неизвестные ошибки.


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


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


В следующих разделах подробнее рассказано о том, как это работает и как можно начать использовать новый репозиторий на вашем Wiren Board.
Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.


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


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


Новые версии пакетов в этой ветке публикуются практически сразу после появления. Перед публикацией проводится автотестирование обновления, чтобы не допустить попадания заведомо сломанных пакетов в репозиторий. Поэтому '''testing''' является лучшим способом быстро получить доступ к новым возможностям.
Каждый релиз имеет номер, например wb-2104 — релиз, выпущенный в апреле 2021 года.


Раз в три месяца '''testing''' "замораживается" на месяц: команда Wiren Board начинает работу по исправлению ошибок в опубликованных версиях ПО, не добавляя при этом новые функции.
Если в опубликованном релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода.
Так мы готовим новые пакеты к выпуску нового стабильного релиза. После выпуска нового стабильного релиза '''testing''' "размораживается" и в нём снова начинают публиковаться новые версии пакетов.
 
Нам очень нужны пользователи, которые могут дать обратную связь по ошибкам и недостаткам в обновлениях. Обо всех проблемах с '''testing''' можно писать в техподдержку (https://support.wirenboard.com/), так мы сможем быстрее выпустить исправления.
 
=== stable ===
 
Пакеты в стабильных релизах уже прошли тестирование силами команды Wiren Board и пользователей ветки '''testing''', поэтому мы рекомендуем использовать ветку '''stable''' в ответственных инсталляциях.
 
Эта ветка по умолчанию настроена на новых контроллерах Wiren Board.
 
Обновления в этой ветке публикуются в формате релизов раз в три месяца, подобно релизам Ubuntu или других программных продуктов. Каждый релиз имеет номер, например, '''wb-2104''' - релиз, выпущенный в апреле 2021 года.
 
Если в уже опубликованном релизе обнаруживаются серьёзные ошибки, исправления публикуются сразу после их выхода.


== Как начать пользоваться ==
== Как начать пользоваться ==
 
Если вы используете стандартный репозиторий Wiren Board и хотите перейти на работу с релизами, выполните несколько шагов.
Перейти на использование нового репозитория можно одним из следующих способов:


=== Прошивка fit-образа ===
=== Прошивка fit-образа ===
Строка 45: Строка 35:
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].
Инструкцию по прошивке и ссылки на загрузку смотрите в статье [[Wiren Board Firmware Update#Обновление прошивки целиком | Обновление прошивки контроллера Wiren Board]].


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


=== Обновление через Apt ===
=== Переходной пакет wb-configs ===
Для тех, кому не подходит обновление прошивки с помощью fit-образа (например, есть важные установленные пакеты, которые потеряются при обновлении), мы подготовили альтернативный способ обновления с помощью Apt.
Для тех, кому не подходит обновление прошивки с помощью fit-образа мы подготовили переходной пакет <code>wb-configs</code>:
 
# Добавьте новый репозиторий:
# Добавьте вспомогательный репозиторий:
#:* Создайте новый файл:
#:<syntaxhighlight lang="bash">
#::<syntaxhighlight lang="bash">
echo "deb http://releases.contactless.ru/release-transitional stretch main" > /etc/apt/sources.list.d/wb-release-transitional.list
nano /etc/apt/sources.list.d/wb-release-transitional.list
</syntaxhighlight>
#:* Добавьте в него строку и сохраните:
#::<syntaxhighlight lang="bash">
deb http://releases.contactless.ru/release-transitional stretch main
</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.
#: в систему будет установлен пакет <code>wb-configs</code>
# После завершения обновления обновите систему ещё раз:
# После завершения обновления выполните эти команды еще раз:
#:<syntaxhighlight lang="bash">
#:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
apt update && apt dist-upgrade
</syntaxhighlight>
</syntaxhighlight>
#: Программное обеспечение контроллера переключится на один из релизов и обновится:
#: программное обеспечение контроллера переключится на один из релизов и обновится:
#:* если у вас раскомментирована запись в файле <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>


== Как узнать версию установленного ПО ==
== Как узнать версию установленного ПО ==
[[Image: Screenshot_20210511_182732.png|300px|thumb|right| Версия ПО в веб-интерфейсе для '''stable''']]
[[Image: Screenshot_20210507_110130.png|300px|thumb|right| Версия ПО в веб-интерфейсе для '''testing''']]
=== Консоль ===
=== Консоль ===
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза:
Строка 99: Строка 88:


=== Веб-интерфейс ===
=== Веб-интерфейс ===
 
[[Image: System Information.png|300px|thumb|right| Версия ПО в веб-интерфейсе]]
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
Чтобы посмотреть текущую версию ПО в веб-интерфейсе:
# Перейдите в раздел '''Devices'''
# Перейдите в раздел '''Devices'''
Строка 125: Строка 114:
=== Заморозить релиз ===
=== Заморозить релиз ===
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений.
Вы можете заморозить состояние ПО контроллера на текущем стабильном релизе, но мы не рекомендуем это делать — вы останетесь без обновлений.
Заморозка релиза может быть нужна в особо ответственных применениях.


Для заморозки укажите в параметрах <code>wb-release</code> текущую версию stable-релиза:
Для заморозки укажите в параметрах wb-release текущую версию stable-релиза:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
wb-release -t wb-2104
wb-release -t wb-2104
</syntaxhighlight>
</syntaxhighlight>