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

Материал из Wiren Board
м (Форматирование)
м (Вернул свою версию и дополнил.)
Строка 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>

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

Это черновик страницы. Последняя правка сделана 14.05.2021 пользователем A.Degtyarev.

Введение

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

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

Ссылки на репозиторий

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

Testing

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

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

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

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

Stable

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

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

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

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

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

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

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

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

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

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

Переходной пакет wb-configs

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

  1. Добавьте новый репозиторий:
    • Создайте новый файл:
    nano /etc/apt/sources.list.d/wb-release-transitional.list
    • Добавьте в него строку и сохраните:
    deb http://releases.contactless.ru/release-transitional stretch main
  2. Выполните команды: 
    apt update && apt dist-upgrade
    в систему будет установлен пакет wb-configs
  3. После завершения обновления выполните эти команды еще раз: 
    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.

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

Версия ПО в веб-интерфейсе

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

  1. Перейдите в раздел Devices
  2. Найдите устройство 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
Источник — https://wirenboard.com/wiki/index.php?title=Software_Releases&oldid=49645