Версионирование и развёртывание выпусков
Разберитесь в лучших практиках версионирования выпусков, развёртывания обновлений и управления откатами в рабочей среде.
«Версионирование и развёртывание выпусков» — бесплатный урок Erlang OTP: Distributed & Fault-Tolerant Systems Programming на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Erlang OTP: Distributed & Fault-Tolerant Systems Programming, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Erlang OTP: Distributed & Fault-Tolerant Systems Programming содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
Why Version Your Releases?
When you build an Erlang application for production, it's bundled into a release. Just like any software, releases need clear version numbers.
Versioning helps you:
- Track changes over time.
- Identify specific builds.
- Manage compatibility with other systems.
- Plan for upgrades and rollbacks.
Erlang's Versioning System
In Erlang, versioning happens at different levels. Each individual application (an .app file) has its own version. The overall release (the .rel file) also has a version that typically reflects the entire bundle.
The vsn key in an .app file defines an application's version.
% my_app.app file (conceptual)
{application, my_app,
[{description, "My Erlang Application"},
{vsn, "1.0.0"},
{modules, [my_app_app, my_app_sup]},
{registered, []},
{applications, [kernel, stdlib]},
{mod, {my_app_app, []}},
{env, []}]}.Semantic Versioning (SemVer)
A widely adopted standard is Semantic Versioning (SemVer), typically formatted as MAJOR.MINOR.PATCH. It's a great practice to follow for your Erlang applications.
- MAJOR: Incremented for incompatible API changes.
- MINOR: Incremented for new functionality in a backward-compatible way.
- PATCH: Incremented for backward-compatible bug fixes.
This helps users understand the impact of an upgrade.
Applying SemVer in Erlang
You'll typically apply SemVer to your application's vsn in the .app file. When you create a release, its version (relvsn) often matches the main application's version or follows a similar scheme.
Tools like rebar3 manage these versions when building releases.
% my_app.app file
{application, my_app,
[{description, "My Erlang Service"},
{vsn, "1.2.3"},
{modules, [my_app_app, my_app_sup]},
{registered, []},
{applications, [kernel, stdlib]},
{mod, {my_app_app, []}},
{env, []}]}.Deployment Strategies Overview
Once you have a versioned Erlang release, how do you get it running in production? There are several strategies, depending on your system's requirements for uptime and complexity.
- Cold Deployment: Simplest, involves downtime.
- Hot Upgrades: Zero-downtime (covered in previous lesson).
- Blue/Green or Canary Deployments: More advanced, often used with orchestration tools.
Cold Deployment: Simple Restart
A cold deployment is the most straightforward method. You stop your currently running Erlang system completely, replace its files with the new release, and then start the new version.
This method always incurs downtime, making it suitable for systems where brief interruptions are acceptable.
# Stop the old release
/path/to/my_app/bin/my_app stop
# (Replace files with new release)
# Start the new release
/path/to/my_app/bin/my_app startHot Upgrades vs. Full Deployment
Recall from the previous lesson that hot code loading allows you to upgrade a running Erlang system without stopping it.
While powerful for applying patches or minor feature additions, hot upgrades are specific to changing *parts* of a running system. A full deployment often refers to the initial setup or a complete replacement of the entire release, sometimes involving a cold restart or more advanced traffic management.
The Importance of Rollbacks
Even with careful testing, new deployments can introduce unexpected issues. A robust deployment strategy always includes a plan for rollbacks.
A rollback means reverting your system to a previous, stable version if the new deployment fails or causes problems. This minimizes the impact of failures and restores service quickly.
Erlang's Rollback Mechanism
Erlang releases are designed to support rollbacks. When you perform a hot upgrade, Erlang generates an .relup script that describes how to move between versions. Crucially, it also knows how to reverse that script to go back.
Even with cold deployments, you can switch back to a previous release by managing your release directories and restarting the desired version.
# Example of a rollback command using release_handler
# This would typically be part of a custom script or release tool
% release_handler:install_release("my_app-1.1.0").
% release_handler:make_permanent("my_app-1.1.0").
# Alternatively, for cold deployment:
# /path/to/my_app_1.1.0/bin/my_app startTest Your Understanding
Order the steps for a typical cold deployment of an Erlang release.
Summary: Versioning & Deployment
You've learned about the critical aspects of release versioning and deployment in Erlang:
- Versioning: Use
vsnin.appfiles, ideally following SemVer (MAJOR.MINOR.PATCH), to track and manage changes. - Deployment: Understand cold deployment (with downtime) and its distinction from hot upgrades.
- Rollbacks: Always plan for reverting to a stable previous version to ensure system resilience.
These practices are key to managing robust Erlang applications in production!
Часто задаваемые вопросы
Урок «Версионирование и развёртывание выпусков» бесплатный?
Да — полный текст урока «Версионирование и развёртывание выпусков» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Erlang OTP: Distributed & Fault-Tolerant Systems Programming, подпишись на CoddyKit PRO. Курс Erlang OTP: Distributed & Fault-Tolerant Systems Programming содержит 4 уроков всего.
Чему я научусь в уроке «Версионирование и развёртывание выпусков»?
Разберитесь в лучших практиках версионирования выпусков, развёртывания обновлений и управления откатами в рабочей среде. Ты практикуешь Erlang OTP: Distributed & Fault-Tolerant Systems Programming с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Erlang OTP: Distributed & Fault-Tolerant Systems Programming?
Предыдущий опыт не требуется. Erlang OTP: Distributed & Fault-Tolerant Systems Programming на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Версионирование и развёртывание выпусков»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Erlang OTP: Distributed & Fault-Tolerant Systems Programming?
Да. Каждый урок Erlang OTP: Distributed & Fault-Tolerant Systems Programming включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Создание выпусков Erlang
- Горячая загрузка и обновление кода
- Версионирование и развёртывание выпусков
- Конфигурация релиза и скрипты запуска