5.2 KiB
Выпуск прошивок
Репозиторий живёт на https://git.meshinfo.ru/shade/MeshCore-Posadmesh. Автоматической сборки релизов в CI нет: прошивки собираются локально через posadmesh-build.sh, а теги и релизы создаются вручную в веб-интерфейсе git.meshinfo.ru.
Версии сборки
FIRMWARE_VERSION— версия upstream MeshCore, на которой основана сборка (напримерv1.15.0)POSADMESH_VERSION— версия релиза PosadMesh (напримерv2026.5.1)
Обе задаются переменными окружения перед запуском сборки:
export FIRMWARE_VERSION=v1.15.0
export POSADMESH_VERSION=v2026.5.1
bash posadmesh-build.sh build-firmware heltec_v4_repeater_observer
Теги релизов PosadMesh
Один или несколько тегов следующих форматов помечают релиз соответствующего трека:
companion-wifi-v1.15.0repeater-bridge-espnow-v1.15.0observer-posadmesh-bridge-espnow-v2026.5.1observer-posadmesh-bridge-mqtt-v2026.7.0observer-posadmesh-v2026.5.1
В companion-wifi-v1.15.0 используется версия upstream MeshCore.
В repeater-bridge-espnow-v1.15.0 используется версия upstream MeshCore.
В observer-posadmesh-bridge-espnow-v2026.5.1 используется версия релиза PosadMesh.
В observer-posadmesh-bridge-mqtt-v2026.7.0 используется версия релиза PosadMesh.
В observer-posadmesh-v2026.5.1 используется версия релиза PosadMesh.
Соответствие тегов и треков:
companion-wifi-v*— прошивка companion WiFirepeater-bridge-espnow-v*— прошивка ESP-NOW-моста репитераobserver-posadmesh-bridge-espnow-v*— прошивка обсервера с ESP-NOWobserver-posadmesh-bridge-mqtt-v*— прошивка обсервера с MQTT-мостомobserver-posadmesh-v*— прошивка обсервера
Сборка выполняется локально для нужного таргета; тегов на одном коммите может быть несколько.
Итоговая версия прошивки
companion-wifiиспользует версию из тега какFIRMWARE_VERSIONrepeater-bridge-espnowиспользует версию из тега какFIRMWARE_VERSIONobserver-posadmesh-bridge-espnowиспользуетFIRMWARE_VERSIONupstream MeshCore, а версию PosadMesh из тега — какPOSADMESH_VERSIONobserver-posadmesh-bridge-mqttиспользуетFIRMWARE_VERSIONupstream MeshCore, а версию PosadMesh из тега — какPOSADMESH_VERSIONobserver-posadmeshиспользуетFIRMWARE_VERSIONupstream MeshCore, а версию PosadMesh из тега — какPOSADMESH_VERSION
Итоговая строка версии зависит от трека:
companion-wifi:v1.15.0-<commit>repeater-bridge-espnow:v1.15.0-<commit>observer-posadmesh-bridge-espnow:v1.15.0-posadmesh-v2026.5.1-<commit>observer-posadmesh-bridge-mqtt:v1.15.0-posadmesh-v2026.7.0-<commit>observer-posadmesh:v1.15.0-posadmesh-v2026.5.1-<commit>
Пример:
- тег:
observer-posadmesh-v2026.5.1 - переменные:
FIRMWARE_VERSION=v1.15.0,POSADMESH_VERSION=v2026.5.1 - итоговая версия сборки:
v1.15.0-posadmesh-v2026.5.1-abcdef
Типичный порядок выпуска
- Обновите
release-notes.ymlв веткеdevelop— добавьте записи о релизе, которые должны войти в помечаемый тегом коммит. - Откройте и смерджите релизный PR из
developвmain. - Соберите нужные прошивки локально с подходящими
FIRMWARE_VERSIONиPOSADMESH_VERSION. - Создайте нужные теги релиза на целевом коммите в
main. - Запушьте теги в git.meshinfo.ru.
- Создайте релиз в веб-интерфейсе git.meshinfo.ru и приложите собранные файлы из
out/.
Если release-notes.yml должен отражать помеченный тегом релиз прошивки в репозитории, внесите это изменение до PR в main, чтобы помечаемый коммит уже содержал соответствующие примечания к релизу.
Пример:
export FIRMWARE_VERSION=v1.15.0
export POSADMESH_VERSION=v2026.5.1
bash posadmesh-build.sh build-observer-firmwares
git tag observer-posadmesh-v2026.5.1
git push origin observer-posadmesh-v2026.5.1
Поддерживаемые теги
companion-wifi-v1.15.0repeater-bridge-espnow-v1.15.0observer-posadmesh-bridge-espnow-v2026.5.1observer-posadmesh-bridge-mqtt-v2026.7.0observer-posadmesh-v2026.5.1