SFS-005 Application Versioning

Этот документ описывает подходы в версионировании разрабатываемых приложений в SafeBlock.

Мы отделяем версию приложения (кода) и версю собранного образа который этот код представляет.

Версия приложения (App Version)

Версия приложения оформляетс согласно semver 2.0. Обратите внимание что речь идет не только о формате представления версии, но и о значении мажорной, минорной и патчевой части версии.

Версия приложения хранится в коде репозтория в исходном коде.

Версия приложения обновлятся разработчиком в ручном или автоматическое режиме в момент выпуска приложения.

Пример: v1.2.3

Версия образа (docker image tag)

Это tag которым помечен docker-образ. Формат tag-а совпадает с semver, только без префикса v в начале.

Как правило image tag совпадает с версией приложения, но может отличаться, так как устанавливается образу после сборки.

Приложение одной версии может собраться через различные пайплайны, которые присвоят результирующему образу различные теги.

Напримем, мы имеем приложение версии v1.2.3, но собрали один побраз только с одной частью приложения и получили 1.2.3-webserver